[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:   	wxWindows 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 

#if TARGET_CARBON
#undef UMA_USE_8_6
#define UMA_USE_8_6 1 
#endif

#if defined(__POWERPC__) || defined(__APPLE__)
    #define UMA_USE_APPEARANCE 1
    #define UMA_USE_WINDOWMGR 1
    #if defined(__APPLE__)
        #include <Carbon/Carbon.h>
    #endif
#else
    #define UMA_USE_APPEARANCE 0
    #define UMA_USE_WINDOWMGR 0
#endif

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

#if !TARGET_CARBON
//  this is now defined in the latest headers
//	typedef short MenuItemIndex  ;
#endif

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

// process manager

long UMAGetProcessMode() ;
bool UMAGetProcessModeDoesActivateOnFGSwitch() ;

// menu manager

void 			UMASetMenuTitle( MenuRef menu , StringPtr title ) ;
UInt32 			UMAMenuEvent( EventRecord *inEvent ) ;
void 			UMAEnableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;	
void 			UMADisableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;	
void			UMAAppendSubMenuItem( MenuRef menu , StringPtr label , SInt16 submenuid ) ;
void			UMAInsertSubMenuItem( MenuRef menu , StringPtr label , MenuItemIndex item , SInt16 submenuid  ) ;
void			UMAAppendMenuItem( MenuRef menu , StringPtr label , SInt16 key= 0, UInt8 modifiers = 0 ) ;
void			UMAInsertMenuItem( MenuRef menu , StringPtr label , MenuItemIndex item , SInt16 key = 0 , UInt8 modifiers = 0 ) ;
void			UMASetMenuItemText( MenuRef menu , MenuItemIndex item , StringPtr label ) ;

MenuRef			UMANewMenu( SInt16 menuid , StringPtr label ) ;
void 			UMADisposeMenu( MenuRef menu ) ;

// handling the menubar

void			UMADeleteMenu( SInt16 menuId ) ;
void			UMAInsertMenu( MenuRef insertMenu , SInt16 afterId ) ;
void			UMADrawMenuBar() ;

// quickdraw

void			UMAShowWatchCursor() ;
void			UMAShowArrowCursor() ;

OSStatus		UMAPrOpen() ;
OSStatus		UMAPrClose() ;

// 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			UMAApplyThemeBackground			(ThemeBackgroundKind 	inKind,
								 const Rect *			bounds,
								 ThemeDrawState 		inState,
								 SInt16 				inDepth,
								 Boolean 				inColorDev);
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 ) ;

#if !TARGET_CARBON
#define GetPortTextFont( p) ((p)->txFont )
#define GetPortTextSize( p) ((p)->txSize )
#define GetPortTextFace( p) ((p)->txFace )
#define GetPortTextMode( p) ((p)->txMode )
#define GetRegionBounds( r , b) ((*b) = (**r).rgnBBox)
#define GetPortBounds( p , b) ((*b) = p->portRect )
#define GetWindowPortBounds( p , b) ((*b) = p->portRect )
#define	GetPortVisibleRegion( p, r ) CopyRgn( p->visRgn , r )
#define GetQDGlobalsWhite( a ) (&((*a) = qd.white))
#define GetQDGlobalsBlack( a ) (&((*a) = qd.black))
#define GetQDGlobalsScreenBits( a ) (*a) = qd.screenBits
#define GetQDGlobalsArrow( a ) (&((*a) = qd.arrow))
#define GetControlBounds( c , b ) ((*b) = (**c).contrlRect )
#define GetPortBitMapForCopyBits( p ) ((BitMap*) &(((CGrafPtr)p)->portPixMap ))
#endif

// Appearance Drawing

OSStatus UMADrawThemePlacard( const Rect *inRect , ThemeDrawState inState ) ;

#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
292d1a2f	9	// Licence: wxWindows licence
cfcc3671 UJ	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
5b781a67 SC	19	#if TARGET_CARBON
	20	#undef UMA_USE_8_6
	21	#define UMA_USE_8_6 1
	22	#endif
	23
03e11df5 GD	24	#if defined(__POWERPC__) \|\| defined(__APPLE__)
	25	#define UMA_USE_APPEARANCE 1
	26	#define UMA_USE_WINDOWMGR 1
	27	#if defined(__APPLE__)
	28	#include <Carbon/Carbon.h>
	29	#endif
05adb9d2	30	#else
03e11df5 GD	31	#define UMA_USE_APPEARANCE 0
03e11df5 GD	32	#define UMA_USE_WINDOWMGR 0
05adb9d2	33	#endif
cfcc3671 UJ	34
	35	#if !UMA_USE_8_6 && UMA_USE_WINDOWMGR
	36	#undef UMA_USE_WINDOWMGR
	37	#define UMA_USE_WINDOWMGR 0
	38	#endif
	39
	40	#if !TARGET_CARBON
05adb9d2 SC	41	// this is now defined in the latest headers
05adb9d2 SC	42	// typedef short MenuItemIndex ;
cfcc3671 UJ	43	#endif
	44
	45	void UMAInitToolbox( UInt16 inMoreMastersCalls) ;
5b781a67	46	void UMACleanupToolbox() ;
cfcc3671 UJ	47	bool UMAHasAppearance() ;
	48	long UMAGetAppearanceVersion() ;
	49
	50	// process manager
	51
	52	long UMAGetProcessMode() ;
	53	bool UMAGetProcessModeDoesActivateOnFGSwitch() ;
	54
	55	// menu manager
	56
05adb9d2 SC	57	void UMASetMenuTitle( MenuRef menu , StringPtr title ) ;
05adb9d2 SC	58	UInt32 UMAMenuEvent( EventRecord *inEvent ) ;
cfcc3671 UJ	59	void UMAEnableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;
cfcc3671 UJ	60	void UMADisableMenuItem( MenuRef inMenu , MenuItemIndex item ) ;
05adb9d2 SC	61	void UMAAppendSubMenuItem( MenuRef menu , StringPtr label , SInt16 submenuid ) ;
	62	void UMAInsertSubMenuItem( MenuRef menu , StringPtr label , MenuItemIndex item , SInt16 submenuid ) ;
	63	void UMAAppendMenuItem( MenuRef menu , StringPtr label , SInt16 key= 0, UInt8 modifiers = 0 ) ;
	64	void UMAInsertMenuItem( MenuRef menu , StringPtr label , MenuItemIndex item , SInt16 key = 0 , UInt8 modifiers = 0 ) ;
	65	void UMASetMenuItemText( MenuRef menu , MenuItemIndex item , StringPtr label ) ;
	66
	67	MenuRef UMANewMenu( SInt16 menuid , StringPtr label ) ;
	68	void UMADisposeMenu( MenuRef menu ) ;
	69
	70	// handling the menubar
	71
	72	void UMADeleteMenu( SInt16 menuId ) ;
	73	void UMAInsertMenu( MenuRef insertMenu , SInt16 afterId ) ;
	74	void UMADrawMenuBar() ;
	75
cfcc3671 UJ	76	// quickdraw
	77
	78	void UMAShowWatchCursor() ;
	79	void UMAShowArrowCursor() ;
	80
5b781a67 SC	81	OSStatus UMAPrOpen() ;
5b781a67 SC	82	OSStatus UMAPrClose() ;
05adb9d2	83
cfcc3671 UJ	84	// window manager
	85
	86	GrafPtr UMAGetWindowPort( WindowRef inWindowRef ) ;
	87	void UMADisposeWindow( WindowRef inWindowRef ) ;
	88	void UMASetWTitleC( WindowRef inWindowRef , const char *title ) ;
	89	void UMAGetWTitleC( WindowRef inWindowRef , char *title ) ;
	90
	91	void UMADrawGrowIcon( WindowRef inWindowRef ) ;
	92	void UMAShowWindow( WindowRef inWindowRef ) ;
	93	void UMAHideWindow( WindowRef inWindowRef ) ;
	94	void UMAShowHide( WindowRef inWindowRef , Boolean show) ;
	95	void UMASelectWindow( WindowRef inWindowRef ) ;
	96	void UMABringToFront( WindowRef inWindowRef ) ;
	97	void UMASendBehind( WindowRef inWindowRef , WindowRef behindWindow ) ;
	98	void UMACloseWindow(WindowRef inWindowRef) ;
	99
	100	// appearance manager
	101
	102	void UMADrawControl( ControlHandle inControl ) ;
	103
	104	void UMAActivateControl( ControlHandle inControl ) ;
	105	void UMADeactivateControl( ControlHandle inControl ) ;
05adb9d2 SC	106	void UMAApplyThemeBackground (ThemeBackgroundKind inKind,
	107	const Rect * bounds,
	108	ThemeDrawState inState,
	109	SInt16 inDepth,
	110	Boolean inColorDev);
cfcc3671 UJ	111	void UMASetThemeWindowBackground (WindowRef inWindow,
	112	ThemeBrush inBrush,
	113	Boolean inUpdate) ;
	114	ControlHandle UMANewControl(WindowPtr owningWindow,
	115	const Rect * boundsRect,
	116	ConstStr255Param controlTitle,
	117	Boolean initiallyVisible,
	118	SInt16 initialValue,
	119	SInt16 minimumValue,
	120	SInt16 maximumValue,
	121	SInt16 procID,
	122	SInt32 controlReference) ;
	123	void UMADisposeControl (ControlHandle theControl) ;
	124	void UMAHiliteControl (ControlHandle theControl,
	125	ControlPartCode hiliteState) ;
	126	void UMAShowControl (ControlHandle theControl) ;
	127	void UMAHideControl (ControlHandle theControl);
	128	void UMASetControlVisibility (ControlHandle inControl,
	129	Boolean inIsVisible,
	130	Boolean inDoDraw);
	131
	132	bool UMAIsControlActive (ControlHandle inControl);
	133	bool UMAIsControlVisible (ControlHandle inControl);
	134	void UMAActivateControl (ControlHandle inControl);
	135	void UMADeactivateControl (ControlHandle inControl);
	136
	137	OSErr UMAGetBestControlRect (ControlHandle inControl,
	138	Rect * outRect,
	139	SInt16 * outBaseLineOffset);
	140	OSErr UMASetControlFontStyle (ControlHandle inControl,
	141	const ControlFontStyleRec * inStyle) ;
	142
	143
	144	void UMAMoveControl( ControlHandle inControl , short x , short y ) ;
	145	void UMASizeControl( ControlHandle inControl , short x , short y ) ;
	146	// control hierarchy
	147
	148	OSErr UMACreateRootControl (WindowPtr inWindow,
	149	ControlHandle * outControl) ;
	150
	151	OSErr UMAEmbedControl (ControlHandle inControl,
	152	ControlHandle inContainer);
	153
	154	// keyboard focus
	155	OSErr UMASetKeyboardFocus (WindowPtr inWindow,
	156	ControlHandle inControl,
	157	ControlFocusPart inPart) ;
	158
	159
	160	// events
	161
	162	ControlPartCode UMAHandleControlClick (ControlHandle inControl,
	163	Point inWhere,
	164	SInt16 inModifiers,
	165	ControlActionUPP inAction) ;
	166	SInt16 UMAHandleControlKey (ControlHandle inControl,
	167	SInt16 inKeyCode,
	168	SInt16 inCharCode,
	169	SInt16 inModifiers);
	170
	171	void UMAIdleControls (WindowPtr inWindow) ;
	172
	173	void UMAUpdateControls( WindowPtr inWindow , RgnHandle inRgn ) ;
	174	OSErr UMAGetRootControl( WindowPtr inWindow , ControlHandle *outControl ) ;
175
176	// handling control data
177
178	OSErr UMASetControlData (ControlHandle inControl,
179	ControlPartCode inPart,
180	ResType inTagName,
181	Size inSize,
182	Ptr inData) ;
183
184	OSErr UMAGetControlData (ControlHandle inControl,
185	ControlPartCode inPart,
186	ResType inTagName,
187	Size inBufferSize,
188	Ptr outBuffer,
189	Size * outActualSize) ;
190	OSErr UMAGetControlDataSize (ControlHandle inControl,
191	ControlPartCode inPart,
192	ResType inTagName,
193	Size * outMaxSize);
194
195
196	// system 8.0
197
198	short UMAFindWindow( Point inPoint , WindowRef *outWindow ) ;
199	OSStatus UMAGetWindowFeatures( WindowRef inWindowRef , UInt32 *outFeatures ) ;
200	OSStatus UMAGetWindowRegion( WindowRef inWindowRef , WindowRegionCode inRegionCode , RgnHandle ioWinRgn ) ;
201	OSStatus UMACollapseWindow( WindowRef inWindowRef , Boolean inCollapseIt ) ;
202	OSStatus UMACollapseAllWindows( Boolean inCollapseEm ) ;
203	Boolean UMAIsWindowCollapsed( WindowRef inWindowRef ) ;
204	Boolean UMAIsWindowCollapsable( WindowRef inWindowRef ) ;
205
206	// system 8.5
207
208	OSStatus UMACreateNewWindow( WindowClass windowClass , WindowAttributes attributes , const Rect bounds, WindowRef outWindow ) ;
209	OSStatus UMAGetWindowClass( WindowRef inWindowRef , WindowClass *outWindowClass ) ;
210	OSStatus UMAGetWindowAttributes( WindowRef inWindowRef , WindowAttributes *outAttributes ) ;
211
212	void UMAShowFloatingWindows() ;
213	void UMAHideFloatingWindows() ;
214	Boolean UMAAreFloatingWindowsVisible() ;
215	WindowRef UMAFrontWindow() ;
216	WindowRef UMAFrontNonFloatingWindow() ;
217
218	// floaters support
219
220	bool UMAIsWindowFloating( WindowRef inWindow ) ;
221	bool UMAIsWindowModal( WindowRef inWindow ) ;
222	WindowRef UMAGetActiveWindow() ;
223	WindowRef UMAGetActiveNonFloatingWindow() ;
224
225	void UMAHighlightAndActivateWindow( WindowRef inWindowRef , bool inActivate ) ;
226
05adb9d2 SC	227	#if !TARGET_CARBON
	228	#define GetPortTextFont( p) ((p)->txFont )
	229	#define GetPortTextSize( p) ((p)->txSize )
	230	#define GetPortTextFace( p) ((p)->txFace )
	231	#define GetPortTextMode( p) ((p)->txMode )
	232	#define GetRegionBounds( r , b) ((b) = (*r).rgnBBox)
	233	#define GetPortBounds( p , b) ((*b) = p->portRect )
	234	#define GetWindowPortBounds( p , b) ((*b) = p->portRect )
	235	#define GetPortVisibleRegion( p, r ) CopyRgn( p->visRgn , r )
	236	#define GetQDGlobalsWhite( a ) (&((*a) = qd.white))
	237	#define GetQDGlobalsBlack( a ) (&((*a) = qd.black))
	238	#define GetQDGlobalsScreenBits( a ) (*a) = qd.screenBits
	239	#define GetQDGlobalsArrow( a ) (&((*a) = qd.arrow))
	240	#define GetControlBounds( c , b ) ((b) = (*c).contrlRect )
	241	#define GetPortBitMapForCopyBits( p ) ((BitMap*) &(((CGrafPtr)p)->portPixMap ))
	242	#endif
	243
	244	// Appearance Drawing
	245
	246	OSStatus UMADrawThemePlacard( const Rect *inRect , ThemeDrawState inState ) ;
cfcc3671	247
03e11df5	248	#endif