[ новости /+++ | форум | теги | ]

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 localiz-
     able  label  string  associated with an action named action-
     Name.  The actionName argument is the name  of  the  action.
     The  localizable  label  string  is the string that all com-
     ponents 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 Selec-
     tion'').

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 action-
     Name  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).

Партнёры:

Хостинг: