Back to all docs
API Reference / Telerik.WinControls.UI / XmlTreeNode
New to Telerik UI for WinForms? Start a free 30-day trial

XmlTreeNode

Class

Stores XML-serializable node values and child nodes used to create a RadTreeNode.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:
C#
public class XmlTreeNode

Inheritance: objectXmlTreeNode

Constructors

XmlTreeNode()

Initializes an empty node data object for XML deserialization.

C#
public XmlTreeNode()

XmlTreeNode(RadTreeNode)

Copies the supported node values and recursively captures the node's current children.

C#
public XmlTreeNode(RadTreeNode node)
Parameters:nodeRadTreeNode

The node to capture.

The snapshot includes the node's text, check state, visibility, expansion, images, and supported style values. It does not preserve selection or current-node state.

Fields

AdditionalTextEndPosition

Stores the AdditionalTextEndPosition XML attribute. Deserialize() does not apply it to the created node.

C#
public int AdditionalTextEndPosition

AdditionalTextStartPosition

Stores the AdditionalTextStartPosition XML attribute. Deserialize() does not apply it to the created node.

C#
public int AdditionalTextStartPosition

AllowDrop

Stores the AllowDrop XML attribute. Deserialize() does not apply it to the created node.

C#
public bool AllowDrop

BackColor

Gets or sets the primary background color represented by XmlBackColor.

C#
public Color BackColor

BackColor2

Gets or sets the second gradient background color represented by XmlBackColor2.

C#
public Color BackColor2

BackColor3

Gets or sets the third gradient background color represented by XmlBackColor3.

C#
public Color BackColor3

BackColor4

Gets or sets the fourth gradient background color represented by XmlBackColor4.

C#
public Color BackColor4

BorderColor

Gets or sets the border color represented by XmlBorderColor.

C#
public Color BorderColor

CheckState

Gets or sets the check state restored to CheckState.

C#
public ToggleState CheckState

CheckType

Gets or sets the checkbox or radio-button type restored to CheckType.

C#
public CheckType CheckType

Expanded

Gets or sets whether the reconstructed node is expanded.

C#
public bool Expanded

Font

Gets or sets the font represented by XmlFont.

C#
public Font Font

ForeColor

Gets or sets the text color represented by XmlForeColor.

C#
public Color ForeColor

ForeColor2

Gets or sets the secondary text color represented by XmlForeColor2. Node deserialization does not apply it.

C#
public Color ForeColor2

GradientAngle

Gets or sets the angle used to render the node's gradient background.

C#
public float GradientAngle

GradientPercentage

Gets or sets the primary transition point for the node's gradient background.

C#
public float GradientPercentage

GradientPercentage2

Gets or sets the secondary transition point for the node's gradient background.

C#
public float GradientPercentage2

GradientStyle

Gets or sets how the node's background colors are combined into a gradient.

C#
public GradientStyles GradientStyle

ImageIndex

Gets or sets the normal image-list index restored to ImageIndex.

C#
public int ImageIndex

ImageInFill

Stores the ImageInFill XML attribute. Deserialize() does not apply it to the created node.

C#
public bool ImageInFill

ImageKey

Gets or sets the normal image-list key restored to ImageKey.

C#
public string ImageKey

ItemHeight

Gets or sets the node-specific item height; -1 leaves the node without an explicit height.

C#
public int ItemHeight

Label

Stores the Label XML attribute. Deserialize() does not apply it to the created node.

C#
public string Label

Name

Gets or sets the node name serialized as the Name XML attribute and restored to Name.

C#
public string Name

Nodes

Gets or sets the node's child data. The constructor and Deserialize() process this list recursively.

C#
public List<XmlTreeNode> Nodes

NumberOfColors

Gets or sets the number of background colors used by the node's gradient.

C#
public int NumberOfColors

RightImageIndex

Stores the RightImageIndex XML attribute; node deserialization does not apply this right-side image value.

C#
public int RightImageIndex

RightImageKey

Stores the RightImageKey XML attribute; node deserialization does not apply this right-side image value.

C#
public string RightImageKey

SelectedImageIndex

Stores the SelectedImageIndex XML attribute; node deserialization does not apply this selected-image value.

C#
public int SelectedImageIndex

SelectedImageKey

Stores the SelectedImageKey XML attribute; node deserialization does not apply this selected-image value.

C#
public string SelectedImageKey

SelectedRightImageIndex

Stores the SelectedRightImageIndex XML attribute; node deserialization does not apply this selected right-side image value.

C#
public int SelectedRightImageIndex

SelectedRightImageKey

Stores the SelectedRightImageKey XML attribute; node deserialization does not apply this selected right-side image value.

C#
public string SelectedRightImageKey

ShowRightImage

Stores the ShowRightImage XML attribute; node deserialization does not apply this setting.

C#
public bool ShowRightImage

StateImageIndex

Stores the StateImageIndex XML attribute; node deserialization does not apply this state-image value.

C#
public int StateImageIndex

StateImageKey

Stores the StateImageKey XML attribute; node deserialization does not apply this state-image value.

C#
public string StateImageKey

StateRightImageIndex

Stores the StateRightImageIndex XML attribute; node deserialization does not apply this right-side state-image value.

C#
public int StateRightImageIndex

StateRightImageKey

Stores the StateRightImageKey XML attribute; node deserialization does not apply this right-side state-image value.

C#
public string StateRightImageKey

Tag

Gets or sets application data stored in the XML Tag element. Custom runtime types may need to be supplied as extra types to SaveXML(string, params Type[]) and LoadXML(string, params Type[]).

C#
public object Tag

Text

Gets or sets the node text restored to Text.

C#
public string Text

TextAlignment

Gets or sets the alignment of the node text.

C#
public ContentAlignment TextAlignment

Visible

Gets or sets whether the reconstructed node is visible.

C#
public bool Visible

Properties

ColorConverter

Gets the shared converter used to write and parse XML color values.

C#
public static ColorConverter ColorConverter { get; }

FontConverter

Gets the shared converter used to write and parse XML font values.

C#
public static FontConverter FontConverter { get; }

UseInvariantCulture

Gets or sets whether this type's color and font XML values use invariant culture. The default is true.

C#
public static bool UseInvariantCulture { get; set; }

XmlBackColor

Gets or sets the XML string for BackColor, using the culture selected by UseInvariantCulture.

C#
public string XmlBackColor { get; set; }

XmlBackColor2

Gets or sets the XML string for BackColor2, using the culture selected by UseInvariantCulture.

C#
public string XmlBackColor2 { get; set; }

XmlBackColor3

Gets or sets the XML string for BackColor3, using the culture selected by UseInvariantCulture.

C#
public string XmlBackColor3 { get; set; }

XmlBackColor4

Gets or sets the XML string for BackColor4, using the culture selected by UseInvariantCulture.

C#
public string XmlBackColor4 { get; set; }

XmlBorderColor

Gets or sets the XML string for BorderColor, using the culture selected by UseInvariantCulture.

C#
public string XmlBorderColor { get; set; }

XmlFont

Gets or sets the XML string for Font. Conversion follows UseInvariantCulture and leaves the font unchanged when parsing fails.

C#
public string XmlFont { get; set; }

XmlForeColor

Gets or sets the XML string for ForeColor. Parsing uses UseInvariantCulture and leaves the color unchanged when the string cannot be converted.

C#
public string XmlForeColor { get; set; }

XmlForeColor2

Gets or sets the XML string for ForeColor2, using the culture selected by UseInvariantCulture.

C#
public string XmlForeColor2 { get; set; }

Methods

Deserialize()

Creates a tree node from the values consumed by this conversion and recursively adds its child nodes.

C#
public RadTreeNode Deserialize()
Returns:

RadTreeNode

The reconstructed node.

ReadUnknownAttribute(XmlAttribute)

Maps supported legacy attributes to the current checkbox or radio-button setting.

C#
public virtual void ReadUnknownAttribute(XmlAttribute attribute)
Parameters:attributeXmlAttribute

The attribute that the XML serializer did not recognize as a declared member.

In this article
DefinitionConstructorsXmlTreeNode()XmlTreeNode(RadTreeNode)FieldsAdditionalTextEndPositionAdditionalTextStartPositionAllowDropBackColorBackColor2BackColor3BackColor4BorderColorCheckStateCheckTypeExpandedFontForeColorForeColor2GradientAngleGradientPercentageGradientPercentage2GradientStyleImageIndexImageInFillImageKeyItemHeightLabelNameNodesNumberOfColorsRightImageIndexRightImageKeySelectedImageIndexSelectedImageKeySelectedRightImageIndexSelectedRightImageKeyShowRightImageStateImageIndexStateImageKeyStateRightImageIndexStateRightImageKeyTagTextTextAlignmentVisiblePropertiesColorConverterFontConverterUseInvariantCultureXmlBackColorXmlBackColor2XmlBackColor3XmlBackColor4XmlBorderColorXmlFontXmlForeColorXmlForeColor2MethodsDeserialize()ReadUnknownAttribute(XmlAttribute)
Not finding the help you need?
Contact Support