GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTCREATEPIXMAPICON (3)

NAME

XmtCreatePixmapIcon(), XmtChangePixmapIcon(), XmtDestroyPixmapIcon() - handle non-rectangular multi-color window manager icons.

CONTENTS

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 displayed 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 manager with the XtNiconPixmap and XtNiconMask arguments. Unfortunately, XtNiconPixmap 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 rectangular 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.
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTCREATEPIXMAPICON (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.