Poster of Linux kernelThe best gift for a Linux geek
ppd_check_option_is_marked

ppd_check_option_is_marked

Section: C Library Functions (3)
Local index Up
 

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).


 

Index

NAME
SYNOPSIS
DESCRIPTION
ppd_check_option_is_marked(PpdFile *ppd, const char *option, const char *choice);
ppd_mark_option(PpdFile *ppd, const char *option, const char *choice);
void ppd_mark_defaults (PpdFile *ppd);
RETURN VALUE
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:52:54 GMT, April 16, 2011