Layer Object (ExGauge) | Exontrol Docs

Layer object

The Layer object holds a collection of pictures and HTML captions to be displayed on a viewable layer. Any layer can be visible, selectable or dragable. Any layer can be moved, rotated or clipped. The Item property of the Layers collection access a Layer object of the control. The Background / Foreground defines the layer's background and foreground.

The following screen shot shows combination of pictures and HTML captions, on different controls:

The Layer object supports the following properties and methods:

		Name	Description
		Background	Gets access to the layer's background object.
		Brightness	Specifies the percent of brightness to apply to the layer.
		Clip	Gets access to the layer's clip object.
		Contrast	Specifies the percent of contrast to apply to the layer.
		DefaultOffsetX	Gets or sets a value that indicates the default x-offset of the layer.
		DefaultOffsetY	Gets or sets a value that indicates the default y-offset of the layer.
		DefaultRotateAngle	Specifies the default angle to rotate the layer.
		Foreground	Gets access to the layer's foreground object.
		Grayscale	Returns or sets a value that indicates that indicates percent to convert the layer to grayscale.
		Height	Specifies the expression relative to the view, to determine the height to show the current layer on the control.
		Idem	Ensures that the layer's offset and rotation-angle is equal for all idem layers (separated by comma character).
		Index	Indicates the index of the layer.
		Key	Retrieves or sets the layer's key.
		LayerClipToAlpha	Returns or sets a value that indicates the value of the alpha channel to be included in the LayerClipTo region.
		LayerToClientX	Converts the x-position of the layer to control's client x-position.
		LayerToClientY	Converts the x-position of the layer to control's client x-position.
		Left	Specifies the expression relative to the view, to determine the x-position to show the current layer on the control.
		OffsetToValue	Specifies the expression to convert the offsetx,offsety to value.
		OffsetX	Gets or sets a value that indicates x-offset of the layer.
		OffsetXValid	Validates the x-offset value of the layer
		OffsetY	Gets or sets a value that indicates y-offset of the layer.
		OffsetYValid	Validates the y-offset value of the layer
		OnDrag	Indicates the action to be performed when the user drags the layer.
		Position	Retrieves or sets a value that indicates the position/z-order of the layer in the control.
		RotamoveCenterX	Specifies the x-position of the layer's center, while the layer's drag operation is exDoRotamove.
		RotamoveCenterY	Specifies the y-position of the layer's center, while the layer's drag operation is exDoRotamove.
		RotamoveOffsetX	Specifies the x-offset of the layer, while the layer's drag operation is exDoRotamove.
		RotamoveOffsetY	Specifies the y-offset of the layer, while the layer's drag operation is exDoRotamove.
		RotateAngle	Specifies the angle to rotate the layer.
		RotateAngleToValue	Specifies the expression to convert the rotating angle to value.
		RotateAngleValid	Validates the rotation angle of the layer.
		RotateCenterLayer	Indicates the index of the layer the rotation is around. If -1, the rotation is relative to the current layer.
		RotateCenterX	Indicates the expression that determines the x-origin of the rotation point relative to the RotateCenterLayer layer.
		RotateCenterY	Indicates the expression that determines the y-origin of the rotation point relative to the RotateCenterLayer layer.
		RotateClip	Specifies whether the layer's clipping region is rotated once the layer is rotated.
		RotateType	Returns or sets a value that indicates whether the layer's rotation is performed fast, by shearing ( high quality rotation ), ...
		Selectable	Returns or sets a value that indicates whether the layer is selectable.
		ShowHandCursor	Returns or sets a value that indicates whether the hand cursor is shown when it hovers a visible / selectable / dragable layer.
		ToolTip	Gets or sets a value (tooltip) that's displayed once the cursor hovers the layer.
		ToolTipTitle	Gets or sets a value (title) that's displayed once the cursor hovers the layer.
		Top	Specifies the expression relative to the view, to determine the y-position to show the current layer on the control.
		Transparency	Gets or sets a value that indicates percent of the transparency to display the layer.
		UserData	Indicates any extra data associated with the layer.
		Value	Indicates the object's value.
		ValueToOffsetX	Specifies the expression to convert the value to x-offset.
		ValueToOffsetY	Specifies the expression to convert the value to y-offset.
		ValueToRotateAngle	Specifies the expression to convert the value to rotating angle
		Visible	Retrieves or sets a value indicating whether the layer is visible or hidden.
		Width	Specifies the expression relative to the view, to determine the width to show the current layer on the control.