Struct xpcom::interfaces::nsIPrintSettingsService

#[repr(C)]
pub struct nsIPrintSettingsService { /* fields omitted */ }

interface nsIPrintSettingsService : nsISupports

Methods

impl nsIPrintSettingsService

pub fn coerce<T: nsIPrintSettingsServiceCoerce>(&self) -> &T

Cast this nsIPrintSettingsService to one of its base interfaces.

impl nsIPrintSettingsService

pub unsafe fn GetGlobalPrintSettings(
    &self,
    aGlobalPrintSettings: *mut *const nsIPrintSettings
) -> nsresult

/**
   * Returns a "global" PrintSettings object
   * Creates a new the first time, if one doesn't exist.
   *
   * Then returns the same object each time after that.
   *
   * Initializes the globalPrintSettings from the default printer
   */

readonly attribute nsIPrintSettings globalPrintSettings;

pub unsafe fn GetNewPrintSettings(
    &self,
    aNewPrintSettings: *mut *const nsIPrintSettings
) -> nsresult

/**
   * Returns a new, unique PrintSettings object each time.
   *
   * For example, if each browser was to have its own unique
   * PrintSettings, then each browser window would call this to
   * create its own unique PrintSettings object.
   *
   * If each browse window was to use the same PrintSettings object
   * then it should use "globalPrintSettings"
   *
   * Initializes the newPrintSettings from the unprefixed printer
   * (Note: this may not happen if there is an OS specific implementation.)
   *
   */

readonly attribute nsIPrintSettings newPrintSettings;

pub unsafe fn GetDefaultPrinterName(
    &self,
    aDefaultPrinterName: &mut nsAString
) -> nsresult

/**
   * The name of the last printer used, or else the system default printer.
   */

readonly attribute AString defaultPrinterName;

pub unsafe fn InitPrintSettingsFromPrinter(
    &self,
    aPrinterName: &nsAString,
    aPrintSettings: *const nsIPrintSettings
) -> nsresult

/**
   * Initializes certain settings from the native printer into the PrintSettings
   * if aPrinterName is null then it uses the default printer name if it can
   * These settings include, but are not limited to:
   *   Page Orientation
   *   Page Size
   *   Number of Copies
   */

void initPrintSettingsFromPrinter (in AString aPrinterName, in nsIPrintSettings aPrintSettings);

pub unsafe fn InitPrintSettingsFromPrefs(
    &self,
    aPrintSettings: *const nsIPrintSettings,
    aUsePrinterNamePrefix: bool,
    aFlags: uint32_t
) -> nsresult

/**
   * Reads PrintSettings values from Prefs,
   * the values to be read are indicated by the "flags" arg.
   *
   * aPrintSettings should be initialized with the name of a printer. First
   * it reads in the PrintSettings from the last print job. Then it uses the
   * PrinterName in the PrinterSettings to read any settings that were saved
   * just for that printer.
   *
   * aPS - PrintSettings to have its settings read
   * aUsePrinterNamePrefix - indicates whether to use the printer name as a prefix
   * aFlags - indicates which prefs to read, see nsIPrintSettings.idl for the
   *          const values.
   *
   * Items not read:
   *   startPageRange, endPageRange, scaling, printRange, title
   *   docURL, howToEnableFrameUI, isCancelled, printFrameTypeUsage
   *   printFrameType, printSilent, shrinkToFit, numCopies,
   *   printerName
   *
   */

void initPrintSettingsFromPrefs (in nsIPrintSettings aPrintSettings, in boolean aUsePrinterNamePrefix, in unsigned long aFlags);

pub unsafe fn SavePrintSettingsToPrefs(
    &self,
    aPrintSettings: *const nsIPrintSettings,
    aUsePrinterNamePrefix: bool,
    aFlags: uint32_t
) -> nsresult

/**
   * Writes PrintSettings values to Prefs,
   * the values to be written are indicated by the "flags" arg.
   *
   * If there is no PrinterName in the PrinterSettings
   * the values are saved as the "generic" values not associated with any printer.
   * If a PrinterName is there, then it saves the items qualified for that Printer
   *
   * aPS - PrintSettings to have its settings saved
   * aUsePrinterNamePrefix - indicates whether to use the printer name as a prefix
   * aFlags - indicates which prefs to save, see nsIPrintSettings.idl for the const values.
   *
   * Items not written:
   *   startPageRange, endPageRange, scaling, printRange, title
   *   docURL, howToEnableFrameUI, isCancelled, printFrameTypeUsage
   *   printFrameType, printSilent, shrinkToFit, numCopies
   *
   */

void savePrintSettingsToPrefs (in nsIPrintSettings aPrintSettings, in boolean aUsePrinterNamePrefix, in unsigned long aFlags);

Methods from Deref<Target = nsISupports>

pub fn coerce<T: nsISupportsCoerce>(&self) -> &T

Cast this nsISupports to one of its base interfaces.

pub unsafe fn QueryInterface(
    &self,
    uuid: &nsIID,
    result: *mut *mut c_void
) -> nsresult

void QueryInterface (in nsIIDRef uuid, [iid_is (uuid), retval] out nsQIResult result);

pub unsafe fn AddRef(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt AddRef ();

pub unsafe fn Release(&self) -> nsrefcnt

[noscript,notxpcom] nsrefcnt Release ();

Trait Implementations

impl XpCom for nsIPrintSettingsService

const IID: nsIID

IID: nsIID = nsID(2215872456, 29414, 18507, [146, 150, 191, 110, 234, 128, 213, 138])

fn query_interface<T: XpCom>(&self) -> Option<RefPtr<T>>

Perform a QueryInterface call on this object, attempting to dynamically cast it to the requested interface type. Returns Some(RefPtr) if the cast succeeded, and None otherwise.

impl RefCounted for nsIPrintSettingsService

unsafe fn addref(&self)

Increment the reference count.

unsafe fn release(&self)

Decrement the reference count, potentially freeing backing memory.

impl Deref for nsIPrintSettingsService

type Target = nsISupports

The resulting type after dereferencing.

fn deref(&self) -> &nsISupports

Dereferences the value.