GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  TK::COMPOUND (3)

.ds Aq ’

NAME

Tk::Compound - Create multi-line compound images.

CONTENTS

SYNOPSIS



    use Tk::Compound;
    $image = $widget->Compound(name,options);
    $image->Line(options);
    $image->Text(options);
    $image->Bitmap(options);
    $image->Image(options);
    $image->Space(options);



DESCRIPTION

Compound image types can be used to create images that consists of multiple horizontal lines; each line is composed of a series of items (texts, bitmaps, images or spaces) arranged from left to right. Compound images are mainly used to embed complex drawings into widgets that support the <B>-imageB> option. As shown in the EXAMPLE section below, a compound image can be used to display a bitmap and a text string simutaneously in a Tk <B>ButtonB> widget.

Compound images can only be used on windows on the same display as, and with the same pixel depth and visual as the $widget used to create them.

CREATING COMPOUND IMAGES

Compounds are created using $widget-><B>CompoundB>. Compounds support the following options:
<B>-backgroundB> => color Specifies the background color of the compound image. This color is also used as the default background color for the bitmap items in the compound image.
<B>-borderwidthB> => pixels Specifies a non-negative value indicating the width of the 3-D border drawn around the compound image.
<B>-fontB> => font Specifies the default font for the text items in the compound image.
<B>-foregroundB> => color Specifies the default foreground color for the bitmap and text items in the compound image.
<B>-padxB> => value Specifies a non-negative value indicating how much extra space to request for the compound image in the X-direction. The value may have any of the forms acceptable to <B>B>Tk_GetPixels<B>(3)B>.
<B>-padyB> => value Specifies a non-negative value indicating how much extra space to request for the compound image in the Y-direction.
<B>-reliefB> => value Specifies the 3-D effect desired for the background of the compound image. Acceptable values are <B>raisedB>, <B>sunkenB>, <B>flatB>, <B>ridgeB>, and <B>grooveB>.
<B>-showbackgroundB> => value Specifies whether the background and the 3D borders should be drawn. Must be a valid boolean value. By default the background is not drawn and the compound image appears to have a transparent background.

IMAGE COMMAND

When a compound image is created, Tk also creates a new object. This object supports the <B>configureB> and <B>cgetB> methods described in Tk::options which can be used to enquire and modify the options described above.

The object also supports the following methods:
$compound-><B>LineB>?(option = value ...>)? Creates a new line at the bottom of the compound image. Lines support the following options:
<B>-anchorB> value Specifies how the line should be aligned along the horizontal axis. When the values are <B>wB>, <B>swB> or <B>nwB>, the line is aligned to the left. When the values are <B>cB>, <B>sB> or <B>nB>, the line is aligned to the middle. When the values are <B>eB>, <B>seB> or <B>neB>, the line is aligned to the right.
<B>-padxB> => value Specifies a non-negative value indicating how much extra space to request for this line in the X-direction.
$compound->Itemtype?(option = value ...>)? Creates a new item of the type Itemtype at the end of the last line of the compound image. All types of items support these following common options:
<B>-anchorB> value Specifies how the item should be aligned along the vertical axis. When the values are <B>nB>, <B>nwB> or <B>neB>, the item is aligned to the top of the line. When the values are <B>cB>, <B>wB> or <B>eB>, the item is aligned to the middle of the line. When the values are <B>sB>, <B>seB> or <B>swB>, the item is aligned to the bottom of the line.
<B>-padxB> => value Specifies a non-negative value indicating how much extra space to request for this item in the X-direction.
<B>-padyB> => value Specifies a non-negative value indicating how much extra space to request for this item in the Y-direction.
item-type can be any of the following:
$compound-><B>BitmapB>?(option = value ...>)? Creates a new bitmap item of at the end of the last line of the compound image. Additional options accepted by the bitmap type are:
<B>-backgroundB> => color Specifies the background color of the bitmap item.
<B>-bitmapB> => name Specifies a bitmap to display in this item, in any of the forms acceptable to <B>B>Tk_GetBitmap<B>(3)B>.
<B>-foregroundB> => color Specifies the foreground color of the bitmap item.
$compound-><B>ImageB>?(option = value ...>)? Creates a new image item of at the end of the last line of the compound image. Additional options accepted by the image type are:
<B>-imageB> => name Specifies an image to display in this item. name must have been created with the <B>image createB> command.
$compound-><B>SpaceB>?(option = value ...>)? Creates a new space item of at the end of the last line of the compound image. Space items do not display anything. They just acts as space holders that add additional spaces between items inside a compound image. Additional options accepted by the image type are:
<B>-widthB> => value Specifies the width of this space. The value may have any of the forms acceptable to <B>B>Tk_GetPixels<B>(3)B>.
<B>-heightB> => value Specifies the height of this space. The value may have any of the forms acceptable to <B>B>Tk_GetPixels<B>(3)B>.
$compound-><B>TextB>?(option = value ...>)? Creates a new text item of at the end of the last line of the compound image. Additional options accepted by the text type are:
<B>-backgroundB> => color Specifies the background color of the text item.
<B>-fontB> => name Specifies the font to be used for this text item.
<B>-foregroundB> => color Specifies the foreground color of the text item.
<B>-justifyB> value When there are multiple lines of text displayed in a text item, this option determines how the lines line up with each other. value must be one of <B>leftB>, <B>centerB>, or <B>rightB>. <B>LeftB> means that the lines’ left edges all line up, <B>centerB> means that the lines’ centers are aligned, and <B>rightB> means that the lines’ right edges line up.
<B>-textB> => string Specifies a text string to display in this text item.
<B>-underlineB> value Specifies the integer index of a character to underline in the text item. 0 corresponds to the first character of the text displayed in the text item, 1 to the next character, and so on.
<B>-wraplengthB> value This option specifies the maximum line length of the label string on this text item. If the line length of the label string exceeds this length, it is wrapped onto the next line, so that no line is longer than the specified length. The value may be specified in any of the standard forms for screen distances. If this value is less than or equal to 0 then no wrapping is done: lines will break only at newline characters in the text.

EXAMPLE

The following example creates a compound image with a bitmap and a text string and places this image into a <B>Button(n)B> widget. Notice that the image must be created using the widget that it resides in.



  my $b = $parent->Button;
  my $c = $b->Compound;
  $b->configure(-image => $c);
  $c->Line;
  $c->Bitmap(-bitmap => warning);
  $c->Space(-width => 8);
  $c->Text(-text => "Warning", -underline => 0);
  $b->pack;



KEYWORDS

image(n), Tix(n)
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 COMPOUND (3) 2013-11-15

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.