*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtActionLabel (3)              


 DtActionLabel(library call)                     DtActionLabel(library call)

 NAME    [Toc]    [Back]
      DtActionLabel - get the localizable label string for an action

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Action.h>
      char *DtActionLabel(
      char *actionName);

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      All applications displaying action names should use the action label
      to identify an action.

 SEE ALSO    [Toc]    [Back]
      Dt/Action.h - DtAction(5), dtactionfile(4), dtdtfile(4).

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
DtActionExists HP-UX determine if a string corresponds to an action name
DtActionInvoke HP-UX invoke a CDE action
DtAction HP-UX action service definitions
dtactionaction HP-UX CDE action management actions
DtActionIcon HP-UX get the icon information for an action
tack Linux terminfo action checker
sigaction Tru64 Specify the action to take upon delivery of a signal
sigaction HP-UX examine and change signal action
DtDtsDataTypeIsAction HP-UX determine if the data type is an action
DtActionDescription HP-UX obtain the descriptive text for a given action
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service