SftTree/NET 2.0 - Tree Control for Windows Forms

ImagePartClass Class

An instance of the ImagePartClass class represents an image part.

Cells can contain one or several image parts (instances of the ImagePartClass). Each image part can operate independently with its own attributes and properties.

The Action event can be used to handle a mouse clicks on image parts.

If the Action event is used, the ItemClick event is not raised.

Namespace: Softelvdm.Controls
Assembly: Softelvdm.SftTreeNET

Inheritance

• System.Object
• Softelvdm.Controls.GenericPartClass
• Softelvdm.Controls.ImagePartClass

Syntax

public class ImagePartClass : Softelvdm.Controls.GenericPartClass;

Public Class ImagePartClass
    Inherits Softelvdm.Controls.GenericPartClass

Constructors

ImagePartClass

Initializes a new instance of the ImagePartClass class.

Properties

	Angle	Defines the rotation of the part.
	ExplicitSize	Defines the explicit size of the image, which causes the image to be stretched or shrunk if needed.
	HAlign	Defines the horizontal alignment within the part's available space.
	HoverImage	Defines the image used when the mouse cursor is located within the part.
	HoverImageIndex	Defines the index of the image in the ImageList control used when the mouse cursor is located within the part.
	Image	Defines the image.
	ImageIndex	Defines the index of the image in the ImageList control.
	ImageList	Defines the ImageList control containing the image.
	Orientation	Returns the orientation of parts within a cell. This is defined by the cell or the owner of the cell.
	PartAlignment	Defines the part alignment of this part relative to its container and other parts.
	PartOwner	Returns the owner of the part, usually an object derived from CellBaseClass.
	TagObject	Defines application-specific data.
	TagString	Defines an application-specific string.
	TransparentColorEnd	Defines the ending color of the range of transparent colors within the image.
	TransparentColorStart	Defines the starting color of the range of transparent colors within the image.
	VAlign	Defines the vertical alignment within the part's available space.
	VisibleAppearance	Returns the visibility status of the part.

Methods

	CalcRotatedSize	Calculates the size of the smallest rectangle that can contain the rotated rectangle of a given size, based on the part's GenericPartClass.Angle property.
	CalcSize	Calculates the size of the image part.
	CalcUnrotatedBaseWidth	Calculates the actual width of the part, based on the width of the rotated part's containing rectangle.
	ConsiderForOutline	Defines whether the part is considered when calculating the outline rectangle of a cell.
	Copy	Creates an identical copy of the part.
	CopyPart	Copies information from one part to another.
	Equals	Determines whether the specified object is equal to the current object.
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
	GetHashCode	Serves as the default hash function.
	GetType	Gets the Type of the current instance.
	GetVisible	Returns the current visibility status of a part, based on the part's GenericPartClass.VisibleAppearance property.
	MemberwiseClone	Creates a shallow copy of the current Object.
	OnContentChanged	Called when the contents of the part changed.
	ReferenceEquals	Determines whether the specified Object instances are the same instance.
	StrategyRoutine	Used to perform various actions the part supports, like rendering the part, hit-testing, determining its position and responding to mouse button clicks.
	ToString	Returns a string that represents the current object.

Events

Action

Occurs when a part's action is triggered by the user.

Examples

C#

            sftTree1.RecalcHorizontalExtent();
            sftTree1.Initializing = false;
        }

        private ItemClass AddCategory(string Category) {
            ItemClass item = sftTree1.ItemCollection.Add();
            CellClass cell = item.Cells[0];
            cell.Appearance = BackgroundAppearanceEnum.ThemedSystemHeaderNeverPressed;
            cell.Parts.Add(new ImagePartClass(m_PlusImage));
            cell.Parts.Add(new TextPartClass(Category));
            item.TagString = "This is a tooltip explaining " + Category;
            return item;
        }
        private void AddItem(ItemClass cat, Image img, string ItemText) {
            ItemClass item = cat.Add();
            CellClass cell = item.Cells[0];

View Entire Sample Code

VB.NET

    sftTree1.RecalcHorizontalExtent()
    sftTree1.Initializing = False
End Sub

Private Function AddCategory(ByVal Category As String) As ItemClass
    Dim item As ItemClass = sftTree1.ItemCollection.Add()
    Dim cell As CellClass = item.Cells(0)
    cell.Appearance = BackgroundAppearanceEnum.ThemedSystemHeaderNeverPressed
    cell.Parts.Add(New ImagePartClass(m_PlusImage))
    cell.Parts.Add(New TextPartClass(Category))
    item.TagString = "This is a tooltip explaining " & Category
    Return item
End Function

Private Sub AddItem(ByVal cat As ItemClass, ByVal img As Image, ByVal ItemText As String)
    Dim item As ItemClass = cat.Add()

View Entire Sample Code

See Also Classes | SftTree/NET 2.0