Carbon


ThemeWindowMetrics

Header: Appearance.h

struct ThemeWindowMetrics {
    UInt16 metricSize; 
    SInt16 titleHeight; 
    SInt16 titleWidth; 
    SInt16 popupTabOffset; 
    SInt16 popupTabWidth; 
    UInt16 popupTabPosition;
};
typedef ThemeWindowMetrics ThemeWindowMetricsPtr;

Field descriptions

metricSize

A value specifying the size of the ThemeWindowMetrics structure.

titleHeight

A measurement in pixels of the height of the title text in the current system font, including any icon that may be present in the title region. Set this field to 0 if the window does not contain a title.

titleWidth

A measurement in pixels of the width of the title text in the current system font, including any icon that may be present in the title region. Set this field to 0 if the window does not contain a title.

popupTabOffset

A measurement in pixels of the distance that the left edge of a pop-up window’s tab is offset from the left edge of the window. This value is used in conjunction with the value passed in the popupTabPosition field to determine the actual position of the tab. Set this field to 0 if the window is not a pop-up window.

popupTabWidth

A measurement in pixels of the width of a pop-up window’s tab. Set this field to 0 if the window is not a pop-up window.

popupTabPosition

A value specifying the rule to apply when positioning a pop-up window’s tab. Set this field to 0 if the window is not a pop-up window.

A value of kThemePopupTabNormalPosition specifies that the left edge of the tab is to be drawn at the position indicated by the popupTabOffset field.

A value of kThemePopupTabCenterOnWindow specifies that the tab is to be drawn centered on the window; the popupTabOffset field is ignored.

A value of kThemePopupTabCenterOnOffset specifies that the tab is to be drawn centered at the position indicated by the popupTabOffset field.

Your application uses the ThemeWindowMetrics structure to inform the Appearance Manager of the dimensions of specific parts of your window. See the functions discussed in "Drawing Theme-Compliant Windows" for specific uses of the ThemeWindowMetrics type.

VERSION NOTES

The ThemeWindowMetrics structure is available with Appearance Manager 1.1 and later.


© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)