123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652 |
- { CoreGraphics - CGRemoteOperation.h
- Copyright (c) 2000-2011 Apple Inc.
- All rights reserved. }
- { Pascal Translation Updated: Peter N Lewis, <[email protected]>, August 2005 }
- { Pascal Translation Updated: Jonas Maebe, <[email protected]>, October 2009 }
- { Pascal Translation Updated: Jonas Maebe, <[email protected]>, October 2012 }
- {
- Modified for use with Free Pascal
- Version 308
- Please report any bugs to <[email protected]>
- }
- {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
- {$mode macpas}
- {$packenum 1}
- {$macro on}
- {$inline on}
- {$calling mwpascal}
- unit CGRemoteOperation;
- interface
- {$setc UNIVERSAL_INTERFACES_VERSION := $0400}
- {$setc GAP_INTERFACES_VERSION := $0308}
- {$ifc not defined USE_CFSTR_CONSTANT_MACROS}
- {$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
- {$endc}
- {$ifc defined CPUPOWERPC and defined CPUI386}
- {$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
- {$endc}
- {$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
- {$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
- {$endc}
- {$ifc not defined __ppc__ and defined CPUPOWERPC32}
- {$setc __ppc__ := 1}
- {$elsec}
- {$setc __ppc__ := 0}
- {$endc}
- {$ifc not defined __ppc64__ and defined CPUPOWERPC64}
- {$setc __ppc64__ := 1}
- {$elsec}
- {$setc __ppc64__ := 0}
- {$endc}
- {$ifc not defined __i386__ and defined CPUI386}
- {$setc __i386__ := 1}
- {$elsec}
- {$setc __i386__ := 0}
- {$endc}
- {$ifc not defined __x86_64__ and defined CPUX86_64}
- {$setc __x86_64__ := 1}
- {$elsec}
- {$setc __x86_64__ := 0}
- {$endc}
- {$ifc not defined __arm__ and defined CPUARM}
- {$setc __arm__ := 1}
- {$elsec}
- {$setc __arm__ := 0}
- {$endc}
- {$ifc defined cpu64}
- {$setc __LP64__ := 1}
- {$elsec}
- {$setc __LP64__ := 0}
- {$endc}
- {$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
- {$error Conflicting definitions for __ppc__ and __i386__}
- {$endc}
- {$ifc defined __ppc__ and __ppc__}
- {$setc TARGET_CPU_PPC := TRUE}
- {$setc TARGET_CPU_PPC64 := FALSE}
- {$setc TARGET_CPU_X86 := FALSE}
- {$setc TARGET_CPU_X86_64 := FALSE}
- {$setc TARGET_CPU_ARM := FALSE}
- {$setc TARGET_OS_MAC := TRUE}
- {$setc TARGET_OS_IPHONE := FALSE}
- {$setc TARGET_IPHONE_SIMULATOR := FALSE}
- {$setc TARGET_OS_EMBEDDED := FALSE}
- {$elifc defined __ppc64__ and __ppc64__}
- {$setc TARGET_CPU_PPC := FALSE}
- {$setc TARGET_CPU_PPC64 := TRUE}
- {$setc TARGET_CPU_X86 := FALSE}
- {$setc TARGET_CPU_X86_64 := FALSE}
- {$setc TARGET_CPU_ARM := FALSE}
- {$setc TARGET_OS_MAC := TRUE}
- {$setc TARGET_OS_IPHONE := FALSE}
- {$setc TARGET_IPHONE_SIMULATOR := FALSE}
- {$setc TARGET_OS_EMBEDDED := FALSE}
- {$elifc defined __i386__ and __i386__}
- {$setc TARGET_CPU_PPC := FALSE}
- {$setc TARGET_CPU_PPC64 := FALSE}
- {$setc TARGET_CPU_X86 := TRUE}
- {$setc TARGET_CPU_X86_64 := FALSE}
- {$setc TARGET_CPU_ARM := FALSE}
- {$ifc defined(iphonesim)}
- {$setc TARGET_OS_MAC := FALSE}
- {$setc TARGET_OS_IPHONE := TRUE}
- {$setc TARGET_IPHONE_SIMULATOR := TRUE}
- {$elsec}
- {$setc TARGET_OS_MAC := TRUE}
- {$setc TARGET_OS_IPHONE := FALSE}
- {$setc TARGET_IPHONE_SIMULATOR := FALSE}
- {$endc}
- {$setc TARGET_OS_EMBEDDED := FALSE}
- {$elifc defined __x86_64__ and __x86_64__}
- {$setc TARGET_CPU_PPC := FALSE}
- {$setc TARGET_CPU_PPC64 := FALSE}
- {$setc TARGET_CPU_X86 := FALSE}
- {$setc TARGET_CPU_X86_64 := TRUE}
- {$setc TARGET_CPU_ARM := FALSE}
- {$setc TARGET_OS_MAC := TRUE}
- {$setc TARGET_OS_IPHONE := FALSE}
- {$setc TARGET_IPHONE_SIMULATOR := FALSE}
- {$setc TARGET_OS_EMBEDDED := FALSE}
- {$elifc defined __arm__ and __arm__}
- {$setc TARGET_CPU_PPC := FALSE}
- {$setc TARGET_CPU_PPC64 := FALSE}
- {$setc TARGET_CPU_X86 := FALSE}
- {$setc TARGET_CPU_X86_64 := FALSE}
- {$setc TARGET_CPU_ARM := TRUE}
- { will require compiler define when/if other Apple devices with ARM cpus ship }
- {$setc TARGET_OS_MAC := FALSE}
- {$setc TARGET_OS_IPHONE := TRUE}
- {$setc TARGET_IPHONE_SIMULATOR := FALSE}
- {$setc TARGET_OS_EMBEDDED := TRUE}
- {$elsec}
- {$error __ppc__ nor __ppc64__ nor __i386__ nor __x86_64__ nor __arm__ is defined.}
- {$endc}
- {$ifc defined __LP64__ and __LP64__ }
- {$setc TARGET_CPU_64 := TRUE}
- {$elsec}
- {$setc TARGET_CPU_64 := FALSE}
- {$endc}
- {$ifc defined FPC_BIG_ENDIAN}
- {$setc TARGET_RT_BIG_ENDIAN := TRUE}
- {$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
- {$elifc defined FPC_LITTLE_ENDIAN}
- {$setc TARGET_RT_BIG_ENDIAN := FALSE}
- {$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
- {$elsec}
- {$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
- {$endc}
- {$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
- {$setc CALL_NOT_IN_CARBON := FALSE}
- {$setc OLDROUTINENAMES := FALSE}
- {$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
- {$setc OPAQUE_UPP_TYPES := TRUE}
- {$setc OTCARBONAPPLICATION := TRUE}
- {$setc OTKERNEL := FALSE}
- {$setc PM_USE_SESSION_APIS := TRUE}
- {$setc TARGET_API_MAC_CARBON := TRUE}
- {$setc TARGET_API_MAC_OS8 := FALSE}
- {$setc TARGET_API_MAC_OSX := TRUE}
- {$setc TARGET_CARBON := TRUE}
- {$setc TARGET_CPU_68K := FALSE}
- {$setc TARGET_CPU_MIPS := FALSE}
- {$setc TARGET_CPU_SPARC := FALSE}
- {$setc TARGET_OS_UNIX := FALSE}
- {$setc TARGET_OS_WIN32 := FALSE}
- {$setc TARGET_RT_MAC_68881 := FALSE}
- {$setc TARGET_RT_MAC_CFM := FALSE}
- {$setc TARGET_RT_MAC_MACHO := TRUE}
- {$setc TYPED_FUNCTION_POINTERS := TRUE}
- {$setc TYPE_BOOL := FALSE}
- {$setc TYPE_EXTENDED := FALSE}
- {$setc TYPE_LONGLONG := TRUE}
- uses MacTypes,CFMachPort,CGBase,CGGeometry,CGErrors,CFDate;
- {$endc} {not MACOSALLINCLUDE}
- {$ALIGN POWER}
- type
- CGEventErr = CGError;
- const
- CGEventNoErr = kCGErrorSuccess;
- { A type representing the number of buttons being set in a synthetic mouse
- event. }
- type
- CGButtonCount = UInt32;
- { A type representing the number of scrolling devices being set in a
- synthetic scrolling event. }
- type
- CGWheelCount = UInt32;
- { A type representing a character generated by pressing one or more keys on
- a keyboard. }
- type
- CGCharCode = UInt16;
- { A type representing the virtual key codes used in keyboard events. }
- type
- CGKeyCode = UInt16;
- { A client-supplied callback function that’s invoked when an area of the
- display is modified or refreshed.
- When an area of the display is modified or refreshed, your callback
- function will be invoked with a count of the number of rectangles in the
- refreshed areas, and a list of the refreshed rectangles. The rectangles
- are in global coordinates.
- To register a screen refresh callback function, call the function
- `CGRegisterScreenRefreshCallback'. Quartz invokes your callback function
- when operations such as drawing, window movement, scrolling, or display
- reconfiguration occur on local displays. When you are finished using a
- callback registration, call `CGUnregisterScreenRefreshCallback' to remove
- it.
- Note that a single rectangle may occupy multiple displays, either by
- overlapping the displays or by residing on coincident displays when
- mirroring is active. You can use the function `CGGetDisplaysWithRect' to
- determine the displays a rectangle occupies. }
- type
- CGScreenRefreshCallback = procedure( count: UInt32; {const} rectArray: {variable-size-array} CGRectPtr; userParameter: UnivPtr);
- {$ifc TARGET_OS_MAC}
- { Register a callback function to be invoked when local displays are
- refreshed or modified.
- The callback function you register is invoked only if your application
- has an active event loop. The callback is invoked in the same thread of
- execution that is processing events within your application. }
- function CGRegisterScreenRefreshCallback( callback: CGScreenRefreshCallback; userInfo: UnivPtr ): CGError; external name '_CGRegisterScreenRefreshCallback';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0,__MAC_10_8,
- __IPHONE_NA, __IPHONE_NA) *)
- { Remove a previously registered callback function invoked when local
- displays are refreshed or modified.
- Both the callback function and the `userInfo' argument must match the
- registered entry to be removed. }
- procedure CGUnregisterScreenRefreshCallback( callback: CGScreenRefreshCallback; userInfo: UnivPtr ); external name '_CGUnregisterScreenRefreshCallback';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0,__MAC_10_8,
- __IPHONE_NA, __IPHONE_NA) *)
- { Wait for screen refresh operations.
- In some applications it may be preferable to wait for screen refresh data
- synchronously, using this function. You should call this function in a
- thread other than the main event-processing thread.
- As an alternative, Quartz also supports asynchronous notification --- see
- `CGRegisterScreenRefreshCallback'. If refresh callback functions are
- registered, this function should not be used.
- You must deallocate the returned rectangle array with the function
- `CGReleaseScreenRefreshRects'. }
- function CGWaitForScreenRefreshRects( var pRectArray: {variable-size-array} CGRectPtr; var count: UInt32 ): CGError; external name '_CGWaitForScreenRefreshRects';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0,__MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
- {$endc}
- { A type for `CGWaitForScreenUpdateRects' specifying the desired types of
- screen update operations. }
- const
- kCGScreenUpdateOperationRefresh = 0;
- kCGScreenUpdateOperationMove = 1 shl 0;
- kCGScreenUpdateOperationReducedDirtyRectangleCount = 1 shl 31;
- type
- CGScreenUpdateOperation = UInt32;
- { A type representing the distance a region on the screen moves in pixel
- units.
- The fields `dX' and `dY' describe the direction of movement. Positive
- values of `dX' indicate movement to the right; negative values indicate
- movement to the left. Positive values of `dY' indicate movement downward;
- negative values indicate movement upward. }
- type
- CGScreenUpdateMoveDelta = record
- dX, dY: SInt32;
- end;
- { A type specifying a client-supplied callback function that’s invoked when
- an area of the display is moved.
- When an area of the display is moved, your callback function will be
- invoked with a count of the number of rectangles in the moved area, and a
- list of the moved rectangles. The rectangles are in global coordinates,
- and describe the area prior to the move operation.
- Your function should not modify, deallocate or free memory pointed to by
- `rectArray'.
- A single rectangle may occupy multiple displays, either by overlapping
- the displays or by residing on coincident displays when mirroring is
- active. Use `CGGetDisplaysWithRect' to determine the displays a rectangle
- occupies. }
- type
- CGScreenUpdateMoveCallback = procedure( delta: CGScreenUpdateMoveDelta; count: size_t; {const} rectArray: {variable-size-array} CGRectPtr; userParameter: UnivPtr );
- {$ifc TARGET_OS_MAC}
- { Register a callback function to be invoked when an area of the display is
- moved. The callback is invoked on the same thread of execution that is
- processing events within your application. }
- function CGScreenRegisterMoveCallback( callback: CGScreenUpdateMoveCallback; userInfo: UnivPtr ): CGError; external name '_CGScreenRegisterMoveCallback';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_3,__MAC_10_8,
- __IPHONE_NA, __IPHONE_NA) *)
- { Remove a previously registered screen update callback function. }
- procedure CGScreenUnregisterMoveCallback( callback: CGScreenUpdateMoveCallback; userInfo: UnivPtr ); external name '_CGScreenUnregisterMoveCallback';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_3,__MAC_10_8,
- __IPHONE_NA, __IPHONE_NA) *)
- { Wait for screen update operations.
- The parameter `requestedOperations' specifies the desired types of screen
- update operations. There are several possible choices:
- -- Specify `kCGScreenUpdateOperationRefresh' if you want all move
- operations to be returned as refresh operations.
- -- Specify `(kCGScreenUpdateOperationRefresh|kCGScreenUpdateOperationMove)'
- if you want to distinguish between move and refresh operations.
- -- Add `kCGScreenUpdateOperationReducedDirtyRectangleCount' to the screen
- operations if you want to minimize the number of rectangles returned
- to represent changed areas of the display.
- You should deallocate the returned screen update rects by calling
- `CGReleaseScreenRefreshRects'.
- In some applications it may be preferable to wait for screen update data
- synchronously. You should call this function in a thread other than the
- main event-processing thread.
- As an alternative, Quartz also supports asynchronous notification --- see
- `CGRegisterScreenRefreshCallback' and `CGScreenRegisterMoveCallback'. If
- refresh or move callback functions are registered, this function should
- not be used. }
- function CGWaitForScreenUpdateRects( requestedOperations: CGScreenUpdateOperation; var currentOperation: CGScreenUpdateOperation; var pRectArray: {variable-size-array} CGRectPtr; var pCount: size_t; var pDelta: CGScreenUpdateMoveDelta ): CGError; external name '_CGWaitForScreenUpdateRects';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_3,__MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
- { Deallocate the list of rectangles received from
- `CGWaitForScreenRefreshRects' or `CGWaitForScreenUpdateRects'. }
- procedure CGReleaseScreenRefreshRects( pRectArray: {variable-size-array} CGRectPtr); external name '_CGReleaseScreenRefreshRects';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0,__MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
- { Return true if the mouse cursor is visible, false otherwise. }
- function CGCursorIsVisible: boolean_t; external name '_CGCursorIsVisible';
- (* CG_AVAILABLE_STARTING(__MAC_10_3, __IPHONE_NA) *)
- { Return true if the mouse cursor is drawn in frame buffer memory, false
- otherwise. (The cursor could exist in an overlay plane or a similar
- mechanism that puts pixels on-screen without altering frame buffer
- content.) If the cursor is drawn in the frame buffer, it is read back
- along with window data.
- The return value is based on the union of the state of the cursor on all
- displays. If the cursor is drawn in the frame buffer on any display, this
- function returns true. }
- function CGCursorIsDrawnInFramebuffer: boolean_t; external name '_CGCursorIsDrawnInFramebuffer';
- (* CG_AVAILABLE_STARTING(__MAC_10_3, __IPHONE_NA) *)
- { Move the mouse cursor to the desired position in global display
- coordinates without generating events. }
- function CGWarpMouseCursorPosition( newCursorPosition: CGPoint ): CGError; external name '_CGWarpMouseCursorPosition';
- (* CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
- { After posting a left mouse down with remote mouse drag suppressing
- hardware mouse move events, after some time with no remote mouse drag
- events a warning is logged to aid in diagnosing "my hardware mouse is
- dead" problems.
- Mouse-down conditions of arbitrary length may be produced deliberately,
- as when scrolling through a lengthly document. }
- {$endc}
- const
- kCGMouseDownEventMaskingDeadSwitchTimeout = 60.0;
- {$ifc TARGET_OS_MAC}
- { Connect or disconnect the mouse and cursor while an application is in the
- foreground.
- When you call this function to disconnect the cursor and mouse, all
- events received by your application have a constant absolute location but
- contain mouse delta (change in X and Y) data. You may hide the cursor or
- change it into something appropriate for your application. You can
- reposition the cursor by using the function `CGDisplayMoveCursorToPoint'
- or `CGWarpMouseCursorPosition'. }
- function CGAssociateMouseAndMouseCursorPosition( connected: boolean_t ): CGError; external name '_CGAssociateMouseAndMouseCursorPosition';
- (* CG_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_NA) *)
- { Return a CFMachPort that corresponds to the Mac OS X Window Server's
- server port.
- Use this function to detect if the window server process exits or is not
- running. If this function returns NULL, the window server is not running.
- This code example shows how to register a callback function to detect
- when the window server exits:
- static void handleWindowServerDeath(CFMachPortRef port, void *info) (
- printf("Window Server port death detected!\n");
- CFRelease(port);
- exit(1);
- )
- static void watchForServerDeath() (
- CFMachPortRef port = CGWindowServerCreateServerPort();
- CFMachPortSetInvalidationCallBack(port, handleWindowServerDeath);
- )
- Note that when the window server exits, there may be a few seconds during
- which no window server is running. This function will return NULL until a
- new window server is running.
- Your program must run a CFRunLoop for the port death callback to occur. A
- program which does not use a CFRunLoop may periodically call
- `CFMachPortIsValid' to check whether the port is valid. }
- function CGWindowServerCreateServerPort: CFMachPortRef; external name '_CGWindowServerCreateServerPort';
- (* CG_AVAILABLE_STARTING(__MAC_10_8, __IPHONE_NA) *)
- {
- * By default, the flags that indicate modifier key state (Command, Alt, Shift, etc.)
- * from the system's keyboard and from other event sources are ORed together as an event is
- * posted into the system, and current key and mouse button state is considered in generating new events.
- * This function allows your application to enable or disable the
- * merging of event state. When combining is turned off, the event state propagated in the events
- * posted by your app reflect state built up only by your app. The state within your app's generated
- * event will not be combined with the system's current state, so the system-wide state reflecting key
- * and mouse button state will remain unchanged
- *
- * When called with doCombineState equal to FALSE, this function initializes local (per application)
- * state tracking information to a state of all keys, modifiers, and mouse buttons up.
- *
- * When called with doCombineState equal to TRUE, the current global state of keys, modifiers,
- * and mouse buttons are used in generating events.
- }
- { This function is obsolete. Use Quartz events and Quartz event sources
- instead. }
- function CGEnableEventStateCombining( combineState: boolean_t ): CGError; external name '_CGEnableEventStateCombining';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_1, __MAC_10_6,
- __IPHONE_NA, __IPHONE_NA) *)
- {
- * Remote operation may want to inhibit local events (events from
- * the machine's keyboard and mouse). This may be done either as a
- * explicit request (tracked per app) or as a short term side effect of
- * posting an event.
- *
- * CGInhibitLocalEvents() is typically used for long term remote operation
- * of a system, as in automated system testing or telecommuting applications.
- * Local device state changes are discarded.
- *
- * Local event inhibition is turned off if the app that requested it terminates.
- }
- { This function obsolete. Use
- `CGEventSourceSetLocalEventsFilterDuringSuppressionState' instead. }
- function CGInhibitLocalEvents( inhibit: boolean_t ): CGError; external name '_CGInhibitLocalEvents';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_6,
- __IPHONE_NA, __IPHONE_NA) *)
- { This function is obsolete. Use `CGEventCreateMouseEvent' instead.
- Synthesize a low-level mouse-button event on the local machine.
- The parameter `mouseCursorPosition' specifies the new coordinates of the
- mouse in global display space.
- Pass true for `updateMouseCursorPosition' if the on-screen cursor should
- be moved to the location specified in the `mouseCursorPosition'
- parameter; otherwise, pass false.
-
- The parameter `buttonCount' specifies the number of mouse buttons, up to
- a maximum of 32.
- Pass true for `mouseButtonDown' to specify that the primary or left mouse
- button is down; otherwise, pass false. The remaining parameters are
- Boolean values that specify whether the remaining mouse buttons are down
- (true) or up (false). The second value, if any, should specify the state
- of the secondary mouse button (right). A third value should specify the
- state of the center button, and the remaining buttons should be in USB
- device order.
- Based on the values entered, the appropriate mouse-down, mouse-up,
- mouse-move, or mouse-drag events are generated, by comparing the new
- state with the current state. }
- function CGPostMouseEvent( mouseCursorPosition: CGPoint; updateMouseCursorPosition: boolean_t; buttonCount: CGButtonCount; mouseButtonDown: boolean_t; ... ): CGError; external name '_CGPostMouseEvent';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_6,
- __IPHONE_NA, __IPHONE_NA) *)
- { This function is obsolete. Use `CGEventCreateScrollWheelEvent' instead.
- Synthesize scroll wheel events.
- The parameter `wheelCount' specifies the number of scrolling devices, up
- to a maximum of 3.
- The parameter `wheel1' specifies a value that reflects the movement of
- the primary scrolling device on the mouse. The second and third values,
- if any, reflect the movements of the other scrolling devices on the
- mouse.
- Scrolling movement is represented by small signed integer values,
- typically in a range from -10 to +10. Large values may have unexpected
- results, depending on the application that processes the event. }
- function CGPostScrollWheelEvent( wheelCount: CGWheelCount; wheel1: SInt32; ... ): CGError; external name '_CGPostScrollWheelEvent';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_6, __IPHONE_NA, __IPHONE_NA) *)
- {
- * Synthesize keyboard events. Based on the values entered,
- * the appropriate key down, key up, and flags changed events are generated.
- * If keyChar is NUL (0), an appropriate value will be guessed at, based on the
- * default keymapping.
- *
- * All keystrokes needed to generate a character must be entered, including
- * SHIFT, CONTROL, OPTION, and COMMAND keys. For example, to produce a 'Z',
- * the SHIFT key must be down, the 'z' key must go down, and then the SHIFT
- * and 'z' key must be released:
- * CGPostKeyboardEvent( (CGCharCode)0, (CGKeyCode)56, true ); // shift down
- * CGPostKeyboardEvent( (CGCharCode)'Z', (CGKeyCode)6, true ); // 'z' down
- * CGPostKeyboardEvent( (CGCharCode)'Z', (CGKeyCode)6, false ); // 'z' up
- * CGPostKeyboardEvent( (CGCharCode)0, (CGKeyCode)56, false ); // 'shift up
- }
- { This function is obsolete. Use `CGEventCreateKeyboardEvent' instead. }
- function CGPostKeyboardEvent( keyChar: CGCharCode; virtualKey: CGKeyCode; keyDown: boolean_t ): CGError; external name '_CGPostKeyboardEvent';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_6,
- __IPHONE_NA, __IPHONE_NA) *)
- {$endc}
- {
- * By default the system suppresses local hardware events from the keyboard and mouse during
- * a short interval after a synthetic event is posted (see CGSetLocalEventsSuppressionInterval())
- * and while a synthetic mouse drag (mouse movement with the left/only mouse button down).
- *
- * Some classes of applications may want to enable events from some of the local hardware.
- * For example, an app may want to post only mouse events, and so may wish to permit local
- * keyboard hardware events to pass through. Set the filter state to permit keyboard events
- * prior to posting the mouse event after which you want to get keyboard events.
- *
- * This interface lets an app specify a state (event suppression interval, or mouse drag), and
- * a mask of event categories to be passed through. The new filter state takes effect
- * with the next event your app posts.
- }
- { A type specifying masks for classes of low-level events that can be
- filtered during event suppression states. }
- const
- kCGEventFilterMaskPermitLocalMouseEvents = $00000001; { Mouse, scroll wheel }
- kCGEventFilterMaskPermitLocalKeyboardEvents = $00000002; { Alphanumeric keys and Command, Option, Control, Shift, AlphaLock }
- kCGEventFilterMaskPermitSystemDefinedEvents = $00000004; { Power key, bezel buttons, sticky keys }
- type
- CGEventFilterMask = UInt32;
- const
- kCGEventFilterMaskPermitAllEvents = $00000007;
- { A type specifying the event suppression states that can occur after
- posting an event. }
- const
- kCGEventSuppressionStateSuppressionInterval = 0;
- kCGEventSuppressionStateRemoteMouseDrag = 1;
- kCGNumberOfEventSuppressionStates = 2;
- type
- CGEventSuppressionState = UInt32;
- {$ifc TARGET_OS_MAC}
- { This function is obsolete. Use
- `CGEventSourceSetLocalEventsFilterDuringSuppressionState' instead. }
- function CGSetLocalEventsFilterDuringSuppressionState( filter: CGEventFilterMask; state: CGEventSuppressionState ): CGError; external name '_CGSetLocalEventsFilterDuringSuppressionState';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_1, __MAC_10_6, __IPHONE_NA, __IPHONE_NA) *)
- {
- * Set the period of time in seconds that local hardware events (keyboard and mouse)
- * are suppressed after posting an event. Defaults to 0.25 second.
- }
- { This function is obsolete. Use
- `CGEventSourceSetLocalEventsSuppressionInterval' instead. }
- function CGSetLocalEventsSuppressionInterval( seconds: CFTimeInterval ): CGError; external name '_CGSetLocalEventsSuppressionInterval';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_6,
- __IPHONE_NA, __IPHONE_NA) *)
- { This function is obsolete. Use `CGWindowServerCreateServerPort'
- instead. }
- function CGWindowServerCFMachPort: CFMachPortRef; external name '_CGWindowServerCFMachPort';
- (* CG_AVAILABLE_BUT_DEPRECATED(__MAC_10_1, __MAC_10_8, __IPHONE_NA, __IPHONE_NA) *)
- {$endc}
- { Obsolete. Present for backwards compatibility with old header typos. }
- {
- #define kCGEventSupressionStateSupressionInterval \
- kCGEventSuppressionStateSuppressionInterval
- #define kCGEventSupressionStateRemoteMouseDrag \
- kCGEventSuppressionStateRemoteMouseDrag
- #define kCGNumberOfEventSupressionStates \
- kCGNumberOfEventSuppressionStates
- #define CGEventSupressionState \
- CGEventSuppressionState
- #define CGSetLocalEventsFilterDuringSupressionState(filter, state) \
- CGSetLocalEventsFilterDuringSuppressionState(filter, state)
- }
- { A type representing the count of items in an array of Quartz rectangles. }
- type
- CGRectCount = UInt32;
- {$ifc not defined MACOSALLINCLUDE or not MACOSALLINCLUDE}
- end.
- {$endc} {not MACOSALLINCLUDE}
|