[wxWidgets.git] / include / wx / mac / uma.h

/////////////////////////////////////////////////////////////////////////////
// Name:        uma.h
// Purpose:     Universal MacOS API
// Author:      Stefan Csomor
// Modified by:
// Created:     03/02/99
// RCS-ID:      $Id: 
// Copyright:   (c) Stefan Csomor
// Licence:   	LGPL licence
/////////////////////////////////////////////////////////////////////////////

#ifndef H_UMA
#define H_UMA

// define this to be 1 if you have the 8.6 libs (weak linked)

#define UMA_USE_8_6 0 

// define this to be 1 if you have the carbon libs (weak linked or PreCarbon.lib)

#define UMA_USE_CARBON 0

#define UMA_USE_APPEARANCE 1
#define UMA_USE_WINDOWMGR 1

#if !UMA_USE_8_6 && UMA_USE_WINDOWMGR
#undef UMA_USE_WINDOWMGR
#define UMA_USE_WINDOWMGR 0
#endif

#if !TARGET_CARBON
	typedef short MenuItemIndex  ;
#endif

void UMAInitToolbox( UInt16 inMoreMastersCalls) ;
bool UMAHasAppearance() ;
long UMAGetAppearanceVersion() ;

// process manager

long UMAGetProcessMode() ;
bool UMAGetProcessModeDoesActivateOnFGSwitch() ;

// menu manager

void 			UMASetMenuTitle( MenuRef menu , ConstStr255Param title ) ;
UInt32 		UMAMenuEvent( EventRecord *inEvent ) ;
void 			UMAEnableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;	
void 			UMADisableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;	
// quickdraw

void			UMAShowWatchCursor() ;
void			UMAShowArrowCursor() ;

// window manager

GrafPtr		UMAGetWindowPort( WindowRef inWindowRef ) ;
void		 	UMADisposeWindow( WindowRef inWindowRef ) ;
void 			UMASetWTitleC( WindowRef inWindowRef , const char *title ) ;
void 			UMAGetWTitleC( WindowRef inWindowRef , char *title ) ;

void 			UMADrawGrowIcon( WindowRef inWindowRef ) ;
void			UMAShowWindow( WindowRef inWindowRef ) ;
void			UMAHideWindow( WindowRef inWindowRef ) ;
void			UMAShowHide( WindowRef inWindowRef , Boolean show) ;
void 			UMASelectWindow( WindowRef inWindowRef ) ;
void			UMABringToFront( WindowRef inWindowRef ) ;
void			UMASendBehind( WindowRef inWindowRef , WindowRef behindWindow ) ;
void			UMACloseWindow(WindowRef inWindowRef) ;

// appearance manager

void 			UMADrawControl( ControlHandle inControl ) ;

void 			UMAActivateControl( ControlHandle inControl ) ;
void			UMADeactivateControl( ControlHandle inControl ) ;
void			UMASetThemeWindowBackground		(WindowRef 				inWindow,
								 ThemeBrush 			inBrush,
								 Boolean 				inUpdate)	;
ControlHandle UMANewControl(WindowPtr 				owningWindow,
								 const Rect *			boundsRect,
								 ConstStr255Param 		controlTitle,
								 Boolean 				initiallyVisible,
								 SInt16 				initialValue,
								 SInt16 				minimumValue,
								 SInt16 				maximumValue,
								 SInt16 				procID,
								 SInt32 				controlReference)	;
void UMADisposeControl (ControlHandle 			theControl)	;
void UMAHiliteControl	(ControlHandle 			theControl,
								 ControlPartCode 		hiliteState)	;
void UMAShowControl						(ControlHandle 			theControl)	;
void UMAHideControl						(ControlHandle 			theControl);
void UMASetControlVisibility			(ControlHandle 			inControl,
								 Boolean 				inIsVisible,
								 Boolean 				inDoDraw);

bool UMAIsControlActive					(ControlHandle 			inControl);
bool UMAIsControlVisible				(ControlHandle 			inControl);
void UMAActivateControl					(ControlHandle 			inControl);
void UMADeactivateControl				(ControlHandle 			inControl);

OSErr UMAGetBestControlRect				(ControlHandle 			inControl,
								 Rect *					outRect,
								 SInt16 *				outBaseLineOffset);
OSErr UMASetControlFontStyle				(ControlHandle 			inControl,
								 const ControlFontStyleRec * inStyle)	;


void UMAMoveControl( ControlHandle inControl , short x , short y ) ;
void UMASizeControl( ControlHandle inControl , short x , short y ) ;
// control hierarchy

OSErr UMACreateRootControl				(WindowPtr 				inWindow,
								 ControlHandle *		outControl) ;

OSErr UMAEmbedControl					(ControlHandle 			inControl,
								 ControlHandle 			inContainer);

// keyboard focus
OSErr UMASetKeyboardFocus				(WindowPtr 				inWindow,
								 ControlHandle 			inControl,
								 ControlFocusPart 		inPart)	;


// events

ControlPartCode UMAHandleControlClick				(ControlHandle 			inControl,
								 Point 					inWhere,
								 SInt16 				inModifiers,
								 ControlActionUPP 		inAction) ;
SInt16 UMAHandleControlKey				(ControlHandle 			inControl,
								 SInt16 				inKeyCode,
								 SInt16 				inCharCode,
								 SInt16 				inModifiers);
								 
void UMAIdleControls					(WindowPtr 				inWindow)	;

void UMAUpdateControls( WindowPtr inWindow , RgnHandle inRgn ) ;
OSErr UMAGetRootControl( WindowPtr inWindow , ControlHandle *outControl ) ;

// handling control data

OSErr UMASetControlData					(ControlHandle 			inControl,
								 ControlPartCode 		inPart,
								 ResType 				inTagName,
								 Size 					inSize,
								 Ptr 					inData)		;

OSErr UMAGetControlData					(ControlHandle 			inControl,
								 ControlPartCode 		inPart,
								 ResType 				inTagName,
								 Size 					inBufferSize,
								 Ptr 					outBuffer,
								 Size *					outActualSize) ;
OSErr UMAGetControlDataSize				(ControlHandle 			inControl,
								 ControlPartCode 		inPart,
								 ResType 				inTagName,
								 Size *					outMaxSize);


// system 8.0

short 		UMAFindWindow( Point inPoint , WindowRef *outWindow ) ;
OSStatus 	UMAGetWindowFeatures( WindowRef inWindowRef , UInt32 *outFeatures ) ;
OSStatus 	UMAGetWindowRegion( WindowRef inWindowRef , WindowRegionCode inRegionCode , RgnHandle ioWinRgn ) ;
OSStatus 	UMACollapseWindow( WindowRef inWindowRef , Boolean inCollapseIt ) ;
OSStatus 	UMACollapseAllWindows( Boolean inCollapseEm ) ;
Boolean 	UMAIsWindowCollapsed( WindowRef inWindowRef ) ;
Boolean UMAIsWindowCollapsable( WindowRef inWindowRef ) ;

// system 8.5

OSStatus 	UMACreateNewWindow( WindowClass windowClass , WindowAttributes attributes , const Rect *bounds,  WindowRef *outWindow ) ;
OSStatus 	UMAGetWindowClass( WindowRef inWindowRef , WindowClass *outWindowClass ) ;
OSStatus	UMAGetWindowAttributes( WindowRef inWindowRef , WindowAttributes *outAttributes ) ;

void 			UMAShowFloatingWindows() ;
void 			UMAHideFloatingWindows() ;
Boolean 	UMAAreFloatingWindowsVisible() ;
WindowRef UMAFrontWindow() ;
WindowRef UMAFrontNonFloatingWindow() ;

// floaters support

bool			UMAIsWindowFloating( WindowRef inWindow ) ;
bool			UMAIsWindowModal( WindowRef inWindow ) ;
WindowRef UMAGetActiveWindow() ;
WindowRef UMAGetActiveNonFloatingWindow() ;

void UMAHighlightAndActivateWindow( WindowRef inWindowRef , bool inActivate ) ;


#endif
Commit	Line	Data
cfcc3671 UJ	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: uma.h
	3	// Purpose: Universal MacOS API
	4	// Author: Stefan Csomor
	5	// Modified by:
	6	// Created: 03/02/99
	7	// RCS-ID: $Id:
	8	// Copyright: (c) Stefan Csomor
	9	// Licence: LGPL licence
	10	/////////////////////////////////////////////////////////////////////////////
	11
	12	#ifndef H_UMA
	13	#define H_UMA
	14
	15	// define this to be 1 if you have the 8.6 libs (weak linked)
	16
	17	#define UMA_USE_8_6 0
	18
	19	// define this to be 1 if you have the carbon libs (weak linked or PreCarbon.lib)
	20
	21	#define UMA_USE_CARBON 0
	22
	23	#define UMA_USE_APPEARANCE 1
	24	#define UMA_USE_WINDOWMGR 1
	25
	26	#if !UMA_USE_8_6 && UMA_USE_WINDOWMGR
	27	#undef UMA_USE_WINDOWMGR
	28	#define UMA_USE_WINDOWMGR 0
	29	#endif
	30
	31	#if !TARGET_CARBON
	32	typedef short MenuItemIndex ;
	33	#endif
	34
	35	void UMAInitToolbox( UInt16 inMoreMastersCalls) ;
	36	bool UMAHasAppearance() ;
	37	long UMAGetAppearanceVersion() ;
	38
	39	// process manager
	40
	41	long UMAGetProcessMode() ;
	42	bool UMAGetProcessModeDoesActivateOnFGSwitch() ;
	43
	44	// menu manager
	45
	46	void UMASetMenuTitle( MenuRef menu , ConstStr255Param title ) ;
	47	UInt32 UMAMenuEvent( EventRecord *inEvent ) ;
	48	void UMAEnableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;
	49	void UMADisableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;
	50	// quickdraw
	51
	52	void UMAShowWatchCursor() ;
	53	void UMAShowArrowCursor() ;
	54
	55	// window manager
	56
	57	GrafPtr UMAGetWindowPort( WindowRef inWindowRef ) ;
	58	void UMADisposeWindow( WindowRef inWindowRef ) ;
	59	void UMASetWTitleC( WindowRef inWindowRef , const char *title ) ;
	60	void UMAGetWTitleC( WindowRef inWindowRef , char *title ) ;
	61
	62	void UMADrawGrowIcon( WindowRef inWindowRef ) ;
	63	void UMAShowWindow( WindowRef inWindowRef ) ;
	64	void UMAHideWindow( WindowRef inWindowRef ) ;
65	void UMAShowHide( WindowRef inWindowRef , Boolean show) ;
66	void UMASelectWindow( WindowRef inWindowRef ) ;
67	void UMABringToFront( WindowRef inWindowRef ) ;
68	void UMASendBehind( WindowRef inWindowRef , WindowRef behindWindow ) ;
69	void UMACloseWindow(WindowRef inWindowRef) ;
70
71	// appearance manager
72
73	void UMADrawControl( ControlHandle inControl ) ;
74
75	void UMAActivateControl( ControlHandle inControl ) ;
76	void UMADeactivateControl( ControlHandle inControl ) ;
77	void UMASetThemeWindowBackground (WindowRef inWindow,
78	ThemeBrush inBrush,
79	Boolean inUpdate) ;
80	ControlHandle UMANewControl(WindowPtr owningWindow,
81	const Rect * boundsRect,
82	ConstStr255Param controlTitle,
83	Boolean initiallyVisible,
84	SInt16 initialValue,
85	SInt16 minimumValue,
86	SInt16 maximumValue,
87	SInt16 procID,
88	SInt32 controlReference) ;
89	void UMADisposeControl (ControlHandle theControl) ;
90	void UMAHiliteControl (ControlHandle theControl,
91	ControlPartCode hiliteState) ;
92	void UMAShowControl (ControlHandle theControl) ;
93	void UMAHideControl (ControlHandle theControl);
94	void UMASetControlVisibility (ControlHandle inControl,
95	Boolean inIsVisible,
96	Boolean inDoDraw);
97
98	bool UMAIsControlActive (ControlHandle inControl);
99	bool UMAIsControlVisible (ControlHandle inControl);
100	void UMAActivateControl (ControlHandle inControl);
101	void UMADeactivateControl (ControlHandle inControl);
102
103	OSErr UMAGetBestControlRect (ControlHandle inControl,
104	Rect * outRect,
105	SInt16 * outBaseLineOffset);
106	OSErr UMASetControlFontStyle (ControlHandle inControl,
107	const ControlFontStyleRec * inStyle) ;
108
109
110	void UMAMoveControl( ControlHandle inControl , short x , short y ) ;
111	void UMASizeControl( ControlHandle inControl , short x , short y ) ;
112	// control hierarchy
113
114	OSErr UMACreateRootControl (WindowPtr inWindow,
115	ControlHandle * outControl) ;
116
117	OSErr UMAEmbedControl (ControlHandle inControl,
118	ControlHandle inContainer);
119
120	// keyboard focus
121	OSErr UMASetKeyboardFocus (WindowPtr inWindow,
122	ControlHandle inControl,
123	ControlFocusPart inPart) ;
124
125
126	// events
127
128	ControlPartCode UMAHandleControlClick (ControlHandle inControl,
129	Point inWhere,
130	SInt16 inModifiers,
131	ControlActionUPP inAction) ;
132	SInt16 UMAHandleControlKey (ControlHandle inControl,
133	SInt16 inKeyCode,
134	SInt16 inCharCode,
135	SInt16 inModifiers);
136
137	void UMAIdleControls (WindowPtr inWindow) ;
138
139	void UMAUpdateControls( WindowPtr inWindow , RgnHandle inRgn ) ;
140	OSErr UMAGetRootControl( WindowPtr inWindow , ControlHandle *outControl ) ;
141
142	// handling control data
143
144	OSErr UMASetControlData (ControlHandle inControl,
145	ControlPartCode inPart,
146	ResType inTagName,
147	Size inSize,
148	Ptr inData) ;
149
150	OSErr UMAGetControlData (ControlHandle inControl,
151	ControlPartCode inPart,
152	ResType inTagName,
153	Size inBufferSize,
154	Ptr outBuffer,
155	Size * outActualSize) ;
156	OSErr UMAGetControlDataSize (ControlHandle inControl,
157	ControlPartCode inPart,
158	ResType inTagName,
159	Size * outMaxSize);
160
161
162	// system 8.0
163
164	short UMAFindWindow( Point inPoint , WindowRef *outWindow ) ;
165	OSStatus UMAGetWindowFeatures( WindowRef inWindowRef , UInt32 *outFeatures ) ;
166	OSStatus UMAGetWindowRegion( WindowRef inWindowRef , WindowRegionCode inRegionCode , RgnHandle ioWinRgn ) ;
167	OSStatus UMACollapseWindow( WindowRef inWindowRef , Boolean inCollapseIt ) ;
168	OSStatus UMACollapseAllWindows( Boolean inCollapseEm ) ;
169	Boolean UMAIsWindowCollapsed( WindowRef inWindowRef ) ;
170	Boolean UMAIsWindowCollapsable( WindowRef inWindowRef ) ;
171
172	// system 8.5
173
174	OSStatus UMACreateNewWindow( WindowClass windowClass , WindowAttributes attributes , const Rect bounds, WindowRef outWindow ) ;
175	OSStatus UMAGetWindowClass( WindowRef inWindowRef , WindowClass *outWindowClass ) ;
176	OSStatus UMAGetWindowAttributes( WindowRef inWindowRef , WindowAttributes *outAttributes ) ;
177
178	void UMAShowFloatingWindows() ;
179	void UMAHideFloatingWindows() ;
180	Boolean UMAAreFloatingWindowsVisible() ;
181	WindowRef UMAFrontWindow() ;
182	WindowRef UMAFrontNonFloatingWindow() ;
183
184	// floaters support
185
186	bool UMAIsWindowFloating( WindowRef inWindow ) ;
187	bool UMAIsWindowModal( WindowRef inWindow ) ;
188	WindowRef UMAGetActiveWindow() ;
189	WindowRef UMAGetActiveNonFloatingWindow() ;
190
191	void UMAHighlightAndActivateWindow( WindowRef inWindowRef , bool inActivate ) ;
192
193
194	#endif