CAPTUREKEYPRESSCALLBACK Function

#include "l_bitmap.h"

L_INT pEXT_CALLBACK YourFunction (nKey, uHotKeyModifiers, pUserData)

L_INT nKey;

/* code for HotKey that was pressed */

L_UINT uHotKeyModifiers;

/* modifier key */

L_VOID * pUserData;

/* pointer to additional parameters */

Signals that the user has pressed the capture HotKey.

Parameter

Description

nKey

Key code for activation key.

uHotKeyModifiers

Modifier keys used with nHotKey. Possible values are listed below and may be combined.

 

MOD_ALT

Alt Key pressed.

 

MOD_CONTROL

Control key pressed.

 

MOD_SHIFT

Shift key pressed.

 

0

No modifier key was pressed.

pUserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the calling function.)

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this callback function to receive notification that the capture HotKey has been pressed by the user. Set this callback using L_CaptureSetKeyPressCallback.

If you do not wish to process the pressed HotKey + Modifiers combination, return ERROR_USER_ABORT.

Required DLLs and Libraries

LTSCR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_CaptureKeyPressCallback

Topics:

Support Functions: Callbacks

 

Implementing Screen Capture

Example

For an example, refer to L_CaptureSetKeyPressCallback.