SftButton/OCX 3.0 - Button Control

BackColorEnd Property, SftButton Object

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

Syntax

Get

VB.NET	Clr = object.BackColorEnd As System.Drawing.Color
VB	Clr = object.BackColorEnd As OLE_COLOR
C#.NET	System.Drawing.Color 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 System.Drawing.Color
VB	object.BackColorEnd = Clr As OLE_COLOR
C#.NET	System.Drawing.Color 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 SftButton object.

Clr

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

Comments

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

This property has no effect if Windows themes are used.

The FillOrientation defines the gradient fill orientation. The BackColorEnd property is the ending color value (right or bottom).

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.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
    AxSftButton1.BackColorPressed = SystemColors.Control

View Entire Sample Code

VB6

    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
    SftButton1.BackColorPressed = vbButtonFace

View Entire Sample Code

C#

    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;
    axSftButton1.BackColorPressed = SystemColors.Control;

View Entire Sample Code

C++

    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));
    m_vButton->put_BackColorPressed(COLOR_BTNFACE|0x80000000L);

View Entire Sample Code

See Also SftButton Object | Object Hierarchy