SftButton/OCX 3.0 - Button Control

BackColorStart Property, SftButton Object

Defines the control's gradient fill background color (combined with BackColorEnd).

Syntax

Get

VB.NET	Clr = object.BackColorStart As System.Drawing.Color
VB	Clr = object.BackColorStart As OLE_COLOR
C#.NET	System.Drawing.Color Clr = object.BackColorStart;
VC++	OLE_COLOR Clr = object->BackColorStart; OLE_COLOR Clr = object->GetBackColorStart();
C	HRESULT object->get_BackColorStart(OLE_COLOR* Clr);

Put

VB.NET	object.BackColorStart = Clr As System.Drawing.Color
VB	object.BackColorStart = Clr As OLE_COLOR
C#.NET	System.Drawing.Color object.BackColorStart = Clr;
VC++	OLE_COLOR object->BackColorStart = Clr; void object->PutBackColorStart(OLE_COLOR Clr);
C	HRESULT object->put_BackColorStart(OLE_COLOR Clr);

object

A SftButton object.

Clr

Defines the control's gradient fill background color (combined with BackColorEnd). For information about color properties, please visit the applicable section "Using SftButton/OCX with ...".

Comments

The BackColorStart property defines the control's gradient fill background color (combined with BackColorEnd).

This property has no effect if Windows themes are used.

The FillOrientation defines the gradient fill orientation. The BackColorStart property is the starting color value (left or top).

If both BackColorStart and BackColorEnd define valid starting and ending colors, these take precedence and the BackColor property has no effect. On display devices that do not support gradient fills or if fewer than 65K colors are available, the BackColor property is used instead.

Examples

VB.NET

    AxSftButton1.Enabled = True
    AxSftButton1.Follows = False
    AxSftButton1.OLEDragMode = SftButtonOLEDragModeConstants.OLEDragSftButtonNone
    AxSftButton1.OLEDropMode = SftButtonOLEDropModeConstants.OLEDropSftButtonNone
    AxSftButton1.RightToLeft = False
    AxSftButton1.Toggle = False
    ' Colors
    AxSftButton1.BackColor = SystemColors.Control
    AxSftButton1.BackColorStart = Color.Green
    AxSftButton1.BackColorEnd = Color.Blue
    AxSftButton1.BackColorFocus = SystemColors.Control
    AxSftButton1.BackColorFocusStart = Color.Red
    AxSftButton1.BackColorFocusEnd = Color.Green
    AxSftButton1.BackColorHover = SystemColors.Control
    AxSftButton1.BackColorHoverStart = Color.Yellow
    AxSftButton1.BackColorHoverEnd = Color.Cyan

View Entire Sample Code

VB6

    SftButton1.Enabled = True
    SftButton1.Follows = False
    SftButton1.OLEDragMode = OLEDragSftButtonNone
    SftButton1.OLEDropMode = OLEDropSftButtonNone
    SftButton1.RightToLeft = False
    SftButton1.Toggle = False
' Colors
    SftButton1.BackColor = vbButtonFace
    SftButton1.BackColorStart = vbGreen
    SftButton1.BackColorEnd = vbBlue
    SftButton1.BackColorFocus = vbButtonFace
    SftButton1.BackColorFocusStart = vbRed
    SftButton1.BackColorFocusEnd = vbGreen
    SftButton1.BackColorHover = vbButtonFace
    SftButton1.BackColorHoverStart = vbYellow
    SftButton1.BackColorHoverEnd = vbCyan

View Entire Sample Code

C#

    axSftButton1.Enabled = true;
    axSftButton1.Follows = false;
    axSftButton1.OLEDragMode = SftButtonOLEDragModeConstants.OLEDragSftButtonNone;
    axSftButton1.OLEDropMode = SftButtonOLEDropModeConstants.OLEDropSftButtonNone;
    axSftButton1.RightToLeft = false;
    axSftButton1.Toggle = false;
    // Colors
    axSftButton1.BackColor = SystemColors.Control;
    axSftButton1.BackColorStart = Color.Green;
    axSftButton1.BackColorEnd = Color.Blue;
    axSftButton1.BackColorFocus = SystemColors.Control;
    axSftButton1.BackColorFocusStart = Color.Red;
    axSftButton1.BackColorFocusEnd = Color.Green;
    axSftButton1.BackColorHover = SystemColors.Control;
    axSftButton1.BackColorHoverStart = Color.Yellow;
    axSftButton1.BackColorHoverEnd = Color.Cyan;

View Entire Sample Code

C++

    m_vButton->put_Enabled(VARIANT_TRUE);
    m_vButton->put_Follows(VARIANT_FALSE);
    m_vButton->put_OLEDragMode(OLEDragSftButtonNone);
    m_vButton->put_OLEDropMode(OLEDropSftButtonNone);
    m_vButton->put_RightToLeft(VARIANT_FALSE);
    m_vButton->put_Toggle(VARIANT_FALSE);
// Colors
    m_vButton->put_BackColor(COLOR_BTNFACE|0x80000000L);
    m_vButton->put_BackColorStart(RGB(0,255,0));
    m_vButton->put_BackColorEnd(RGB(0,0,255));
    m_vButton->put_BackColorFocus(COLOR_BTNFACE|0x80000000L);
    m_vButton->put_BackColorFocusStart(RGB(255,0,0));
    m_vButton->put_BackColorFocusEnd(RGB(0,255,0));
    m_vButton->put_BackColorHover(COLOR_BTNFACE|0x80000000L);
    m_vButton->put_BackColorHoverStart(RGB(0,255,255));
    m_vButton->put_BackColorHoverEnd(RGB(255,255,0));

View Entire Sample Code

See Also SftButton Object | Object Hierarchy