Definition: |
include pGUI.e
Ihandle ih = IupGLLabel(nullable_string title=NULL, string attributes="", sequence data={}) |
Description: |
Creates an embedded OpenGL label interface element, which displays a text and/or an image. It inherits from IupGLSubCanvas. It exists only inside an IupGLCanvasBox. title: Text to be shown on the label. It can be NULL. It will set the TITLE attribute. For more information on the attributes and data parameters see IupSetAttributes. Returns: the identifier of the created element. |
Notes: |
The IupGLLabel can contain text and image simultaneously.
The natural size will be a combination of the size of the image and the title, if any, plus PADDING and SPACING (if both image and title are present). |
Attributes: | The IupGLLabel element handles all attributes defined for a IupGLSubCanvas control. |
ACTIVE |
Since it has no callbacks, the only difference between an active label and an inactive one is its visual feedback. Possible values: "YES, "NO". Default: "YES". |
ALIGNMENT |
(non inheritable) horizontal and vertical alignment. Possible values: "ALEFT", "ACENTER" and "ARIGHT", combined to "ATOP", "ACENTER" and "ABOTTOM". Default: "ACENTER:ACENTER". Partial values are also accepted, like "ARIGHT" or ":ATOP", the other value will be used from the current alignment. |
FGCOLOR | Text color. Can have an alpha component. Default: "0 0 0". |
IMAGE | (non inheritable) Image name. Use IupSetHandle or IupSetAttributeHandle to associate an image to a name. See also IupImage. |
IMAGEHIGHLIGHT |
(non inheritable) Image name of the element in highlight state. If it is not defined then the IMAGE is used. |
IMAGEINACTIVE |
(non inheritable) Image name of the element when inactive. If it is not defined then the IMAGE is used and its colors will be replaced by a modified version creating the disabled effect. |
IMAGEPRESS |
(non inheritable) Image name of the element in pressed state. If it is not defined then the IMAGE is used. |
IMAGEPOSITION |
(non inheritable) Position of the image relative to the text when both are defined. Can be: LEFT, RIGHT, TOP, BOTTOM. Default: LEFT. |
PADDING |
(non inheritable) internal margin. Works just like the MARGIN attribute of the IupHbox and IupVbox containers, but uses a different name to avoid inheritance problems. Default value: "0x0". |
SPACING | (non inheritable) defines the spacing between the image and the title. Default: "2". |
TITLE | (non inheritable) Label’s text. The '\n' character is accepted for line change. |
See Also: | IupImage, IupGLButton, IupGLToggle |