Carbon


BasicWindowDescription

Header: MacWindows.h

struct BasicWindowDescription {
    UInt32 descriptionSize; 
    Rect windowContentRect; 
    Rect windowZoomRect; 
    UInt32 windowRefCon; 
    UInt32 windowStateFlags; 
    WindowPositionMethod windowPositionMethod; 
    UInt32 windowDefinitionVersion; 
    union {
        struct {  
        SInt16 windowDefProc; 
        Boolean windowHasCloseBox;
        } versionOne; 
    struct {  
        WindowClass windowClass; 
        WindowAttributes windowAttributes;
        } versionTwo;
    } windowDefinition;
};

Field descriptions

descriptionSize

A value specifying the size of the entire BasicWindowDescription structure.

windowContentRect

A structure of type Rect, specifying the initial size and screen location of the window’s content area.

windowZoomRect

Reserved.

windowRefCon

The window’s reference value field, which is simply storage space available to your application for any purpose. The value contained in this field persists when the 'wind' resource is stored, so you should avoid saving pointers in this field, as they may become stale.

windowStateFlags

A 32-bit value whose bits you set to indicate the status of transient window states. See “BasicWindowDescription State Constant” for possible values.

windowPositionMethod

The specification last used in the function RepositionWindow to position this window, if any. See “RepositionWindow Constants” for a description of possible values for this field.

windowDefinitionVersion

The version of the window definition used for the window. Set this field to a value of 1 if your application is creating a pre–Mac OS 8.5 window, that is, a window lacking class and attribute information. Set this field to a value of 2 if your application is creating a window using class and attribute information. See “BasicWindowDescription Version Constants” for descriptions of these values.

windowDefinition

A union of the versionOne and versionTwo structures. Your application must either specify the window’s class and attributes, or it must supply a window definition ID and specify whether or not the window has a close box. See “Window Class Constants” and “Window Attribute Constants” for descriptions of class and attribute values.

The BasicWindowDescription structure is a default collection item for a resource of type ‘wind’. You use the BasicWindowDescription structure to describe the statically-sized base characteristics of a window.


© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)