The Label Object

Synopsis

Description

An object used to put a text label on Menu or Bulletin objects. As the superclass for Button, Label also provides the Button label.

• It is not possible to control the size, font or style of a label.

Inherited Resources

• All objects: XuNdestroyable, XuNimmutable, XuNname and XuNuserData
• GUI objects: XuNguiCreateFunction, XuNguiDestroyFunction, XuNguiHeight, XuNguiPosition, XuNguiSensitive and XuNguiWidth

New Resources

• The text string for the label.
• Can include "\n" for a new-line. e.g. "This is over\ntwo lines".
  N.B. New lines are not support by the Switch object which inherits this resource.
• The label is only used if no pixmap is specified.

• The filename of a pixmap.
• The pixmap format is XPM under Motif, and both BMP and XPM under Windows.
• On Windows a path can be include and can use environment variables. If no path is specified Gsharp will look for the pixmap in $UNIDIR/bitmaps.
• On UNIX/VMS any path will be ignored and Gsharp will look for the pixmap in the directories specified by $XFILESEARCHPATH

Example Code

function CreateField(string OBJ, float y, string label)
  create Text $(OBJ)
   ( XuNguiPosition = (100,y),
     XuNguiWidth = 100,
     XuNguiMultilineEdit = false
   );
  OBJ = OBJ+"Label";
  create Label $(OBJ)
   ( XuNguiPosition = (0,y+2),
     XuNguiLabel = label+":"
   );
endfunction

  create Dialog gsharp_1.mydialog
   ( XuNguiDialogType = "bulletinBoard",
     XuNguiWidth = 220,
     XuNguiHeight = 100
   );
  CreateField("gsharp_1.mydialog.height", 0, "Height");
  CreateField("gsharp_1.mydialog.width", 30, "Width");
  GuiPopupDialog("gsharp_1.mydialog");

Return to Gsharp Applications Reference Manual