XpSetContext(3Xp)        XPRINT FUNCTIONS       XpSetContext(3Xp)



NAME
       XpSetContext  -   Sets  or unsets a print context with the
       specified display connection to the X Print Server.

SYNOPSIS
             cc [ flag... ] file... -lXp [ library... ]
             #include 

       void XpSetContext ( display, print_context )
             Display *display;
             XPContext print_context;

ARGUMENTS
       display
              Specifies  a  pointer  to  the  Display  structure;
              returned from XOpenDisplay.

       print_context
              A  pre-existing print context on the same X Server.

DESCRIPTION
       XpSetContext sets the print context for a display  connec-
       tion.  All subsequent print operations that do not explic-
       itly take a print context-id (for example, XpStartJob)  on
       display  will  use  and  act upon the print context set by
       this call, until the print context is unset or  XpDestroy-
       Context  is  called. The print context can be set and used
       on multiple jobs, if not destroyed.

       If print_context is None, XpSetContext will unset  (disas-
       sociate) the print context previously associated with dis-
       play. If there was no previously associated print context,
       no action is taken. The content of the formerly associated
       print context is not affected by this call, and other dis-
       play connections may continue to use the print context.

       Since  font capabilities can vary from printer to printer,
       XpSetContext may modify the list of available  fonts  (see
       XListFonts) on display, and the actual set of usable fonts
       (see XLoadFont). A unique  combination  of  fonts  may  be
       available  from  within  a  given  print context; a client
       should not assume that all the  fonts  available  when  no
       print  context  is set will be available when a print con-
       text is set.

       When a print context is set on a display  connection,  the
       default  behavior of ListFonts and ListFontsWithInfo is to
       list all of the fonts normally associated with the X print
       server  (i.e.  fonts  containing  glyphs)  as  well as any
       internal printer fonts defined for the  printer.  The  xp-
       listfonts-modes attribute is provided so that applications
       can control the behavior of ListFonts  and  ListFontsWith-
       Info  and  is typically used to show just internal printer
       fonts.  Using only internal printer fonts  is  useful  for
       performance  reasons;  the glyphs associated with the font
       are contained within the printer and do  not  have  to  be
       downloaded.

       If the value of xp-listfonts-modes includes xp-list-glyph-
       fonts, ListFonts and ListFontsWithInfo will include all of
       the fonts available to the server that have glyphs associ-
       ated  with  them.  If  the  value  of   xp-listfonts-modes
       includes  xp-list-internal-printer-fonts,  then  ListFonts
       and  ListFontsWithInfo  will  include  all  of  the  fonts
       defined as internal printer fonts.

       When  the  print  context  is unset or XpDestroyContext is
       called, the available fonts on display revert back to what
       they were previously.

DIAGNOSTICS
       XPBadContext   A  valid  print context-id has not been set
                      prior to making this call.

SEE ALSO
       XpDestroyContext(3Xp), XpStartJob(3Xp)




X Version 11               libXp 1.0.0          XpSetContext(3Xp)