*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> XmPrintPopupPDM (3)              


 XmPrintPopupPDM(library call)                 XmPrintPopupPDM(library call)

 NAME    [Toc]    [Back]
      XmPrintPopupPDM - Send a notification for the PDM to be popped up

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/Print.h>
      XtEnum XmPrintPopupPDM(

 DESCRIPTION    [Toc]    [Back]
      A convenience function that sends a notification to start a Print
      Dialog Manager on behalf of the application, XmPrintPopupPDM hides the
      details of the X selection mechanism used to notify the PDM that a new
      dialog must be popped up for this application.

      XmPrintPopupPDM sends a selection request to either the print display
      of the print shell, or the video display of the transient_for video
      widget (depending on the environment variable XPDMDISPLAY, which can
      only takes the value "print" or "video"), asking for the PDM windows
      to be popped up on behalf of the app.

      Return right away with status of XmPDM_NOTIFY_FAIL (e.g. if the
      function couldn't malloc memory for the selection value, or if
      XPDMDISPLAY is not "print" or "video") or with XmPDM_NOTIFY_SUCCESS ,
      which only means a "message" was sent out to the PDM specified by
      XPDMSELECTION , not that it's already up on the screen yet.

      In order to know if the PDM is up, or not running, the application
      must register a XmNpdmNotificationCallback with the Print Shell.

      XmPrintPopupPDM puts up an InputOnly window on top of the dialog, so
      that the end user doesn't use the print setup dialog while the PDM is
      trying to come up. This window is automatically removed when the shell
      is about to call the callback for the first time.

                The Print Shell used for this print job and context.

                The video widget dealing with application print setup.

 RETURN VALUE    [Toc]    [Back]
      Returns XmPDM_NOTIFY_SUCCESS if the function was able to send the
      notification out to the PDM process, XmPDM_NOTIFY_FAIL otherwise.

      Not applicable.

 EXAMPLES    [Toc]    [Back]
      Example of callback from a Print set up dialog box "Setup..." button:

                                    - 1 -       Formatted:  January 24, 2005

 XmPrintPopupPDM(library call)                 XmPrintPopupPDM(library call)

          if (XmPrintPopupPDM (pshell, XtParent(print_dialog)) !=
                                          XmPDM_NOTIFY_SUCCESS) {
              /* some error dialog */

      Example of XmNpdmNotificationCallback from a Print Shell:

          XmPrintShellCallBackStruct * pr_cb = ...

          switch (pr_cb->reason) {
             case XmCR_PDM_NONE:
                 /* no PDM available */
             case XmCR_PDM_VXAUTH:
                 /* PDM is not authorized ... */
             case XmCR_PDM_UP: the PDM is up and running
                 /* everything is fine */
                     default: /* other cases */

 SEE ALSO    [Toc]    [Back]
      XmPrintSetup(3), XmPrintShell(3), XmRedisplayWidget(3),

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
mailbox IRIX mail notification
kevent OpenBSD kernel event notification mechanism
EvmConnSubscribe Tru64 Establishes a subscription for event notification
kevent FreeBSD kernel event notification mechanism
EvmConnRegistrationGet Tru64 Establishes a subscription for event notification
EvmConnTemplateScan Tru64 Establishes a subscription for event notification
mq_notify IRIX register message notification request
kqueue FreeBSD kernel event notification mechanism
kqueue OpenBSD kernel event notification mechanism
EventNotifyManager Tru64 Receive an event notification (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service