# GraffitiLabel
Class Inherits GraffitiWebUIControl
## About
A powerful custom label control that supports adaptive height, direct HTML embedding, and advanced styling.
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| True | True |
### Web
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Click | X as Integer <br> Y as Integer <br> pageX as Integer <br> pageY as Integer | (None) | Raised when the user clicks the label. X/Y are relative to the label's left/top. |
| ContextClick | X as Integer <br> Y as Integer <br> pageX as Integer <br> pageY as Integer | (None) | Raised when the user right-clicks the label. X/Y are relative to the label's left/top. |
| LinkClick | linkID as String | (None) | Returns the defined ID for an HTML link inside the contents. See examples below. |
| MouseEnter | (None) | (None) | Raised when the user moves their mouse in to the label. |
| MouseExit | (None) | (None) | Raised when mouse leaves the label. |
| Open | (None) | (None) | (None) |
| Resized | (None) | (None) | Event is fired when the Label's automatic height has been adjusted to fit inner contents. |
| SelectionChange | (None) | (None) | Raised when the user makes a selection of the label's content. |
| Shown | (None) | (None) | (None) |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| Caption | String | (None) | The caption to draw withing the label. May contain arbitrary HTML or FontAwesome icons in the form of <fa-apple>. |
| MaxHeight | Integer | (None) | Maximum pixel height of the label. Upon reaching the MaxHeight value, scrollbars will be shown for the contents. |
| SelectedHTML | String | (None) | When the user selects a portion of the label's content, and the SelectionChange event fires, the content of the selection will be available in this property as HTML . |
| TrueHeight | Integer | (None) | The true height of the label after the resize operation to fit contents has completed, but before the Resized event has fired. |
## Examples
### Internal Links
To add internal links to your label's content, you should use the following format in the Caption property:
```
Some awesome text!
<br />
<a id="myUniqueLinkAction" href="#">And a link!</a>
```
