Appearance Property, CellBaseClass Class


	Appearance Property, CellBaseClass Class	Softel vdm, Inc.

Defines the background appearance of the cell.

Syntax CellBaseClass Class (Softelvdm.Controls)

VB	Public Property Appearance As BackgroundAppearanceEnum
C#	public BackgroundAppearanceEnum Appearance { get; set; }
C++	public: property BackgroundAppearanceEnum Appearance { BackgroundAppearanceEnum get(); void set(BackgroundAppearanceEnum value); }

Property Value

The background appearance.

BackgroundAppearanceEnum

Value

Description

Clean
0
No particular background rendering is applied. Foreground and background colors are used to render the available area.

ButtonPlain
1
The background is rendered with the same appearance as a plain button (a non-themed button image). Foreground and background colors are used to render the available area.

ButtonPlainNeverPressed
2
The background is rendered with the same appearance as a plain button (a non-themed button image). ButtonPlainNeverPressed behaves just line ButtonPlain, but does not reflect a pressed state. Foreground and background colors are used to render the available area.

ThemedSystemHeader
3
The background is rendered with the same appearance as a header (using Windows themes if available). Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.

ThemedSystemHeaderEmptyArea
4
The background is rendered with the same appearance as a header above an empty area (using Windows themes if available). Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.

ThemedSystemHeaderNeverPressed
5
The background is rendered with the same appearance as a header (using Windows themes if available). ThemedSystemHeaderNeverPressed behaves just line ThemedSystemHeader, but does not reflect a pressed state. Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.

ThemedAppearanceHeader
6
The background is rendered with the same appearance as a header (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). Defined background colors are ignored.

ThemedAppearanceHeaderEmptyArea
7
The background is rendered with the same appearance as a header above an empty area (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). Defined background colors are ignored.

ThemedAppearanceHeaderNeverPressed
8
The background is rendered with the same appearance as a header (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). ThemedAppearanceHeaderNeverPressed behaves just line ThemedAppearanceHeader, but does not reflect a pressed state. Defined background colors are ignored.

Default
-1
The default value is determined by a containing object or by the environment. If no containing object or environmental information is available, BackgroundAppearanceEnum.Default is identical to BackgroundAppearanceEnum.Clean.

The default value is BackgroundAppearanceEnum.Default.

Comments

The Appearance property defines the background appearance of the cell.

SftTree/NET 2.0: The default background appearance can be defined using these properties: RowHeaders.AppearanceDefault for row headers, Headers.AppearanceDefault for column headers and Footers.AppearanceDefault for column footers. The default for items is BackgroundAppearanceEnum.Clean and cannot be changed.

The EvaluatedAppearance property can be used to determine the actual background appearance for this cell by evaluating the default settings.

SftTabs/NET 6.0: Cells only offer background appearances based on the BackColor property and this property has no effect.

Version Information

Supported in version 1.0.
Products Table

BackgroundAppearanceEnum	Value	Description
Clean	0	No particular background rendering is applied. Foreground and background colors are used to render the available area.
ButtonPlain	1	The background is rendered with the same appearance as a plain button (a non-themed button image). Foreground and background colors are used to render the available area.
ButtonPlainNeverPressed	2	The background is rendered with the same appearance as a plain button (a non-themed button image). ButtonPlainNeverPressed behaves just line ButtonPlain, but does not reflect a pressed state. Foreground and background colors are used to render the available area.
ThemedSystemHeader	3	The background is rendered with the same appearance as a header (using Windows themes if available). Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.
ThemedSystemHeaderEmptyArea	4	The background is rendered with the same appearance as a header above an empty area (using Windows themes if available). Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.
ThemedSystemHeaderNeverPressed	5	The background is rendered with the same appearance as a header (using Windows themes if available). ThemedSystemHeaderNeverPressed behaves just line ThemedSystemHeader, but does not reflect a pressed state. Foreground and background colors are used to render the available area. However, background colors are ignored when Windows themes are available.
ThemedAppearanceHeader	6	The background is rendered with the same appearance as a header (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). Defined background colors are ignored.
ThemedAppearanceHeaderEmptyArea	7	The background is rendered with the same appearance as a header above an empty area (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). Defined background colors are ignored.
ThemedAppearanceHeaderNeverPressed	8	The background is rendered with the same appearance as a header (emulating an appearance that mimics Windows XP themes, even on operating systems that do not offer themes). ThemedAppearanceHeaderNeverPressed behaves just line ThemedAppearanceHeader, but does not reflect a pressed state. Defined background colors are ignored.
Default	-1	The default value is determined by a containing object or by the environment. If no containing object or environmental information is available, BackgroundAppearanceEnum.Default is identical to BackgroundAppearanceEnum.Clean.