Index Index for
Section 3
Index Alphabetical
listing for D
Bottom of page Bottom of
page		 

DtActionIcon(3)


CDE


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
  Selection'').


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), dtactionfile(4), dtdtfile(4), XtFree(3X) in the X/Open CAE
  Specification, X/Open Window Management: X Toolkit Intrinsics

Index Index for
Section 3
Index Alphabetical
listing for D
Top of page Top of
page