Man Linux: Main Page and Category List

NAME

       ppd_check_option_is_marked,  ppd_mark_defaults, ppd_mark_option - a set
       of functions for determining the current  status  of  PPD  options  and
       selecting them.

SYNOPSIS

       #include <ppd.h>

       gboolean ppd_check_option_is_marked (PpdFile *ppd, const char *keyword,
       const char *option);

       gint ppd_mark_option(PpdFile  *ppd,  const  char  *option,  const  char
       *choice);

       void ppd_mark_defaults (PpdFile *ppd);

DESCRIPTION

       These  three functions are used to query the marked status of an option
       in a PPD file as well as forcing an option to be selected.

   ppd_check_option_is_marked(PpdFile *ppd, const  char  *option,  const  char
       *choice);
       ppd_check_option_is_marked()  accepts  three  parameters  as input. The
       first is the PpdFile pointer to a PPD file obtained by calling  one  of
       the  ppd_load(3)  functions.  The second parameter is the option of the
       keyword name.  The final input parameter is the actual choice name.

   ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);
       ppd_mark_option allows the programmer to manually select an option in a
       PPD  file.   The  parameters  are  the  a  valid  PpdFile  pointer (see
       ppd_file_new(3)), the option name, and the choice name.

   void ppd_mark_defaults (PpdFile *ppd);
       ppd_mark_defaults() resets all the default  options  in  the  PPD  file
       specified by the PpdFile pointer (see ppd_file_new(3)).

RETURN VALUE

       ppd_check_option_is_marked()
              FALSE  if  the  option  is not currently selected and TRUE is it
              marked

       ppd_mark_option()
              Always returns 0.  The only means of determining whether or  not
              the   function  succeeded  is  to  make  a  subsequent  call  to
              ppd_check_option_is_marked() on the same option.

SEE ALSO

       ppd_file_new(3),         ppd_emit_to_file(3),         ppd_file_free(3),
       ppd_find_choice(3), ppd_get_num_conflicts(3), ppd_get_page_length(3)

AUTHOR

       This  man  page was written by Gerald Carter <gcarter@valinux.com>.  It
       was updated by Mark Fasheh <mfasheh@valinux.com> to reflect changes  in
       libppd  0.5.   Some  of the code was originally part of the Common UNIX
       Printing System (CUPS).

                                                 ppd_check_option_is_marked(3)