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 Windows Explorer on Windows 98/ME/2000 |
| buttonsSftTreeModern | 4 | Modern (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. |
| 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 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. |
| buttonsSftTreeAutoTheme | 7 | Automatic 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. |
| buttonsSftTreeAutoThemeVista | 8 | Automatic 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
On
Off