SftTree/OCX 7.5 - ActiveX Tree Control

BackColorEnd Property, SftTreeCell Object

Defines the cell's background color, combined with BackColor creating a gradient fill.

Syntax

Get

VB.NET	Clr = object.BackColorEnd As UInteger
VB	Clr = object.BackColorEnd As OLE_COLOR
C#.NET	uint Clr = object.BackColorEnd;
VC++	OLE_COLOR Clr = object->BackColorEnd; OLE_COLOR Clr = object->GetBackColorEnd();
C	HRESULT object->get_BackColorEnd(OLE_COLOR* Clr);

Put

VB.NET	object.BackColorEnd = Clr As UInteger
VB	object.BackColorEnd = Clr As OLE_COLOR
C#.NET	uint object.BackColorEnd = Clr;
VC++	OLE_COLOR object->BackColorEnd = Clr; void object->PutBackColorEnd(OLE_COLOR Clr);
C	HRESULT object->put_BackColorEnd(OLE_COLOR Clr);

object

A SftTreeCell object.

Clr

Defines the cell's background color, combined with BackColor creating a gradient fill. -1 indicates that there is no defined color and the default colors are used. For information about color properties, please visit the applicable section "Using SftTree/OCX with ...".

Comments

The BackColorEnd property defines the cell's background color, combined with Cell.BackColor creating a gradient fill.

The Cell.BackColor property can be used to define the cell's background color, combined with BackColorEnd creating a gradient fill. The orientation of the gradient fill can be defined using the Cell.BackColorOrientation property. If Cell.BackColor is not defined, BackColorEnd is ignored and has no effect.

Examples

VB.NET

        AxSftTree1.get_Item(I).Level = 1
        AxSftTree1.get_Cell(I, 0).ProgressColorOrientation = SftTreeOrientationDefaultConstants.verticalDefaultOrientationSftTree
        AxSftTree1.get_Cell(I, 0).ProgressStyle = SftTreeProgressStyleDefaultConstants.smallDefaultProgressStyleSftTree
        AxSftTree1.get_Cell(I, 0).ProgressColor = Convert.ToUInt32(ColorTranslator.ToOle(Color.FromArgb(128, 128, 0)) And &HFFFFFFFF&)
        AxSftTree1.get_Cell(I, 0).ProgressColorEnd = Convert.ToUInt32(ColorTranslator.ToOle(Color.FromArgb(255, 255, 0)) And &HFFFFFFFF&)
        AxSftTree1.get_Cell(I, 0).ProgressMax = 150   ' maximum value 0-150
        AxSftTree1.get_Cell(I, 0).ProgressValue = 40  ' current value
        AxSftTree1.get_Cell(I, 0).BackColor = Convert.ToUInt32(ColorTranslator.ToOle(Color.FromKnownColor(KnownColor.Window)) And &HFFFFFFFF&)
        AxSftTree1.get_Cell(I, 0).BackColorEnd = Convert.ToUInt32(ColorTranslator.ToOle(Color.FromArgb(255, 0, 0)) And &HFFFFFFFF&)
        AxSftTree1.get_Cell(I, 0).BackColorOrientation = SftTreeOrientationDefaultConstants.horizontalDefaultOrientationSftTree


        ItemIndex = AxSftTree1.Items.Add("Supported Picture Types")
        AxSftTree1.get_Cell(ItemIndex, 1).Text = "SftTree/OCX supports numerous image types, such as GDI+, bitmaps, icons, ImageLists and also offers numerous built-in images.."

        ' add GDI+ samples

View Entire Sample Code

VB6

        Set cellObj = .Cell(I, 0)
        cellObj.ProgressColorOrientation = verticalDefaultOrientationSftTree
        cellObj.ProgressStyle = smallDefaultProgressStyleSftTree
        cellObj.ProgressColor = &H8080&
        cellObj.ProgressColorEnd = &HFFFF&
        cellObj.ProgressMax = 150    ' maximum value 0-150
        cellObj.ProgressValue = 40   ' current value
        cellObj.BackColor = &H80000005
        cellObj.BackColorEnd = &HFF&
        cellObj.BackColorOrientation = horizontalDefaultOrientationSftTree

        ' Picture Types

        ItemIndex = .Items.Add("Supported Picture Types")
        .Cell(ItemIndex, 1).Text = "SftTree/OCX supports numerous image types, such as GDI+ images, bitmaps, icons, ImageLists and also offers numerous built-in images."

View Entire Sample Code

C#

            axSftTree1.get_Item(I).Level = 1;
            axSftTree1.get_Cell(I, 0).ProgressColorOrientation = SftTreeOrientationDefaultConstants.verticalDefaultOrientationSftTree;
            axSftTree1.get_Cell(I, 0).ProgressStyle = SftTreeProgressStyleDefaultConstants.smallDefaultProgressStyleSftTree;
            axSftTree1.get_Cell(I, 0).ProgressColor = (uint) ColorTranslator.ToOle(Color.FromArgb(128, 128, 0));
            axSftTree1.get_Cell(I, 0).ProgressColorEnd = (uint) ColorTranslator.ToOle(Color.FromArgb(255, 255, 0));
            axSftTree1.get_Cell(I, 0).ProgressMax = 150;   // maximum value 0-150
            axSftTree1.get_Cell(I, 0).ProgressValue = 40; // current value
            axSftTree1.get_Cell(I, 0).BackColor = (uint) ColorTranslator.ToOle(Color.FromKnownColor(KnownColor.Window));
            axSftTree1.get_Cell(I, 0).BackColorEnd = (uint)ColorTranslator.ToOle(Color.FromArgb(255, 0, 0));
            axSftTree1.get_Cell(I, 0).BackColorOrientation = SftTreeOrientationDefaultConstants.horizontalDefaultOrientationSftTree;


            ItemIndex = axSftTree1.Items.Add("Supported Picture Types");
            axSftTree1.get_Cell(ItemIndex, 1).Text = "SftTree/OCX supports numerous image types, such as GDI+, bitmaps, icons, ImageLists and also offers numerous built-in images.";

            // add GDI+ samples

View Entire Sample Code

C++

    m_vTree->Item[i]->Level = 1;
    m_vTree->Cell[i][0]->ProgressColorOrientation = verticalDefaultOrientationSftTree;
    m_vTree->Cell[i][0]->ProgressStyle = smallDefaultProgressStyleSftTree;
    m_vTree->Cell[i][0]->ProgressColor = RGB(128,128,0);
    m_vTree->Cell[i][0]->ProgressColorEnd = RGB(255,255,0);
    m_vTree->Cell[i][0]->ProgressMax = 150;   // maximum value 0-150
    m_vTree->Cell[i][0]->ProgressValue = 40; // current value
    m_vTree->Cell[i][0]->BackColor = 0x80000000L | COLOR_WINDOW;
    m_vTree->Cell[i][0]->BackColorEnd = RGB(255, 0, 0);
    m_vTree->Cell[i][0]->BackColorOrientation = horizontalDefaultOrientationSftTree;

    ItemIndex = m_vTree->Items->Add("Supported Picture Types");

    m_vTree->Cell[ItemIndex][1]->Text = _T("SftTree/OCX supports numerous image types, such as GDI+, bitmaps, icons, ImageLists and also offers numerous built-in images.");

    // add GDI+ samples

View Entire Sample Code

See Also SftTreeCell Object | Object Hierarchy