UIIndex.gif Previous-2.gif Next-3.gif

UIlabel


Synopsis

display text or a pixmap in another object with base class UIwindow


UIprimitive UIlabel {
width = 100;
height=> UIdata.UIfonts[0].lineHeight + 0;
string+IPort2 label=> name_of(<-,1);
UIpixmap labelPixmap;
string font
enum alignment= {left, center, right};
string accelerator;
string acceleratorText;

omethod+notify_inst+notify update<NEvisible=0,lang="cxx",interruptable=0>
="UIlabelUpdate";
};

Description

UIlabel displays read only text or a pixmap inside another object with a base class of UIwindow (UIpanel, etc.).

UIlabels cannot have subwindows.

To make the UIlabel a pixmap instead of a string label:

•      Set the value of pixmap.fileType in the inherited UIpixmap subobjects to one of the following:

•      UIlabel.pixmap.fileType = "avs_image"
This is an AVS.x image file format. Any other value for pixmap.fileType means an X bitmap.

•      UIlabel.pixmap.fileType = "any other string"
This is an X bitmap file.

•      Set the value of pixmap.filename to a valid X bitmap file. For example:

UIlabel.pixmap.filename= "/usr/include/X11/bitmaps/xlogo64"

Alternately, connect UIlabel.pixmap.filename to a the filename subobject of a UIfileDialog to select a bitmap.

Subobjects

message

Attribute inherited from the UIprimitive class.

x = 0; y;
width=100;
height= UIdata.UIfonts[0].lineHeight + 0;

See UIgeom class attributes.

canHaveChildren <Not visible in Network Editor>;
shellParent <Not visible in Network Editor>

Attributes inherited from UIconnection class.

events <Not visible in Network Editor>;
grouptoParent;
* parent;
&cursor

Attributes inherited from the UIwindow class.

&visible;
&active;
pixmap;
color;
fontAttribute;
handle <Internal Object. Not visible in Network Editor>;
fontlist <No longer used. Not visible in Network Editor>;
cxxhandle <Internal Object. Not visible in Network Editor>;
motif_resources <No longer used. Not visible in Network Editor>;
window_resources <No longer used. Not visible in Network Editor>;
layout <No longer used. Not visible in Network Editor>

Attributes inherited from UIcore class.

label

String. IPort2. Sets the text of the label.

labelPixmap

See UIpixmap .

font

String. Font string descriptor to use.

alignment

Enumerator. Controls the placement of the UIlabel.

0 = left aligned
1 = center aligned
2 = right aligned

accelerator

String. Sets the accelerator on a UIcmd in a menu. An accelerator is a keystroke combination that will perform the UIcmd's action, in lieu of selecting the UIcmd menu item. The string describes a set of modifiers and the key that can be used to select the item. The format required is identical to that of the Motif translation manager, except that only a single event can be specified and only KeyPress events are allowed.

acceleratorText

String. Specifies the text displayed for the accelerator. The text is displayed beside the label string or pixmap.

Example

AVS5_Modules.Mappers.ACU_arbitrary_slicer
v/ACUmods.v
Examples.Applications.IsoApp
examples/iso_app.v
Examples.Applications.UIApp
examples/ui_samp.v

File

v/UI.v

See Also

Related modules:

•      See UIwindow

•      See UIpixmap

 



UIIndex.gif Previous-2.gif Next-3.gif