Define_Callback_Name
Functions | |
void | Define_Callback_Name (const char *name, void(HC_CDECL *)(HC_ANY_ARGS) callback) |
Defines a unique name as a legal callback. More... | |
void | UnDefine_Callback_Name (const char *name) |
Removes all settings established by a previous call to Define_Callback_Name(). More... | |
Detailed Description
Function Documentation
◆ Define_Callback_Name()
void Define_Callback_Name | ( | const char * | name, |
void(HC_CDECL *)(HC_ANY_ARGS) | callback | ||
) |
Defines a unique name as a legal callback.
- Parameters
-
name - Name of new callback routine to be added to the system's list. callback - Address of new callback routine, a routine returning nothing.
DETAILS
Define_Callback_Name is part of the classic HOOPS Intermediate Mode (I.M.) system. The name is defined in the system as a legal callback and can be used in subsequent calls to Set_Callback() . The name you choose is up to you.
NOTES
Defining names before using them makes programs more readable. Defining names also allows the system to correctly read and write callback routines to a metafile.
A warning is given for redefining an existing name.
The limit on the length of callback names is large (on the order of 216 characters.)
RESTRICTIONS
- See also
◆ UnDefine_Callback_Name()
void UnDefine_Callback_Name | ( | const char * | name | ) |
Removes all settings established by a previous call to Define_Callback_Name().
- Parameters
-
name - Name of new callback routine to be added to the system's list.
DETAILS
No additional details. See Define_Callback_Name()