FreeBSD Manual Pages
XmtCreatePixmapIcon(3) Library Functions Manual XmtCreatePixmapIcon(3) NAME XmtCreatePixmapIcon(), XmtChangePixmapIcon(), XmtDestroyPixmapIcon() - han- dle non-rectangular multi-color window manager icons. SYNOPSIS #include <Xmt/Icon.h> void XmtCreatePixmapIcon(Widget w, Pixmap icon, Pixmap shape) void XmtChangePixmapIcon(Widget w, Pixmap icon, Pixmap shape) void XmtDestroyPixmapIcon(Widget w) ARGUMENTS INPUTS w Any child of a toplevel shell (i.e. not a dialog box) that is to have its icon window created, changed, or destroyed. icon A multi-color pixmap (i.e. not a monochrome bitmap) to be dis- played in the icon window. It should have the same depth as the default depth of the screen. shape A bitmask that defines the shape of the icon win dow, or None for a rectangular icon. This bitmask will be ignored if the X server does not support the SHAPE extension to the X protocol. DESCRIPTION Shell widgets allow you to specify icons to be displayed by the window man- ager with the XtNiconPixmap and XtNiconMask arguments. Unfortunately, XtNi- conPixmap only accepts 2-color bitmaps, and XtNiconMask is ignored by most window managers. If you want the window manager to display a multi-color or non-rectangular icon for your windows, you must specify the icon window yourself with the XtNiconWindow resource. These functions make this process much easier. XmtCreatePixmapIcon() creates an icon window for the shell widget of w, and displays the pixmap icon in it. If the shape bitmask is specified and the X server supports the SHAPE extension, XmtCreatePixmapIcon() will make the icon window non-rectangular, giving it the specified shape. Note that some window managers will reparent a non-rectangular icon window into a rectan- gular frame, defeating the purpose of the shape bitmask. XmtChangePixmapIcon() can be used to change the pixmap dis played in a shell's icon window, to change the shape of that window. Both the icon and shape arguments are optional to this function-pass None if you do not want to change their current values. XmtDestroyPixmapIcon() destroys the icon window associated with the shell of the widget w. The icon window will also be automatically destroyed when the shell is destroyed. SEE ALSO Chapter 5, Using Icons, Chapter 15, Working with the Window Manager. Xmt Motif Tools XmtCreatePixmapIcon(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtDestroyPixmapIcon&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>