Label (PRIM_MD.Label)
Icon and text
Ancestors - Control (PRIM_MD.Control)Control (PRIM_CTRL)Object (PRIM_OBJT)
Details
A Label is a simple control used to display a Caption and Icon.
Example
This page shows three label variations.
Begin_Com Role(*EXTENDS #PRIM_WEB) Theme(#SYS_THEME) Height(616) Width(1065)
Define_Com Class(#PRIM_VS.Style) Name(#Style1) FontSize(24)
Define_Com Class(#PRIM_MD.Label) Name(#Label) Caption('Text') CaptionAlignment(Center) DisplayPosition(1) Icon('notifications') Left(87) Parent(#COM_OWNER) TabPosition(1) TabStop(False) Top(40) ThemeDrawStyle('LightSuccess') Height(41) Width(106)
Define_Com Class(#PRIM_MD.Label) Name(#Label1) Caption('Text') DisplayPosition(2) Icon('comment') IconAlignment(CenterRight) IconThemeDrawStyle('ForegroundMediumAccent') Left(192) Parent(#COM_OWNER) TabPosition(2) TabStop(False) Top(96) ThemeDrawStyle('LightAccent') Style(#Style1) Height(49) Width(113) IconHeight(0)
Define_Com Class(#PRIM_MD.Label) Name(#Label2) Caption('Text') CaptionAlignment(Center) DisplayPosition(3) Height(109) Icon('notifications') IconAlignment(AboveCaption) Left(45) Parent(#COM_OWNER) TabPosition(3) TabStop(False) Top(100) Width(116) ThemeDrawStyle('DarkTitle') Style(#Style1)
End_Com
Properties
Name | Description |
|---|---|
BusyUpdates specifies how the control updates itself Inherited from Control (PRIM_CTRL) | |
BusyUpdatesOfParent specifies whether the parent controls updates Inherited from Control (PRIM_CTRL) | |
CanFocus returns a value indicating whether the control can receive keyboard focus Inherited from Control (PRIM_CTRL) | |
Text to be displayed within the label | |
Position of the caption within the control | |
Bottom margin in pixels | |
Left margin in pixels | |
Right margin in pixels | |
Top margin in pixels | |
ComponentClassName is the name of the component's class. Inherited from Object (PRIM_OBJT) | |
ComponentMembers provides access to all the member components of this component Inherited from Object (PRIM_OBJT) | |
ComponentPatternName is used to qualify the class of the component. Inherited from Object (PRIM_OBJT) | |
Generic space allowing a value to be stored for the instance Inherited from Object (PRIM_OBJT) | |
ComponentType gives you access to the type information about the component Inherited from Object (PRIM_OBJT) | |
ComponentTypeName is the fully qualified name of the component's class. Inherited from Object (PRIM_OBJT) | |
Cursor sets the cursor image Inherited from Control (PRIM_CTRL) | |
DisplayPosition determines the order in which components are shown Inherited from Control (PRIM_CTRL) | |
DragStyle determines how a component can be dragged Inherited from Control (PRIM_CTRL) | |
Show ellipses for truncated text | |
Enable activates/deactivates the component Inherited from Control (PRIM_CTRL) | |
Fix the control position so that it does not move if the parent is scrolled Inherited from Control (PRIM_CTRL) | |
Focus tells whether the component has focus Inherited from Control (PRIM_CTRL) | |
Reference to a style to be applied when the control is focus Inherited from Control (PRIM_CTRL) | |
Collection of styles to be applied when the control is focus Inherited from Control (PRIM_CTRL) | |
Returns the Windows handle in desktop applications Inherited from Control (PRIM_CTRL) | |
The height of the control in pixels Inherited from Control (PRIM_CTRL) | |
Caption displayed when the mouse hovers over the control Inherited from Control (PRIM_CTRL) | |
HintPopup allows a PopupPanel instance to be used instead of the default hint text box Inherited from Control (PRIM_CTRL) | |
Enabled or disable the appearance of hints Inherited from Control (PRIM_CTRL) | |
Delegate hints appearance to the parent control Inherited from Control (PRIM_CTRL) | |
HintTitle defines the text shown at the top of the hint window in emphasized text Inherited from Control (PRIM_CTRL) | |
Image displayed within the control | |
Position of the icon within the control | |
Color to be applied to the icon | |
FileName is the name of image file | |
Height of the icon in pixels | |
Material design image to show on the control | |
Specifies the sizing behaviour of the IconImage | |
Bottom margin in pixels | |
Left margin in pixels | |
Right margin in pixels | |
Top margin in pixels | |
Percentage opacity of the icon | |
Padding of the icon in pixels | |
Name of the Theme DrawStyle to be applied to the icon | |
IsAnimating indicates that a control is currently being animated Inherited from Control (PRIM_CTRL) | |
True if the control is currently realized Inherited from Control (PRIM_CTRL) | |
Position of the control relative to the left boundary of its parent Inherited from Control (PRIM_CTRL) | |
The link property defines an active path that supports application navigation without having to code it in a click event. | |
Modified indicates that the contents of the component have changed Inherited from Control (PRIM_CTRL) | |
MouseOver determines whether the mouse is directly over a control Inherited from Control (PRIM_CTRL) | |
MouseOverStyle defines the style to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL) | |
MouseOverStyles is a collection of styles to be applied to a control when the mouse is over it Inherited from Control (PRIM_CTRL) | |
Name identifies the component Inherited from Object (PRIM_OBJT) | |
Opacity denotes the appearance of a control in terms of its interaction with its background Inherited from Control (PRIM_CTRL) | |
Owner owns this component Inherited from Object (PRIM_OBJT) | |
Bottom padding in pixels | |
Left padding in pixels | |
Right padding in pixels | |
Top padding in pixels | |
Reference to the control in which this control is visually positioned Inherited from Control (PRIM_CTRL) | |
Popup allows a PopupPanel instance to be used instead of the typical right click popup menu Inherited from Control (PRIM_CTRL) | |
Reference to a PopupMenu to be shown on a right click Inherited from Control (PRIM_CTRL) | |
Rotation allows a control to rotate a number of degrees about a given origin Inherited from Control (PRIM_CTRL) | |
RotationOriginLeft defines the left coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL) | |
RotationOriginTop defines the top coordinate of an imaginary point around which a control will rotate Inherited from Control (PRIM_CTRL) | |
ScaleHeight is the percentage of the height to use in the visual appearance of a control Inherited from Control (PRIM_CTRL) | |
ScaleOriginLeft defines the left coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL) | |
ScaleOriginTop defines the top coordinate of an imaginary point from which a control will scale Inherited from Control (PRIM_CTRL) | |
ScaleWidth is the percentage of the width to use in the visual appearance of a control Inherited from Control (PRIM_CTRL) | |
ScreenLeft sets the distance from the left of the screen Inherited from Control (PRIM_CTRL) | |
ScreenTop sets the distance from the top of the screen Inherited from Control (PRIM_CTRL) | |
Left position of a horizontally scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL) | |
Top position of a vertically scrolled child control relative to its parent control Inherited from Control (PRIM_CTRL) | |
SkewLeft defines the angle at which to skew the control horizontally Inherited from Control (PRIM_CTRL) | |
SkewOriginLeft defines the left coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL) | |
SkewOriginTop defines the top coordinate of an imaginary point from which a control will skew Inherited from Control (PRIM_CTRL) | |
SkewTop defines the angle at which to skew the control vertically Inherited from Control (PRIM_CTRL) | |
Style defines the style to be applied to a control Inherited from Control (PRIM_CTRL) | |
Collection of styles to be applied to the control Inherited from Control (PRIM_CTRL) | |
TabPosition sets the order of focus when the Tab key is used Inherited from Control (PRIM_CTRL) | |
Set to false to stop focus being given to the control via the Tab key Inherited from Control (PRIM_CTRL) | |
Background theme to be used Inherited from Control (PRIM_MD.Control) | |
Name of the Theme DrawStyle to be applied to the control Inherited from Control (PRIM_CTRL) | |
Position of the control relative to the top boundary of its parent Inherited from Control (PRIM_CTRL) | |
Determines how the control will respond to touch move processing Inherited from Control (PRIM_CTRL) | |
Determines how the control will respond to touch rotation Inherited from Control (PRIM_CTRL) | |
Determines how the control will respond to touch scaling Inherited from Control (PRIM_CTRL) | |
Determines whether a control can be resized Inherited from Control (PRIM_CTRL) | |
Show or hide the control Inherited from Control (PRIM_CTRL) | |
VisualStyle sets the appearance Inherited from Control (PRIM_CTRL) | |
Adopt the Visual style from the parent control Inherited from Control (PRIM_CTRL) | |
Width of the component in pixels Inherited from Control (PRIM_CTRL) | |
Wrap text on to the next line if there is insufficient space |
Events
Name | Description |
|---|---|
Fired when an animation is ended Inherited from Label (PRIM_MD.Label) Cancelled | |
Fired when the mouse is clicked on the control Origin, Handled | |
CreateInstance is signalled when an instance of a component is created Inherited from Label (PRIM_MD.Label) | |
DestroyInstance is signalled when an instance of a component is about to be destroyed Inherited from Label (PRIM_MD.Label) | |
Fired on mouse up to signify the end of a drag process Inherited from Label (PRIM_MD.Label) PosX, PosY, Source, Payload, AggregatedSource, Origin, Handled, DragResult | |
Fired during the drag and drop process when the cursor moves over the control Inherited from Label (PRIM_MD.Label) PosX, PosY, Source, Payload, DragState, AcceptDrop, DragCursor, ShowDropHilight, AggregatedSource, Origin, Handled | |
Fired when the drag and drop process has completed Inherited from Label (PRIM_MD.Label) Source, Payload, DragResult, AggregatedSource, Origin, Handled | |
Fired after a component has been realized for the first time Inherited from Label (PRIM_MD.Label) | |
The mouse has entered the bounds of the control Inherited from Label (PRIM_MD.Label) | |
The mouse has hovered over the control Inherited from Label (PRIM_MD.Label) Origin, Handled | |
The mouse has left the bounds of the control Inherited from Label (PRIM_MD.Label) | |
Fired when the user starts a drag and drop process Inherited from Label (PRIM_MD.Label) Source, Payload, Continue, DragList, AggregatedSource, Origin, Handled | |
Fired repeatedly between the TouchStart and TouchEnd boundaries to provide details of the touch events Inherited from Label (PRIM_MD.Label) MoveLeft, MoveTop, ScaleWidth, ScaleHeight, Rotation, Continue | |
Fired when the user stops touching the screen Inherited from Label (PRIM_MD.Label) | |
Fired when the user first makes physical contact with the screen Inherited from Label (PRIM_MD.Label) Origin, TouchMove, TouchRotate, TouchScale, TouchSize |
Methods
Name | Description |
|---|---|
Animate from invisible to visible Inherited from Control (PRIM_CTRL) Duration, Delay | |
Animate from visible to invisible Inherited from Control (PRIM_CTRL) Duration, Delay, Visible | |
Move a control from the specified position to the current position Inherited from Control (PRIM_CTRL) Left, Top, Duration, Delay | |
Animate a move from the specified number of pixels Inherited from Control (PRIM_CTRL) Left, Top, Duration, Delay | |
Creates the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL) | |
Animate a change of scale Inherited from Control (PRIM_CTRL) ScaleWidth, ScaleHeight, Duration, Delay | |
Sets the control to be the focus control Inherited from Control (PRIM_CTRL) | |
LANSA Internal Use Inherited from Control (PRIM_CTRL) | |
Animate a change of size Inherited from Control (PRIM_CTRL) Width, Height, Duration, Delay | |
Destroys the visual portion of dynamically created controls Inherited from Control (PRIM_CTRL) | |
UpdateDisplay updates the display immediately Inherited from Control (PRIM_CTRL) |