ButtonAppearance Property, SftTree Object
Defines the expand/collapse button appearance.
Syntax
Get
Put
object
A SftTree object.
Style
Defines the expand/collapse button appearance.
| Style | Value | Description |
|---|
| buttonsSftTreeUserImages | -1 | User defined button images - Expand/collapse buttons are defined using the properties ButtonExpanded, ButtonCollapsed (and optionally the properties ButtonExpandedDown, ButtonCollapsedDown, ButtonExpandedHot, ButtonCollapsedHot). |
| buttonsSftTreeClassicSmall | 0 | Classic small button - Small gray button image with + and - symbols. |
| buttonsSftTreeClassicWide | 1 | Classic wide button - Wide gray button image with + and - symbols. |
| buttonsSftTreeClassicLarge | 2 | Classic large buttons - Large gray button image with up and down symbols |
| buttonsSftTreeSimple | 3 | Simple - White box with + and - symbols, similar to the classic Windows Explorer look |
| buttonsSftTreeModern | 4 | Modern (using bitmaps) - The button style is not based on a bitmap. It is rendered by Windows. Note: 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. |
| buttonsSftTreeThemeImitation | 5 | Theme 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. |
| buttonsSftTreeAutoThemeImitation | 6 | Automatic theme imitation (using bitmaps) - Depending on the available features, the control selects the appropriate button style. With themes, buttonsSftTreeThemeImitation is selected. If themes are not available, buttonsSftTreeModern is selected. |
| buttonsSftTreeAutoTheme | 7 | Automatic theme - Depending on the available features, the control selects the appropriate button style. With themes, the button image is rendered using the currently selected Windows theme. If themes are not available, buttonsSftTreeSimple is selected. For a look similar to Windows Explorer, select buttonsSftTreeAutoThemeVista instead. |
| buttonsSftTreeAutoThemeVista | 8 | Automatic theme (Vista+) - Depending on the available features, the control selects the appropriate button style. With themes, a look similar to Windows Explorer is used (based on GDI+ images). 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 8.0\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.
Examples
VB6
UseThemes = -1 'True
Scrollbars = 3
ScrollbarStyle = 0
ShowTruncated = 1
VAlignStyle = 0
VirtualMode = 0
WebLicense = ""
SmoothScroll = 1
ButtonAppearance= -1
MouseOverTransitionEffect= 4
BeginProperty ButtonExpanded {980702E2-0AB6-41B1-9B85-F8755A697255}
Object.Height = 0
Object.Width = 0
Appearance = -1
FrameColor = -1
SampleColor = -1 View Entire Sample Code
See Also SftTree Object | Object Hierarchy
On
Off