Inside Macintosh: JManager Reference /

Chapter 1 - JManager Reference / Application-Defined Functions

/

MyRequestFrame

Creates a new frame. When instantiating an AWT context, you must designate a callback function to handle requests for new frames. For example, this is how you would define your frame request function if you were to name it MyRequestFrame:

OSStatus MyRequestFrame (
JMAWTContextRef context,
JMFrameRef newFrame, 
JMFrameKind kind, 
UInt32 width, 
UInt32 height, 
Boolean resizeable,
JMFrameCallbacks* callbacks);

context

The AWT context making the frame request.

newFrame

A pointer to the new frame. On return this parameter is the new frame.

kind

The type of frame desired. See "Frame Types" (page 8) for a list of possible values for this field.

width

The width of the frame, in pixels.

height

The height of the frame, in pixels.

resizeable

A Boolean value. If resizeable is false, this frame is not resizeable; if resizeable is true, you can resize the frame.

callbacks

A pointer to the frame callbacks data structure. On return this parameter should specify the frame's callback functions. The AWT can then use these callbacks when it needs to modify a frame. See "Frame Callbacks Structure" (page 18) for more information about this data structure.

function result

A result code. The function should return a standard result code.