background image
Functional specification
25
CDE/Motif PST
CDEnext
2.7.2
Long Description
NAME
XpGetPageDimensions - get the page dimensions for the current printer settings
SYNOPSIS
#include <X11/extensions/Print.h>
Status XpGetPageDimensions(
Display
*display,
XPContext
print_context,
unsigned short
*width,
/* return value */
unsigned short
*height,
/* return value */
XRectangle
*reproducible_area
) /* return value */
ARGUMENTS
display
Specifies a pointer to the
Display
structure; returned from
XOpenDisplay
.
print_context
A pre-existing print context.
width
The pixel width of the page currently selected in the print context.
height
The pixel height of the page currently selected in the print context.
reproducible_area
The net reproducible area of the page currently selected in the print
context, expressed in pixel offsets and dimension.
RETURN VALUE
Returns a
Status
of
0
on failure, or
1
on success..
DESCRIPTION
XpGetPageDimensions
considers the medium currently selected in the print context (derived in part
from default-medium, default-input-tray, input-trays-medium, content-orientation, default-resolution), and
returns the total width and height of the page in pixels, and the net reproducible area within the total width
and height.
ERRORS/WARNINGS
This function can generate one of the following errors:
XPBadContext
The specified print context id is not valid.
SEE ALSO
XpSetContext