DtActionLabel(3) UNIX System V (1 August 1995) DtActionLabel(3)
NAME
DtActionLabel - get the localizable label string for an
action
SYNOPSIS
#include <Dt/Action.h>
char *DtActionLabel(char *actionName);
DESCRIPTION
The DtActionLabel() function provides access to the
localizable label string associated with an action named
actionName. The actionName argument is the name of the
action. The localizable label string is the string that all
components should display to identify the action. If the
action definition does not specify a label string, the
action name itself is returned.
The label string associated with an action is localizable,
but the action name is not.
If there are multiple actionName actions, the label string
returned is the label associated with the most general
action. The most general action is the one with the lowest
precedence, as described in dtactionfile(4) (``Action
Selection'').
RETURN VALUE
Upon successful completion, the DtActionLabel() function
returns a newly allocated copy of the localizable label
string associated with the action if an action named
actionName is found; otherwise, it returns NULL. It is up
to the caller to free the memory associated with this new
copy of the label. The default value for an action label is
the action name itself.
APPLICATION USAGE
All applications displaying action names should use the
action label to identify an action.
SEE ALSO
DtAction(5), dtactionfile(4), dtdtfile(4).
Page 1 (printed 9/3/04)