HeaderPane
Main
Hide
Share Link
Print

Appearance Property, SftPictureObject Object

Defines the image object using a built-in, special purpose image.

Syntax

Get

C#SftPictureImageConstants Style = object.Appearance;
VB.NETStyle = object.Appearance As SftPictureImageConstants
C++enum SftPictureImageConstants Style = object->Appearance;
enum SftPictureImageConstants Style = object->GetAppearance();
CHRESULT object->get_Appearance(enum SftPictureImageConstants* Style);
VBStyle = object.Appearance As SftPictureImageConstants

Put

C#SftPictureImageConstants object.Appearance = Style;
VB.NETobject.Appearance = Style As SftPictureImageConstants
C++enum SftPictureImageConstants object->Appearance = Style;
void object->PutAppearance(enum SftPictureImageConstants Style);
CHRESULT object->put_Appearance(enum SftPictureImageConstants Style);
VBobject.Appearance = Style As SftPictureImageConstants

object

A SftPictureObject object.

Style

Defines the image object using a built-in, special purpose image.

NameValueDescription
sftImageNone-1None
sftImageCheckboxNo0Checkbox - No
sftImageCheckboxYes1Checkbox - Yes
sftImageCheckboxUnknown2Checkbox - Unknown
sftImageCheckboxNoDisabled3Checkbox - No, Disabled
sftImageCheckboxYesDisabled4Checkbox - Yes, Disabled
sftImageCheckboxUnknownDisabled5Checkbox - Unknown, Disabled
sftImageRadioButtonNo6RadioButton - No
sftImageRadioButtonYes7RadioButton - Yes
sftImageRadioButtonNoDisabled8RadioButton - No, Disabled
sftImageRadioButtonYesDisabled9RadioButton - Yes, Disabled
sftImageUp10Up
sftImageUpDisabled11Up, Disabled
sftImageDown12Down
sftImageDownDisabled13Down, Disabled
sftImageSortAsc14Sort Ascending
sftImageSortAscDisabled15Sort Ascending, Disabled
sftImageSortDesc16Sort Descending
sftImageSortDescDisabled17Sort Descending, Disabled

Comments

The Appearance property defines the image object using a built-in, special purpose image.

The SftPictureObject.Type property is set to sftTypeBuiltin.

The SftPictureObject.Height and SftPictureObject.Width properties should be used to define the requested image size. The SftPictureObject.ActualHeight and SftPictureObject.ActualWidth properties reflect the image dimensions.

Examples

C# View entire sample code

    axSftButtonCheck.AutoSize = SftButtonAutoSizeConstants.autosizeSftButtonLeftCenter;
#else
    axSftButtonCheck.CtlAutoSize = SftButtonAutoSizeConstants.autosizeSftButtonLeftCenter;
#endif
    axSftButtonCheck.Bounce = SftButtonBounceStyleConstants.bounceSftButtonNo;
    axSftButtonCheck.ButtonStyle = SftButtonStyleConstants.styleSftButtonNone;
    axSftButtonCheck.ClickStyle = SftButtonClickStyleConstants.clickstyleSftButtonPictures;
    axSftButtonCheck.HoverStyle = SftButtonHoverStyleConstants.hoverstyleSftButtonExact;
    axSftButtonCheck.Image1.Appearance = SftPictureImageConstants.sftImageCheckboxYes;
    axSftButtonCheck.Text = "A SftButton control that looks like a check box with a caption";
    axSftButtonCheck.ShowFocus = false;
}

private void check1_CheckedChanged(object sender, System.EventArgs e)
{
    // enable/disable the control so the image changes

VB.NET View entire sample code

    AxSftButtonCheck.AutoSize = SftButtonAutoSizeConstants.autosizeSftButtonLeftCenter
#Else
    AxSftButtonCheck.CtlAutoSize = SftButtonAutoSizeConstants.autosizeSftButtonLeftCenter
#End If
    AxSftButtonCheck.Bounce = SftButtonBounceStyleConstants.bounceSftButtonNo
    AxSftButtonCheck.ButtonStyle = SftButtonStyleConstants.styleSftButtonNone
    AxSftButtonCheck.ClickStyle = SftButtonClickStyleConstants.clickstyleSftButtonPictures
    AxSftButtonCheck.HoverStyle = SftButtonHoverStyleConstants.hoverstyleSftButtonExact
    AxSftButtonCheck.Image1.Appearance = SftPictureImageConstants.sftImageCheckboxYes
    AxSftButtonCheck.Text = "A SftButton control that looks like a check box with a caption"
    AxSftButtonCheck.ShowFocus = False
End Sub

Private Sub check1_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles check1.CheckedChanged
    ' enable/disable the control so the image changes
    AxSftButton1.Enabled = Not check1.Checked

C++ View entire sample code

    // initialize a SftButton control to look like a check box
    m_vButtonCheck->BorderAlways = VARIANT_FALSE;
    m_vButtonCheck->AutoSize = autosizeSftButtonLeftCenter;
    m_vButtonCheck->Bounce = bounceSftButtonNo;
    m_vButtonCheck->ButtonStyle = styleSftButtonNone;
    m_vButtonCheck->ClickStyle = clickstyleSftButtonPictures;
    m_vButtonCheck->HoverStyle = hoverstyleSftButtonExact;
    m_vButtonCheck->Image1->Appearance = sftImageCheckboxYes;
    m_vButtonCheck->Text = "A SftButton control that looks like a check box with a caption";
    m_vButtonCheck->ShowFocus = VARIANT_FALSE;

    return TRUE;  // return TRUE  unless you set the focus to a control
}

// If you add a minimize button to your dialog, you will need the code below
//  to draw the icon.  For MFC applications using the document/view model,

VB6 View entire sample code

    ' initialize a SftButton control to look like a check box
    SftButtonCheck.BorderAlways = False
    SftButtonCheck.AutoSize = autosizeSftButtonLeftCenter
    SftButtonCheck.Bounce = bounceSftButtonNo
    SftButtonCheck.ButtonStyle = styleSftButtonNone
    SftButtonCheck.ClickStyle = clickstyleSftButtonPictures
    SftButtonCheck.HoverStyle = hoverstyleSftButtonExact
    SftButtonCheck.Image1.Appearance = sftImageCheckboxYes
    SftButtonCheck.Text = "A SftButton control that looks like a check box with a caption"
    SftButtonCheck.ShowFocus = False
End Sub

Private Sub Check1_Click()
    ' enable/disable the control so the image changes
    SftButton1.Enabled = (Check1.Value = 0)
End Sub

See Also SftPictureObject Object | Object Hierarchy


Last Updated 11/03/2026 - (email)
© 2026 Softel vdm, Inc.