Display Handler Functions
Abstract
Use this handler to display a new name for an existing attribute in the attribute’s dialog box
Syntax
<display handler name> (attr_name, orig_object, copy_object, display_str)
| Argument | Type | Description |
|---|---|---|
attr_name |
const char * |
Pointer to a string containing the object name |
orig_object |
EtsT_Obj_Handle |
Handle for the original attribute object |
copy_object |
EtsT_Obj_Handle |
Handle for a copy of the original attribute object |
display_str |
char * |
Pointer to a string containing the new value |
Return Type
EtsT_Obj_Dbox_Display_Options
Only value available is EtsC_Obj_Dbox_Display_Option.
Details
An application calls a display handler whenever the object attribute dialog box is drawn or redrawn. You can use this handler to display a different name for an attribute: for example, to display “High Threshold” or “Low Threshold” depending on a threshold attribute’s current setting. To change the attribute’s displayed name, copy the new name to the character buffer referenced by display_string. This is a pre-allocated buffer of 2048 characters; it is not allocated or deallocated by this handler.
Changing an attribute’s displayed name has no effect on the original attribute name.
This handler has no return options defined.