LTSCRHELPCB Function
#include "l_bitmap.h"
L_VOID pEXT_CALLBACK YourFunction(uFlag, nCtlID, pUserData)
L_UINT32 uFlag; |
/* flags */ |
L_INT nCtlID; |
/* the control ID */ |
L_VOID * pUserData; |
/* pointer to additional parameters */ |
Occurs when the user has clicked the Help button, clicked the "?" button on the title bar, or pressed F1 for a control on a dialog.
Parameter |
Description |
|
uFlag |
Flags that determine the options dialog that the Help button was clicked from. Possible values are: |
|
|
Value |
Meaning |
|
SCRDLG_HELP_SETCAPTUREOPTION |
[0x01] Capture options dialog. |
|
SCRDLG_HELP_CAPTUREAREAOPTION |
[0x02] Capture area options dialog. |
|
SCRDLG_HELP_CAPTUREOBJECTOPTION |
[0x03] Capture object options dialog. |
|
SCRDLG_HELP_CAPTUREFROMEXE |
[0x04] Capture from exe file dialog. |
nCtlID |
Value that represents the control ID. If the user pressed F1 or clicked the context help button "?" and then selected a control on the dialog box, one of the following values is returned. Otherwise, the value is -1 |
|
|
Value |
Meaning |
|
LT_SCRDLG_IDC_HOTKEY |
[27079] Hotkey field. |
|
LT_SCRDLG_IDC_DELAY |
[27040] Delay field. |
|
LT_SCRDLG_IDC_REPEAT |
[27043] Repeat field. |
|
LT_SCRDLG_IDC_INTERVAL |
[27048] Interval field. |
|
LT_SCRDLG_IDC_CANCELKEY |
[27085] Cancel key field. |
|
LT_SCRDLG_IDC_USE_ESC |
[27091] Use Esc check box. |
|
LT_SCRDLG_IDC_CAP_CURSOR |
[27081] Capture cursor combo box. |
|
LT_SCRDLG_IDC_STAT_CURSOR |
[27083] Status cursor combo box. |
|
LT_SCRDLG_IDOK |
[1] Ok button. |
|
LT_SCRDLG_IDCANCEL |
[2] Cancel button. |
|
LT_SCRDLG_IDC_RESTREE |
[27035] Resource tree. |
|
LT_SCRDLG_IDC_COLOR_GROUP |
[27092] Color group. |
|
LT_SCRDLG_IDC_R_TEXT |
[27070] Label of Red channel. |
|
LT_SCRDLG_IDC_R_SLIDER |
[27055] Slider of Red channel. |
|
LT_SCRDLG_IDC_RED |
[27025] Red channel. |
|
LT_SCRDLG_IDC_G_TEXT |
[27072] Green channel of text color. |
|
LT_SCRDLG_IDC_G_SLIDER |
[27057] Green channel of slider color. |
|
LT_SCRDLG_IDC_GREEN |
[27027] Green channel. |
|
LT_SCRDLG_IDC_B_TEXT |
[27074] Blue channel of text color. |
|
LT_SCRDLG_IDC_B_SLIDER |
[27059] Blue channel of slider color. |
|
LT_SCRDLG_IDC_BLUE |
[27031] Blue channel. |
|
LT_SCRDLG_IDC_RESVIEW |
[27029] Resource view. |
|
LT_SCRDLG_IDC_PREV_STATIC |
[27068] Previous static. |
|
LT_SCRDLG_IDC_FILENAME |
[27076] File name. |
|
LT_SCRDLG_IDC_CAPTURE |
[27053] Capture. |
|
LT_SCRDLG_IDC_COUNT |
[27061] Count. |
|
LT_SCRDLG_IDC_SELECTION |
[27078] Selection. |
|
LT_SCRDLG_IDC_BROWSE |
[27046] Browse. |
|
LT_SCRDLG_IDC_COMBO_DRAW_CURSOR |
[27075] Draw cursor combo box. |
|
LT_SCRDLG_IDC_EDIT_BORDER_WIDTH |
[27089] Edit border width. |
|
LT_SCRDLG_IDC_CHECK_INVERT_OBJECT |
[27090] Invert object checkbox. |
|
LT_SCRDLG_IDC_CHECK_ENABLE_KEYBOARD |
[27036] Enable keyboard checkbox. |
|
LT_SCRDLG_IDC_BUTTON_OK |
[27084] Ok button. |
|
LT_SCRDLG_IDC_BUTTON_DEFAULT |
[27000] Default button. |
|
LT_SCRDLG_IDC_BUTTON_CANCEL |
[27086] Cancel button. |
|
LT_SCRDLG_IDC_COMBO_AREA_TYPE |
[27080] Area type combo box. |
|
LT_SCRDLG_IDC_COMBO_LINE_STYLE |
[27071] Line style combo box. |
|
LT_SCRDLG_IDC_COMBO_FILL_PATTERN |
[27073] File pattern combo box. |
|
LT_SCRDLG_IDC_EDIT_ELLIPSE_WIDTH |
[27087] Edit ellipse width. |
|
LT_SCRDLG_IDC_EDIT_ELLIPSE_HEIGHT |
[27088] Edit ellipse height. |
|
LT_SCRDLG_IDC_CHECK_INCLUDE_CURSOR |
[27034] Check include cursor. |
|
LT_SCRDLG_IDC_CHECK_USE_CROSS_LINES_CURSOR |
[27067] Use cross lines cursor checkbox. |
|
LT_SCRDLG_IDC_CHECK_ENABLE_REGION |
[27041] Enable region checkbox. |
|
LT_SCRDLG_IDC_CHECK_SHOW_DRAW_CURSOR |
[27063] Show draw cursor checkbox. |
|
LT_SCRDLG_IDC_COMBO_INFOWND_X |
[27050] Information Window X position combo box. |
|
LT_SCRDLG_IDC_COMBO_INFO_WIDTH |
[27045] Information Window width. |
|
LT_SCRDLG_IDC_COMBO_INFOWND_Y |
[27069] Information Window Y position combo box. |
|
LT_SCRDLG_IDC_COMBO_INFO_HEIGHT |
[27082] Information Window height. |
|
LT_SCRDLG_IDC_EDIT_INFO_X |
[27052] Edit Information Window X position. |
|
LT_SCRDLG_IDC_EDIT_INFO_WIDTH |
[27056] Edit Information Window width. |
|
LT_SCRDLG_IDC_EDIT_INFO_Y |
[27054] Edit information Window Y position. |
|
LT_SCRDLG_IDC_EDIT_INFO_HEIGHT |
[27058] Edit Information Window height. |
|
LT_SCRDLG_IDC_COMBO_ZOOM |
[27026] Zoom combo box. |
|
LT_SCRDLG_IDC_CHECK_SHOW_CURSORPOS |
[27038] Show cursor position checkbox. |
|
LT_SCRDLG_IDC_CHECK_SHOW_INFOWINDOW |
[27032] Show Information Window checkbox. |
|
LT_SCRDLG_IDC_CHECK_SHOW_AREASIZE |
[27028] Show Area Size checkbox. |
|
LT_SCRDLG_IDC_CHECK_SENSITIVE_INFO |
[27030] Sensitive Information Window checkbox. |
|
LT_SCRDLG_IDC_CHECK_OPAQUE_TEXT |
[27062] Opaque text checkbox. |
|
LT_SCRDLG_IDC_COMBO_COLORS |
[27077] Colors combo box. |
|
LT_SCRDLG_IDC_STATIC_COLORS |
[27065] Static colors. |
|
LT_SCRDLG_IDC_BUTTON_COLORS |
[27060] Colors button. |
pUserData |
Void pointer that you can use to pass one or more additional parameters that the help callback function needs. To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then, in this parameter, pass the address of the variable or structure, casting it to L_VOID *. The callback function, which receives the address in its own pUserData parameter, can cast it to a pointer of the appropriate data type to access your variable or structure. If the additional parameters are not needed, you can pass NULL in this parameter. |
Returns
None.
Comments
Use this callback function to receive notification that the user clicked the Help button on any of the built-in dialogs, such as the dialogs showed by calling any of the functions L_SetCaptureOptionDlg, L_CaptureAreaOptionDlg, L_CaptureObjectOptionDlg, or L_CaptureFromExeDlg.
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_SetCaptureOptionDlg, L_CaptureAreaOptionDlg, L_CaptureObjectOptionDlg, L_CaptureFromExeDlg |
Topics: |
|
|
Example
For an example, refer to L_SetCaptureOptionDlg.