DtActionIcon(3)

DtActionIcon(3)	       C LIBRARY FUNCTIONS	  DtActionIcon(3)

NAME
     DtActionIcon - get	the icon information for an action

SYNOPSIS
     #include <Dt/Action.h>

     char *DtActionIcon(char *actionName);

DESCRIPTION
     The DtActionIcon()	function gets the icon information for an
     action.   The actionName argument is the name of the action.
     DtActionIcon() returns the	name of	the icon associated  with
     an	 actionName  action.   If  the action definition does not
     explicitly	identify an icon name, this function returns  the
     default  action  icon  name, as described in dtactionfile(4)
     (``Action Selection'').  The default action icon name can be
     customized	using the actionIcon X resource.

     If	 there	are  multiple  actionName  actions,  the   string
     returned  is  the	icon  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	 DtActionIcon()	 function
     returns a newly allocated copy of the icon	name string (ICON
     field) associated with the	 action;  otherwise,  it  returns
     NULL.

APPLICATION USAGE
     The DtActionIcon()	function is useful for applications  that
     provide a graphical interface to actions.

     The application should use	XtFree(3X) to free the icon  name
     string returned by	the DtActionIcon() function.

SEE ALSO
     DtAction(5), XtFree(3X) dtactionfile(4), dtdtfile(4).

Unix System LaboratoLast change: 1 August 1995			1