GraffitiTagField

Images #

About #

A class that emulates popular tag selection fields.  Has an excellent built-in search, and many customization options.

Enumerations #

Name Values
This class exposes no enumerations.

Constants #

Name Type Value
This class exposes no constants.

Events #

Definition Parameters Return Type Description
SearchFailed SearchText as String None Raised when the search for the user-supplied string fails.
SelectionChanged None None Fires when an item is selected and displayed in the UI.
TagAdded newTag as GraffitiTagFieldItem None Fires when a tag is added, so you can keep up with items that the user adds.
TagMouseEnter tag as GraffitiTagFieldItem None Raised when the user’s mouse enters an item’s display area.
TagMouseExit tag as GraffitiTagFieldItem None Raised when the user’s mouse exits an item’s display area.
TagRemoved RemovedTag as GraffitiTagFieldItem None Raised when the user deselects a tag.

Methods #

Definition Parameters Return Type Description
AddItem newItem as GraffitiTagFieldItem None Used to add a tag to the Items() array. RefreshNow should be false if you plan to add a large number of items at once (IE: during load).
RefreshNow as Boolean = True
FindItem ItemText as String Integer Returns the index of the item with ItemText in the Items array.
LastItemIndex None Integer Returns the index of the last item in the internal items array.
RemoveAllItems None None Removes all items from the component.
RemoveItem ItemIndex as Integer None Removes item at ItemIndex from Items().

Properties #

Name Type Default Value Description
BackColor Color &cFFFFFF The background color of the field and canvas.
BorderColor Color &cCCCCCC The border color of the canvas.
BorderRadius Integer 0 The radius of the border corners.
CloseIconColor Color &cDDDDDD44 The color used to draw the close icon for the tags in the canvas.
ExactMatchesOnly Boolean False If True, searches will only show those items that exactly match the search string.
ItemBorderRadius Integer 0 The border radius for tags in the canvas.
Items() GraffitiTagFieldItem Nil The array of GraffitiTagFieldItems that the class uses.
ItemBackColor Color False The color used for the list.
ItemBorderColor Color False The border color.
ItemTextBold Boolean False Determines whether tags drawn in the canvas have bold text.
ItemTextColor Color False The text color.
ItemTextFont String “System” The font face used for tags.
ItemTextItalic Boolean False Determines whether tags drawn in the canvas have italic text.
ItemTextSize Integer 0 Sets the text size of tags drawn in the canvas.
ItemTextUnderline Boolean False Determines whether tags drawn in the canvas have underlined text.
SearchThreshold Integer 1 The number of characters before a search operation is carried out.

Examples #

There are currently no examples for this class.