FreeBSD Manual Pages
XmPrintSetup(3) Library Functions Manual XmPrintSetup(3) NAME XmPrintSetup -- setup and create a Print Shell widget SYNOPSIS #include <Xm/Print.h> Widget XmPrintSetup( Widget video_widget, Screen *print_screen, String print_shell_name, ArgList args, Cardinal num_args); DESCRIPTION A function that does the appropriate setting and creates a realized Xm- PrintShell that it returns to the caller. This function hides the de- tails of the Xt to set up a valid print shell heirarchy for the appli- cation. It is also meant to encourage consistency in the way applica- tions root their print widget hierarchy. print_screen must belong to a Display connection that has already been initialized with Xt. The video_widget is used to get at the application context, application name and class, and argc/argv stored on the applicationShell that roots this widget. If no applicationShell is found, NULL argv/argc are used. XmPrintSetup then creates an unrealized ApplicationShell with the same name and class as the one given by the video display, on the print dis- play and on the print screen specified. An XmPrintShell is then created as a child of this toplevel shell, us- ing XtCreatePopupShell, with the name print_shell_name, and using the args provided. It then realizes and maps the print shell, using XtPopup with XtGrabNone. This way, application resource files and users can specify print spe- cific attributes using the following syntax (if print_shell_name is "Print"): Dtpad.Print*textFontList: somefont *Print*background:white *Print*highlightThickness:0 video_widget A video widget to fetch app video data from. print_screen A print screen on the print display - specifies the screen onto which the new shell is created. print_shell_name Specifies the name of the XmPrintShell created on the X Print server. args Specifies the argument list from which to get the resources for the XmPrintShell. num_args Specifies the number of arguments in the argument list. RETURN VALUE The id the XmPrintShell widget created on the X Print Server connec- tion, or NULL if an error has occured. ERRORS/WARNINGS None. EXAMPLES From the OK callback and the SetUp callback of the primary print dialog widget: static void printOKCB(Widget, XtPointer call_data, XtPointer client_data) { AppPrint *p = (AppPrint *) client_data; DtPrintSetupCallbackStruct *pbs = (XmPrintCallbackStruct *) call_data; /* connect if not already done. the print dialog callback always provides valid printer name, print display and screen already initialized: XpInitContext called */ */ p->print_shell = XmPrintSetup (widget, pbs->print_screen, "Print", NULL, 0); ... } SEE ALSO XmPrintShell(3), XmRedisplayWidget(3), XmPrintToFile(3), XmPrintPopup- PDM(3) XmPrintSetup(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS/WARNINGS | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmPrintSetup&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>