|
The mframe() function creates a new frame with parameters listed in plist.
The recognized keys in plist are window system dependent.
The following key is always recognized.
In addition, in the m17n-X library, the following keys are recognized. They are to specify the root window and the depth of drawables that can be used with the frame.
-
Mdrawable, the value type must be
Drawable
A parameter of key Mdisplay must also be specified. The created frame can be used for drawables whose root window and depth are the same as those of the specified drawable on the specified display.
When this parameter is specified, the parameter of key Mscreen is ignored.
-
Mwidget, the value type must be
Widget .
The created frame can be used for drawables whose root window and depth are the same as those of the specified widget.
If a parameter of key Mface is not specified, the default face is created from the resources of the widget.
When this parameter is specified, the parameters of key Mdisplay, Mscreen, Mdrawable, Mdepth are ignored.
-
Mdepth, the value type must be
unsigned .
The created frame can be used for drawables of the specified depth.
-
Mscreen, the value type must be
(Screen *) .
The created frame can be used for drawables whose root window is the same as the root window of the specified screen, and depth is the same at the default depth of the screen.
When this parameter is specified, parameter of key Mdisplay is ignored.
-
Mdisplay, the value type must be
(Display *) .
The created frame can be used for drawables whose root window is the same as the root window for the default screen of the display, and depth is the same as the default depth of the screen.
-
Mcolormap, the value type must be
(Colormap) .
The created frame uses the specified colormap.
- Return value:
- If the operation was successful, mframe() returns a pointer to a newly created frame. Otherwise, it returns
NULL .
|