AddChildItemBinded Method

Description

Adds a child item that is binded to this PropertyItem.

Syntax

Public Function AddChildItemBinded( _
    ByVal [Type](#) As [PropertyItemType](XtremePropertyGrid~Enumerations~PropertyItemType_EN.md), _
    ByVal [Handler](#) As Object, _
    ByVal [Property](#) As String _
) As [PropertyGridItem](XtremePropertyGrid~PropertyGridItem.md)

Parameters

Type
Specifies the type of the new item. The following types are available:
PropertyItemString: PropertyGridItem of type String.
PropertyItemNumber: PropertyGridItem of type Number.
PropertyItemBool: PropertyGridItem of type Boolean.
PropertyItemColor: PropertyGridItem of type Color.
PropertyItemFont: PropertyGridItem of type PropertyGridItemFont.
PropertyItemDouble: PropertyGridItem of type Double.
PropertyItemDate: PropertyGridItem of type PropertyGridItemDate.
PropertyItemPicture: PropertyGridItem of type Picture.
PropertyItemEnum: PropertyGridItem of type Enum.
PropertyItemEnumFlags: PropertyGridItem of type EnumFlags. This will create a Flags value item in the Property Grid control.
PropertyItemCategory: PropertyGridItem is a Category.
PropertyItemMultilineString: PropertyGridItem that contains a multi-line string. When using this property, a dropdown button will appear next to the item text that, when clicked, will display an edit window with the entire line of text.
PropertyItemOption: PropertyGridItem of type PropertyGridItemOption.
Handler
The object that "handles" the variable the item is binding to, i.e., the object the variable is defined in.
Property
The name of the variable that will be bound to the PropertyGridItem in string notation (explained below).

Return Type

Bound variables store the values of the property grid items and can be accessed without using the property grid methods and properties. Bound variables allow the property grid to store data in variables. Binding works in only one direction. When the value of a PropertyGridItem is changed, the value of the bound variable will be updated to reflect the PropertyGridItem value. If the value of the variable is changed without using the PropertyGrid, the PropertyGridItem value will not change. You would need to explicitly update the PropertyGridItem value with the contents of the variable. The advantage of binding is that the variable can be used and manipulated without using PropertyGridItem methods and properties.

Important Note: When the binding occurs, the variable name is passed to the method in String Notation. String Notation means the name of the variable is placed in quotation marks. Within the quotation marks, the variable name can be passed with any combination of spaces and uppercase/lowercase letters, but no extra characters can be added, and they must appear in the same order. For example, when binding to the variable AssembleName, you could pass the variable as Sassemblename, which is the same as SASSEMBLE n a m e, but SAssemble Names will not work because an extra Ss is added. The reason for this is that the variable name passed in String Notation will be used as the PropertyGridItem Caption if no caption is explicitly set.

Note: A variable must be declared within an object's code if it will be bound. This means bound variables cannot be declared in a .bas module.