Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

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

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
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()