Hide

SftTree/NET 2.0 - Tree Control for Windows Forms

Display
Print

CheckBoxPartClass Class

An instance of the CheckBoxPartClass class represents a checkbox part.

Cells can contain one or several checkboxes (instances of the CheckBoxPartClass). Each checkbox can operate independently with its own attributes and properties.

A checkbox can have a checked, unchecked or indeterminate state (CheckBoxStateEnum), but a user can only check or uncheck a checkbox. The indeterminate state can only be set by an application.

The Action event can be used to handle a checkbox click.

If the Action event is used, the CheckBoxClicked event and ItemClick event are not raised.

Namespace: Softelvdm.Controls
Assembly: Softelvdm.SftTreeNET

Inheritance

Syntax

public class CheckBoxPartClass : Softelvdm.Controls.GenericPartClass;
Public Class CheckBoxPartClass
    Inherits Softelvdm.Controls.GenericPartClass

Constructors

PublicCheckBoxPartClassInitializes a new instance of the CheckBoxPartClass class.

Properties

PublicInherited from Softelvdm.Controls.GenericPartClassAngleDefines the rotation of the part.
PublicEnabledDefines whether the checkbox is enabled.
PublicInherited from Softelvdm.Controls.GenericPartClassHAlignDefines the horizontal alignment within the part's available space.
PublicInherited from Softelvdm.Controls.GenericPartClassOrientationReturns the orientation of parts within a cell. This is defined by the cell or the owner of the cell.
PublicInherited from Softelvdm.Controls.GenericPartClassPartAlignmentDefines the part alignment of this part relative to its container and other parts.
PublicInherited from Softelvdm.Controls.GenericPartClassPartOwnerReturns the owner of the part, usually an object derived from CellBaseClass.
PublicStateDefines the checkbox state.
PublicInherited from Softelvdm.Controls.GenericPartClassTagObjectDefines application-specific data.
PublicInherited from Softelvdm.Controls.GenericPartClassTagStringDefines an application-specific string.
PublicInherited from Softelvdm.Controls.GenericPartClassVAlignDefines the vertical alignment within the part's available space.
PublicInherited from Softelvdm.Controls.GenericPartClassVisibleAppearanceReturns the visibility status of the part.

Methods

ProtectedInherited from Softelvdm.Controls.GenericPartClassCalcRotatedSizeCalculates the size of the smallest rectangle that can contain the rotated rectangle of a given size, based on the part's GenericPartClass.Angle property.
ProtectedCalcSizeCalculates the size of the part.
ProtectedInherited from Softelvdm.Controls.GenericPartClassCalcUnrotatedBaseWidthCalculates the actual width of the part, based on the width of the rotated part's containing rectangle.
ProtectedInherited from Softelvdm.Controls.GenericPartClassConsiderForOutlineDefines whether the part is considered when calculating the outline rectangle of a cell.
ProtectedCopyCreates an identical copy of the part.
ProtectedStaticInherited from Softelvdm.Controls.GenericPartClassCopyPartCopies information from one part to another.
PublicInherited from System.ObjectEqualsDetermines whether the specified object is equal to the current object.
ProtectedInherited from System.ObjectFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
PublicInherited from System.ObjectGetHashCodeServes as the default hash function.
PublicInherited from System.ObjectGetTypeGets the Type of the current instance.
ProtectedInherited from Softelvdm.Controls.GenericPartClassGetVisibleReturns the current visibility status of a part, based on the part's GenericPartClass.VisibleAppearance property.
ProtectedInherited from System.ObjectMemberwiseCloneCreates a shallow copy of the current Object.
ProtectedInherited from Softelvdm.Controls.GenericPartClassOnContentChangedCalled when the contents of the part changed.
PublicStaticInherited from System.ObjectReferenceEqualsDetermines whether the specified Object instances are the same instance.
ProtectedStrategyRoutineUsed to perform various actions the part supports, like rendering the part, hit-testing, determining its position and responding to mouse button clicks.
PublicInherited from System.ObjectToStringReturns a string that represents the current object.

Events

PublicInherited from Softelvdm.Controls.GenericPartClassActionOccurs when a part's action is triggered by the user.

Examples

C#

            ItemClass item = sftTree1.ItemCollection.Add();

            // Add a text part to the first cell (could use CellBaseClass.Text instead)
            CellClass cell = item.Cells[0];
            TextPartClass tp = new TextPartClass("The first cell", LineStyleEnum.Wordwrap, HAlignmentOptionalEnum.Left,
                         VAlignmentOptionalEnum.Top, Color.Blue, Color.Green, Color.Red, Color.Blue, new Font("Arial", 12), StringFormatFlags.LineLimit| StringFormatFlags.MeasureTrailingSpaces); 
            cell.Parts.Add(tp);
            // Followed by a check box (still in the first cell)
            CheckBoxPartClass cb = new CheckBoxPartClass( CheckBoxStateEnum.Unchecked, HAlignmentOptionalEnum.Left, VAlignmentOptionalEnum.Top, true);
            cb.Action += new GenericPartClass.ActionEventHandler(cb_Action);
            cell.Parts.Add(cb);
            // Followed by an image (still in the first cell)
            ImagePartClass ip = new ImagePartClass(img);
            cell.Parts.Add(ip);
            
            // Add contents to the second cell

VB.NET

    Dim item As ItemClass = sftTree1.ItemCollection.Add()

    ' Add a text part to the first cell (could use CellBaseClass.Text instead)
    Dim cell As CellClass = item.Cells(0)
    Dim tp As TextPartClass = New TextPartClass("The first cell", LineStyleEnum.Wordwrap, HAlignmentOptionalEnum.Left, _
             VAlignmentOptionalEnum.Top, Color.Blue, Color.Green, Color.Red, Color.Blue, New Font("Arial", 12), StringFormatFlags.LineLimit Or StringFormatFlags.MeasureTrailingSpaces)
    cell.Parts.Add(tp)
    ' Followed by a check box (still in the first cell)
    Dim cb As CheckBoxPartClass = New CheckBoxPartClass(CheckBoxStateEnum.Unchecked, HAlignmentOptionalEnum.Left, VAlignmentOptionalEnum.Top, True)
    AddHandler cb.Action, AddressOf cb_Action
    cell.Parts.Add(cb)
    ' Followed by an image (still in the first cell)
    Dim ip As ImagePartClass = New ImagePartClass(img)
    cell.Parts.Add(ip)

    ' Add contents to the second cell

See Also Classes | SftTree/NET 2.0



Spring Break!

Our offices will be closed this week (March 18 through March 22).

We'll be back March 24 to address any pending sales and support issues.