The control can assume the appearance of a Office 2007 style button by setting its Surface property to SURFACE_OFFICE_2007.
The Office 2007 style carries new dedicated colors which replace the default colors set through the BackColor and ColorSurfaceNormal properties (with the exception of the outer border drawn when the SpecialEffect property is set to a value different from SPECIAL_EFFECT_NONE).
Office 2007 buttons are rendered through the use of 2 vertical linear gradients, each of them made up of 2 colors: the first gradient is set on the North side of the button and the second one is set on the South side of the button. If needed, an optional color can be applied to the 2 existing borders.
Depending upon the button state, all predefined colors may be changed; below a summary of colors applied (with involved properties) in various button states:
Office2007ColorNorthTop
Office2007ColorNorthBottom
Office2007ColorSouthTop
Office2007ColorSouthBottom
Office2007ColorInnerBorder (if left undefined, the border will not be rendered)
Office2007ColorOuterBorder (if left undefined, the border will not be rendered)
Office2007ColorNorthTopPressed
Office2007ColorNorthBottomPressed
Office2007ColorSouthTopPressed
Office2007ColorSouthBottomPressed
Office2007ColorInnerBorderPressed (if left undefined, the border will not be rendered)
Office2007ColorOuterBorderPressed (if left undefined, the border will not be rendered)
Office2007ColorNorthTopMouseOver
Office2007ColorNorthBottomMouseOver
Office2007ColorSouthTopMouseOver
Office2007ColorSouthBottomMouseOver
Office2007ColorInnerBorderMouseOver (if left undefined, the border will not be rendered)
Office2007ColorOuterBorderMouseOver (if left undefined, the border will not be rendered)
Each of the borders width, expressed in pixels, can be modified through the Office2007InnerBorderWidth and Office2007OuterBorderWidth properties.
The simplest way to change colors and options applied to the Office 2007 style is to use, inside 3D Button Visual Editor, the Office 2007 style tab. At run-time each of these properties can be referenced by name.
Note: The image below has hot links to take you to explanations of various button settings.
|
Item name
|
Description
|
Corresponding property
|
|
North top normal
|
The gradient color used for the upper portion of the Northern button's side in normal state
|
Office2007ColorNorthTop
|
|
North bottom normal
|
The gradient color used for the lower portion of the Northern button's side in normal state
|
Office2007ColorNorthBottom
|
|
South top normal
|
The gradient color used for the upper portion of the Southern button's side in normal state
|
Office2007ColorSouthTop
|
|
South bottom normal
|
The gradient color used for the lower portion of the Southern button's side in normal state
|
Office2007ColorSouthBottom
|
|
Outer border normal
|
The color of the outer border in normal state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the  symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorOuterBorder
|
|
Inner border normal
|
The color of the inner border in normal state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorInnerBorder
|
|
North top mouse over
|
The gradient color used for the upper portion of the Northern button's side in mouse over state
|
Office2007ColorNorthTopMouseOver
|
|
North bottom mouse over
|
The gradient color used for the lower portion of the Northern button's side in mouse over state
|
Office2007ColorNorthBottomMouseOver
|
|
South top mouse over
|
The gradient color used for the upper portion of the Southern button's side in mouse over state
|
Office2007ColorSouthTopMouseOver
|
|
South bottom mouse over
|
The gradient color used for the lower portion of the Southern button's side in mouse over state
|
Office2007ColorSouthBottomMouseOver
|
|
Outer border mouse over
|
The color of the outer border in mouse over state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorOuterBorderMouseOver
|
|
Inner border mouse over
|
The color of the inner border in mouse over state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorInnerBorderMouseOver
|
|
North top pressed
|
The gradient color used for the upper portion of the Northern button's side in pressed state
|
Office2007ColorNorthTopPressed
|
|
North bottom pressed
|
The gradient color used for the lower portion of the Northern button's side in pressed state
|
Office2007ColorNorthBottomPressed
|
|
South top pressed
|
The gradient color used for the upper portion of the Southern button's side in pressed state
|
Office2007ColorSouthTopPressed
|
|
South bottom pressed
|
The gradient color used for the lower portion of the Southern button's side in pressed state
|
Office2007ColorSouthBottomPressed
|
|
Outer border pressed
|
The color of the outer border in pressed state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorOuterBorderPressed
|
|
Inner border pressed
|
The color of the inner border in pressed state: if this color is left undefined the border won't be rendered.
The undefined state is represented with the symbol inside the color box. Once the color has been defined, it can be reset back to the undefined state by double-clicking the relative color box (not the "..." button).
|
Office2007ColorInnerBorderPressed
|
|
Outer border width
|
The width in pixels of the outer border
|
Office2007OuterBorderWidth
|
|
Inner border width
|
The width in pixels of the inner border
|
Office2007InnerBorderWidth
|
|
