Difference between revisions of "Component: Component Label (Simulation)"

From Flowcode Help
Jump to navigationJump to search
(XML import)
(XML import)
 
Line 1: Line 1:
 
  
 
{| width="50%"
 
{| width="50%"

Latest revision as of 12:51, 21 July 2016

Author Matrix Ltd.
Version 1.2 (Release)
Category Simulation


Image Component Label component

Add a label to a component by including this component as a sub-component. The label will always face the viewer and move with its parent object. Text for the label is automatically read from the host component's name or any chosen property.

Examples

No additional examples


Downloadable macro reference

This component does not contain any downloadable macros

Simulation macro reference

SetTargets

Set the objects used to determine the label text and position.

Parameters

HANDLE TextObject
Object that will provide the label text from its name or a property.
HANDLE BoundsObject
Object that will set the label position and bounding box.


Return value

This call does not return a value


ShowProperty

Sets the label to show a named property of the target object.

Parameters

STRING Property
Name of the property to show.


Return value

This call does not return a value


SetPosition

Set where the label will appear relative to the object.

Parameters

BYTE Position
Set the position - choose a preset from the list of constants, or 'Position XYZ to enter values below.
FLOAT X
X axis offset (only if 'Position_XYZ' selected for 'Position')
FLOAT Y
Y axis offset (only if 'Position_XYZ' selected for 'Position')
FLOAT Z
Z axis offset (only if 'Position_XYZ' selected for 'Position')


Return value

This call does not return a value


Hide

Hides the label.

Parameters

This macro has no parameters


Return value

This call does not return a value


SetColor

Sets the color of the label using a single ULONG value - such as returned by

panel GetColor functions.

Parameters

ULONG Color
Color to set the labels to.


Return value

This call does not return a value


SetColorRGB

Set the label color using separate red, green and blue color channels.

Parameters

BYTE Red
Color parameter
BYTE Green
Color parameter
BYTE Blue
Color parameter


Return value

This call does not return a value


Update

Refresh the label after a change.

Parameters

This macro has no parameters


Return value

This call does not return a value


ShowName

Sets the label to show the target object's name

Parameters

This macro has no parameters


Return value

This call does not return a value



Property reference

Show

This property is of type Fixed list of ints and can be referenced with the variable name show_label.

Decide what label to show...

None - no labels are displayed

Name - shows the component's name

Property - shows a property value of the component (a field for the property name will appear below)

Label target

This property is of type Panel object and can be referenced with the variable name label_target.

Set the object from which the label text will be taken.

If none is given, defaults to the parent of the label component.

Bounds target

This property is of type Panel object and can be referenced with the variable name bounds_target.

Set the object used to set the dimensions used for the positioning of the labels.

If none is given, defaults to the parent of the label component.

Auto Update

This property is of type True or false and can be referenced with the variable name label_auto_update.

Automatically update the label whenever the target's name or labelled property changes.

Use this sparingly, as it requires the component to regularly poll the component for changes!!

Color

This property is of type Color picker and can be referenced with the variable name label_color.

Color of the label text.

Background

This property is of type Color picker with transparency and can be referenced with the variable name label_bg_color.

Color for label backgroiunds - may be transparent.

Always On Top

This property is of type True or false and can be referenced with the variable name label_on_top.

Whether labels should always be draw on top of other objects.

Scale

This property is of type Floating point and can be referenced with the variable name label_scale.

Sets the basic size (text height) of the labels.

Follow Zoom

This property is of type True or false and can be referenced with the variable name label_auto_scale.

Whether labels get bigger and smaller when the panel is zoomed in and out.

Auto

This property is of type Fixed list of ints and can be referenced with the variable name label_position.

Attempt to automatically move the label to the side of the object. Choose a positive or negative offset in

any of the three axes. When 'off', the manual offsett values can be edited below.