PpSetPC()

Modify the attributes of a print context

Synopsis:

int PpSetPC( PpPrintContext_t *pc,
             int member,
             void const * const data,
             int lock );

Arguments:

pc

The pointer to a PpPrintContext_t structure that was returned by PpCreatePC().

member

The member of the print context to modify, as given in the table below. For a description of the members, see PpPrintContext_t.

data

A pointer to the data to be assigned to the specified print context member.

lock

If nonzero, the PtPrintSel widget and properties applications won't override or allow modification of the member; its value is locked. Locked members have their controls dimmed and inactive in the PtPrintSel widget or PtPrintSelection() dialog.

Library:

ph

Description:

This function provides a mechanism to modify the attributes of a print context.

---

Don't modify the print context directly, as the appropriate changed bits won't be set and the application may stop working if the print context structure is redefined in the future.

---

Use the data types given below when setting the value of the members of the print context.

---

In the following table: “String” indicates a char * pointer to a null-terminated sequence of characters. “char *” indicates a char * pointer to a value in the range 0x0 to 0xFF.

---

By default, all members are 0 or NULL.

Returns:

0

Success.

-1

An error occurred. See errno for details.

Errors:

EACCES

The specified member couldn't be changed because it's locked.

ESRCH

An unknown member was specified.

Examples:

set_my_apps_Pp_prefs( PpPrintContext_t *pc )
    {
    char do_preview = 1, duplex = some_value;
    PpSetPC( pc, Pp_PC_DO_PREVIEW, &do_preview, 0 );
    PpSetPC( pc, Pp_PC_DUPLEX, &duplex, 0 );
    // etc...
    }

Classification:

Photon

See also:

PhDim_t, PhPoint_t, PhRect_t, PpContinueJob(), PpCreatePC(), PpEndJob(), PpGetCanvas(), PpGetPC(), PpLoadDefaultPrinter(), PpLoadPrinter(), PpPrintContext_t, PpPrintNewPage(), PpPrintWidget(), PpReleasePC() PpSetCanvas(), PpStartJob(), PpSuspendJob(),

Printing in the Photon Programmer's Guide