Hide

SftTree/OCX 7.5 - ActiveX Tree Control

Display
Print

ButtonAppearance Property, SftTree Object

Defines the expand/collapse button appearance.

Syntax

Get

VB.NETStyle = object.ButtonAppearance As SftTreeButtonAppearanceConstants
VBStyle = object.ButtonAppearance As SftTreeButtonAppearanceConstants
C#.NETSftTreeButtonAppearanceConstants Style = object.ButtonAppearance;
VC++enum SftTreeButtonAppearanceConstants Style = object->ButtonAppearance;
enum SftTreeButtonAppearanceConstants Style = object->GetButtonAppearance();
CHRESULT object->get_ButtonAppearance(enum SftTreeButtonAppearanceConstants* Style);

Put

VB.NETobject.ButtonAppearance = Style As SftTreeButtonAppearanceConstants
VBobject.ButtonAppearance = Style As SftTreeButtonAppearanceConstants
C#.NETSftTreeButtonAppearanceConstants object.ButtonAppearance = Style;
VC++enum SftTreeButtonAppearanceConstants object->ButtonAppearance = Style;
void object->PutButtonAppearance(enum SftTreeButtonAppearanceConstants Style);
CHRESULT object->put_ButtonAppearance(enum SftTreeButtonAppearanceConstants Style);

object

A SftTree object.

Style

Defines the expand/collapse button appearance.

StyleValueDescription
buttonsSftTreeUserImages-1User defined button images - Expand/collapse buttons are defined using the properties ButtonExpanded, ButtonCollapsed (and optionally the properties ButtonExpandedDown, ButtonCollapsedDown, ButtonExpandedHot, ButtonCollapsedHot).
buttonsSftTreeClassicSmall0Classic small button - Small gray button image with + and - symbols.
buttonsSftTreeClassicWide1Classic wide button - Wide gray button image with + and - symbols.
buttonsSftTreeClassicLarge2Classic large buttons - Large gray button image with up and down symbols
buttonsSftTreeSimple3Simple - White box with + and - symbols, similar to Windows Explorer on Windows 98/ME/2000
buttonsSftTreeModern4Modern (using bitmaps) - The button style is not based on a bitmap. It is determined by the Windows release and is rendered by Windows. Note: On Windows XP and above, the button will always be rendered using the buttonsSftTreeClassicSmall style, as standard buttons supported by most themes are not suitable for use as expand/collapse buttons due to their small size.
buttonsSftTreeThemeImitation5Theme imitation (using bitmaps) - Button image as used on Windows XP. This style is not limited to Windows XP as it is based on a bitmap. No actual Windows themes are used.
buttonsSftTreeAutoThemeImitation6Automatic theme imitation (using bitmaps) - Depending on the Windows version and available features, the control selects the appropriate button style. On Windows XP (and above) with themes, buttonsSftTreeThemeImitation is selected. On all other Windows versions or if themes are not available, buttonsSftTreeModern is selected.
buttonsSftTreeAutoTheme7Automatic theme - Depending on the Windows version and available features, the control selects the appropriate button style. On Windows XP (and above) with themes, the button image is rendered using the currently selected Windows theme. On all other Windows versions or if themes are not available, buttonsSftTreeSimple is selected. A Windows Vista themed button looks like a Windows XP button. For a look similar to Windows Explorer on Windows Vista, select buttonsSftTreeAutoThemeVista instead.
buttonsSftTreeAutoThemeVista8Automatic theme (Vista+) - Depending on the Windows version and available features, the control selects the appropriate button style. On Windows XP with themes, the button image is rendered using the currently selected Windows theme. On Windows Vista and above with themes, a look similar to Windows Explorer is used (based on GDI+ images). On all other Windows versions or if themes are not available, buttonsSftTreeSimple is selected.

Comments

The ButtonAppearance property defines the expand/collapse button appearance.

All items use the same expand/collapse bitmap. Expand/collapse buttons are only shown if enabled using ButtonStyle.

Sample bitmaps for expand/collapse buttons are provided in the directory \Program Files\Softelvdm\SftTree OCX 7.5\Images.

When using buttonsSftTreeAutoThemeVista to adapt the button style based on the current operating system used, the application must be marked as supporting specific operating systems (see https://msdn.microsoft.com/en-us/library/windows/desktop/dn481241). Users can further override the determined operating system using the application's compatibility settings.

See Also SftTree Object | Object Hierarchy


Last Updated 08/13/2020 - (email)
© 2022 Softel vdm, Inc.