Infragistics2.Win.UltraWinTree.v8.1
ExpansionIndicatorImageCollapsed Property
See Also  Example
Infragistics.Win.UltraWinTree Namespace > UltraTree Class : ExpansionIndicatorImageCollapsed Property

Gets / sets an image to display as the collapsed expansion indicator of nodes.

Syntax

Visual Basic (Declaration) 
Public Property ExpansionIndicatorImageCollapsed As Image
C# 
public Image ExpansionIndicatorImageCollapsed {get; set;}

Remarks

If an image is specified, the image will be used as the collapsed expansion indicator of the nodes in the tree.

If no image is specified (null), the tree will draw appropriate expansion indicators based on the UltraTree.DisplayStyle and whether theming is available.

When specifying an image, be sure to set the UltraTree.ExpansionIndicatorSize property to the size of the image.

Example

Visual BasicCopy Code
Imports Infragistics.Win.UltraWinTree


        ' Define the width and height of the expansion indicators. All of the images need to
        ' be the same size.
        Const expansionIndicatorImageWidth As Integer = 15
        Const expansionIndicatorImageHeight As Integer = 15

        ' Set the ExpansionIndicatorSize on the tree.
        Me.ultraTree1.ExpansionIndicatorSize = New Size(expansionIndicatorImageWidth, expansionIndicatorImageHeight)

        ' Set the ExpansionIndicatorPadding.
        Me.ultraTree1.ExpansionIndicatorPadding = 3

        ' Tell the tree to hide the expansion indicators whenever the mouse is not over it.
        Me.ultraTree1.HideExpansionIndicators = HideExpansionIndicators.OnMouseLeave

        ' Create a rect one pixel smaller than the size of the indicators. We will use this to
        ' draw the ellipses in the indicator images so they don't get clipped.
        Dim expansionIndicatorImageRect As Rectangle = New Rectangle(0, 0, expansionIndicatorImageWidth - 1, expansionIndicatorImageHeight - 1)

        ' Create a new bitmap for each state of the expansion indicators.
        Dim expansionIndicatorImageCollapsed As Bitmap = New Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight)
        Dim expansionIndicatorImageExpanded As Bitmap = New Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight)
        Dim expansionIndicatorImageCollapsedHotTracked As Bitmap = New Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight)
        Dim expansionIndicatorImageExpandedHotTracked As Bitmap = New Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight)

        ' Draw the collapsed expansion indicator image.
        ' A red circle.
        Dim g As Graphics = Nothing
        Try
            g = Graphics.FromImage(expansionIndicatorImageCollapsed)
            g.Clear(Color.Transparent)
            g.FillEllipse(Brushes.Red, expansionIndicatorImageRect)
        Finally
            If Not g Is Nothing Then
                g.Dispose()
            End If
        End Try

        ' Draw the expanded expansion indicator image.
        ' A green circle.
        Try
            g = Graphics.FromImage(expansionIndicatorImageExpanded)
            g.Clear(Color.Transparent)
            g.FillEllipse(Brushes.Green, expansionIndicatorImageRect)
        Finally
            If Not g Is Nothing Then
                g.Dispose()
            End If
        End Try

        ' Draw the collapsed expansion indicator image.
        ' A red circle with a black border around it.
        Try
            g = Graphics.FromImage(expansionIndicatorImageCollapsedHotTracked)
            g.Clear(Color.Transparent)
            g.FillEllipse(Brushes.Red, expansionIndicatorImageRect)
            g.DrawEllipse(Pens.Black, expansionIndicatorImageRect)
        Finally
            If Not g Is Nothing Then
                g.Dispose()
            End If
        End Try

        ' Draw the collapsed expansion indicator image.
        ' A green circle with a black border around it.
        Try
            g = Graphics.FromImage(expansionIndicatorImageExpandedHotTracked)
            g.Clear(Color.Transparent)
            g.FillEllipse(Brushes.Green, expansionIndicatorImageRect)
            g.DrawEllipse(Pens.Black, expansionIndicatorImageRect)
        Finally
            If Not g Is Nothing Then
                g.Dispose()
            End If
        End Try

        ' Assign the images to the tree.
        Me.ultraTree1.ExpansionIndicatorImageCollapsed = expansionIndicatorImageCollapsed
        Me.ultraTree1.ExpansionIndicatorImageExpanded = expansionIndicatorImageExpanded
        Me.ultraTree1.ExpansionIndicatorImageCollapsedHotTracked = expansionIndicatorImageCollapsedHotTracked
        Me.ultraTree1.ExpansionIndicatorImageExpandedHotTracked = expansionIndicatorImageExpandedHotTracked


C#Copy Code
using Infragistics.Win.UltraWinTree;

           
// Define the width and height of the expansion indicators. All of the images need to
           
// be the same size.
           
const int expansionIndicatorImageWidth = 15;
           
const int expansionIndicatorImageHeight = 15;

           
// Set the ExpansionIndicatorSize on the tree.
           
this.ultraTree1.ExpansionIndicatorSize = new Size(expansionIndicatorImageWidth, expansionIndicatorImageHeight);

           
// Set the ExpansionIndicatorPadding.
           
this.ultraTree1.ExpansionIndicatorPadding = 3;

           
// Tell the tree to hide the expansion indicators whenever the mouse is not over it.
           
this.ultraTree1.HideExpansionIndicators = HideExpansionIndicators.OnMouseLeave;

           
// Create a rect one pixel smaller than the size of the indicators. We will use this to
           
// draw the ellipses in the indicator images so they don't get clipped.
           
Rectangle expansionIndicatorImageRect = new Rectangle(0, 0, expansionIndicatorImageWidth-1, expansionIndicatorImageHeight-1);

           
// Create a new bitmap for each state of the expansion indicators.
           
Bitmap expansionIndicatorImageCollapsed = new Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight);
           Bitmap expansionIndicatorImageExpanded =
new Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight);
           Bitmap expansionIndicatorImageCollapsedHotTracked =
new Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight);
           Bitmap expansionIndicatorImageExpandedHotTracked =
new Bitmap(expansionIndicatorImageWidth, expansionIndicatorImageHeight);
           
           
// Draw the collapsed expansion indicator image.
           
// A red circle.
           
using(Graphics g = Graphics.FromImage(expansionIndicatorImageCollapsed))
           {
               g.Clear(Color.Transparent);
               g.FillEllipse(Brushes.Red, expansionIndicatorImageRect);
           }

           
// Draw the expanded expansion indicator image.
           
// A green circle.
           
using (Graphics g = Graphics.FromImage(expansionIndicatorImageExpanded))
           {
               g.Clear(Color.Transparent);
               g.FillEllipse(Brushes.Green, expansionIndicatorImageRect);
           }

           
// Draw the collapsed expansion indicator image.
           
// A red circle with a black border around it.
           
using (Graphics g = Graphics.FromImage(expansionIndicatorImageCollapsedHotTracked))
           {
               g.Clear(Color.Transparent);
               g.FillEllipse(Brushes.Red, expansionIndicatorImageRect);
               g.DrawEllipse(Pens.Black, expansionIndicatorImageRect);
           }

           
// Draw the collapsed expansion indicator image.
           
// A green circle with a black border around it.
           
using (Graphics g = Graphics.FromImage(expansionIndicatorImageExpandedHotTracked))
           {
               g.Clear(Color.Transparent);
               g.FillEllipse(Brushes.Green, expansionIndicatorImageRect);
               g.DrawEllipse(Pens.Black, expansionIndicatorImageRect);
           }

           
// Assign the images to the tree.
           
this.ultraTree1.ExpansionIndicatorImageCollapsed = expansionIndicatorImageCollapsed;
           
this.ultraTree1.ExpansionIndicatorImageExpanded = expansionIndicatorImageExpanded;
           
this.ultraTree1.ExpansionIndicatorImageCollapsedHotTracked = expansionIndicatorImageCollapsedHotTracked;
           
this.ultraTree1.ExpansionIndicatorImageExpandedHotTracked = expansionIndicatorImageExpandedHotTracked;

See Also