The Items Editor Dialog

• Dec 28, 2020
• 2 minutes to read

The built-in Items Editor dialog is designed for visual editing of the control’s content, allowing you to add, remove, and rearrange nodes. In addition to the capability to customize their appearance settings, the dialog consists of the preview area, the selected node property editors, node management buttons, and content display modes buttons:

The Preview Area displays the pending changes to the control’s content. In addition to the capability to display the resulting tree structure, the area allows you to rearrange the nodes and select a node for customization.

The dialog includes the Content Display Mode buttons:

Button	Description	Corresponding Public API property
	Zooms the tree structure out to fit it into the control’s client area.	TdxCustomOrgChart.Zoom
	Changes the tree orientation.	TdxCustomOrgChart.Rotated
	Enables or disables antialiasing for the node outlines.	TdxCustomOrgChart.Antialiasing

To manage the nodes, use the following buttons:

Button	Description	Corresponding Public API method
	Creates the selected node‘s last sibling.	TdxCustomOrgChart.Add
	Creates the selected node’s last child.	TdxCustomOrgChart.AddChild
	Removes the selected node and its children.	TdxCustomOrgChart.Delete

The Property Editors UI elements include:

1. Simple text editors:

Item	Description	Corresponding Public API property
	Set the node dimensions.	TdxOcNode.Width, TdxOcNode.Height
	Sets the index of the image associated with a node.	TdxOcNode.ImageIndex
	Assigns text to a node.	TdxOcNode.Text

2. Combo boxes:

Item	Description	Corresponding Public API property
	Selects the node’s background color from the list of the available colors.	TdxOcNode.Color
	Sets the parent alignment relative to its children.	TdxOcNode.ChildAlign
	Selects the node shape.	TdxOcNode.Shape
	Sets the alignment of an image associated with a node.	TdxOcNode.ImageAlign

3. The Multiply Style button applies the selected node appearance settings to its descendants.