PrintQueue.CreateXpsDocumentWriter Metoda

Definice

Obor názvů:

System.Printing

Sestavení:

System.Printing.dll

Vytvoří objekt XpsDocumentWriter.

Přetížení

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a popisem tiskové úlohy a vrátí ref parametr (ByRef v jazyce Visual Basic), který představuje informace o obrázkové oblasti a rozměrech média.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o obrázkové oblasti a rozměrech média.
CreateXpsDocumentWriter(PrintQueue)	XpsDocumentWriter Vytvoří objekt a přidruží ho k zadané tiskové frontě.
CreateXpsDocumentWriter(Double, Double)	Vytvoří XpsDocumentWriter objekt se zadanými rozměry.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows (a poskytne mu popis úlohy) a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o oblasti s možností zobrazení obrázku a rozměrech média.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows, poskytne dialogové okno s rozsahem stránek a vrátí ref parametr (ByRef v jazyce Visual Basic), který představuje informace o oblasti s možností zobrazení a rozměrech média.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a popisem tiskové úlohy a vrátí ref parametr (ByRef v jazyce Visual Basic), který představuje informace o obrázkové oblasti a rozměrech média.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parametry

documentImageableArea

PrintDocumentImageableArea

Odkaz na objekt, který obsahuje rozměry oblasti stránky, na kterou může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, je tento parametr předán bez inicializace.

pageRangeSelection

PageRangeSelection

Hodnota, která určuje, zda se mají vytisknout všechny stránky nebo pouze rozsah určený uživatelem.

pageRange

PageRange

Rozsah stránek, který se vytiskne.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje data XPS do datového proudu. Může to být null. (Parametry documentImageableArea, pageRangeSelectiona pageRange jsou všechny ref parametry [ByRef v jazyce Visual Basic], které jsou inicializovány uživatelem a vráceny při zavření dialogového okna, takže každý představuje další vrácenou položku.)

Poznámky

Mnoho tiskáren potřebuje až čtvrtinu palce netisknutého místa kolem okrajů každé stránky, aby bylo možné uchopit papír a přesunout ho po tiskárně. Jinak by toner fauloval mechanismus toku papíru. Oblast, kterou lze vytisknout, je "obrazová oblast".

Typ PrintDocumentImageableArea nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a teprve pak předána metodě. Tato metoda zobrazí požadavek na PrintDialog vstup od uživatele. Uživatel nakonfiguruje svoji tiskovou úlohu v dialogovém okně (včetně výběru tiskárny, formátu papíru, orientace a rozsahu stránek). Když je dialogové okno zavřené pageRangeSelection a pageRange obsahuje hodnoty a documentImageableArea odkazuje na skutečný objekt, jehož vlastnosti jsou inicializovány.

Pokud uživatel zruší nebo zavře dialogové okno, vrátí se zpět hodnota null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.

Viz také

• isXPS Conformance Tool

CreateXpsDocumentWriter(PrintDocumentImageableArea)

XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o obrázkové oblasti a rozměrech média.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parametry

documentImageableArea

PrintDocumentImageableArea

Odkaz na objekt, který obsahuje rozměry oblasti stránky, na kterou může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, je tento parametr předán bez inicializace.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje data XPS do datového proudu. Může to být null. (Parametr documentImageableArea je ref parametr [ByRef v jazyce Visual Basic], který je inicializován metodou, takže představuje druhou vrácenou položku.)

Poznámky

Mnoho tiskáren potřebuje až čtvrtinu palce netisknutého místa kolem okrajů každé stránky, aby bylo možné uchopit papír a přesunout ho po tiskárně. Jinak by toner fauloval mechanismus toku papíru. Oblast, kterou lze vytisknout, je "obrazová oblast".

Typ PrintDocumentImageableArea nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a teprve pak předána metodě. Tato metoda zobrazí požadavek na PrintDialog vstup od uživatele. Jakmile uživatel vybere tiskárnu, formát papíru a orientaci a zavře dialogové okno, documentImageableArea ukáže na skutečný objekt a jeho vlastnosti se inicializují.

Pokud uživatel zruší nebo zavře dialogové okno, vrátí se zpět hodnota null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.

Viz také

• isXPS Conformance Tool

CreateXpsDocumentWriter(PrintQueue)

XpsDocumentWriter Vytvoří objekt a přidruží ho k zadané tiskové frontě.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintQueue ^ printQueue);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (System.Printing.PrintQueue printQueue);

static member CreateXpsDocumentWriter : System.Printing.PrintQueue -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (printQueue As PrintQueue) As XpsDocumentWriter

Parametry

printQueue

PrintQueue

Tisková fronta pro tisk dokumentu XPS.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje do datového proudu XPS.

Příklady

Následující příklad ukazuje, jak pomocí této metody vytvořit XpsDocumentWriter.

// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
///   Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
///   An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
    // Create a local print server
    LocalPrintServer ps = new LocalPrintServer();

    // Get the default print queue
    PrintQueue pq = ps.DefaultPrintQueue;

    // Get an XpsDocumentWriter for the default print queue
    XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
    return xpsdw;
}// end:GetPrintXpsDocumentWriter()

' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
'''   Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
'''   An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
    ' Create a local print server
    Dim ps As New LocalPrintServer()

    ' Get the default print queue
    Dim pq As PrintQueue = ps.DefaultPrintQueue

    ' Get an XpsDocumentWriter for the default print queue
    Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
    Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()

Viz také

• isXPS Conformance Tool

CreateXpsDocumentWriter(Double, Double)

Vytvoří XpsDocumentWriter objekt se zadanými rozměry.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);

static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriter

Parametry

width

Double

Šířka dokumentu XPS.

height

Double

Výška dokumentu XPS.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje do datového proudu XPS. Může to být null.

Poznámky

Tato metoda zobrazí požadavek na PrintDialog vstup od uživatele. Pokud uživatel zruší nebo zavře dialogové okno, vrátí se zpět hodnota null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.

Viz také

• isXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows (a poskytne mu popis úlohy) a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o oblasti s možností zobrazení obrázku a rozměrech média.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parametry

jobDescription

String

Název tiskové úlohy. Zobrazí se v tiskovém uživatelském rozhraní systému Windows.

documentImageableArea

PrintDocumentImageableArea

Odkaz na objekt, který obsahuje rozměry oblasti stránky, na kterou může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, je tento parametr předán bez inicializace.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje data XPS do datového proudu. Může to být null. (Parametr documentImageableArea je ref parametr [ByRef v jazyce Visual Basic], který je inicializován metodou, takže představuje druhou vrácenou položku.)

Poznámky

Mnoho tiskáren potřebuje až čtvrtinu palce netisknutého místa kolem okrajů každé stránky, aby bylo možné uchopit papír a přesunout ho po tiskárně. Jinak by toner fauloval mechanismus toku papíru. Oblast, kterou lze vytisknout, je "obrazová oblast".

Typ PrintDocumentImageableArea nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a teprve pak předána metodě. Tato metoda zobrazí požadavek na PrintDialog vstup od uživatele. Jakmile uživatel vybere tiskárnu, velikost papíru a orientaci a zavře dialogové okno, documentImageableArea ukáže na skutečný objekt a jeho vlastnosti se inicializují.

Pokud uživatel zruší nebo zavře dialogové okno, vrátí se zpět hodnota null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.

Viz také

• isXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

XpsDocumentWriter Vytvoří objekt, otevře dialogové okno běžného tisku systému Windows, poskytne dialogové okno s rozsahem stránek a vrátí ref parametr (ByRef v jazyce Visual Basic), který představuje informace o oblasti s možností zobrazení a rozměrech média.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parametry

jobDescription

String

Název tiskové úlohy. Zobrazí se v tiskovém uživatelském rozhraní systému Windows.

documentImageableArea

PrintDocumentImageableArea

Odkaz na objekt, který obsahuje rozměry oblasti stránky, na kterou může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, je tento parametr předán bez inicializace.

pageRangeSelection

PageRangeSelection

Hodnota, která určuje, zda se mají vytisknout všechny stránky nebo pouze rozsah určený uživatelem.

pageRange

PageRange

Rozsah stránek, který se vytiskne.

Návraty

XpsDocumentWriter

Objekt XpsDocumentWriter , který zapisuje data XPS do datového proudu. Může to být null. (Parametry documentImageableArea, pageRangeSelectiona pageRange jsou všechny ref parametry [ByRef v jazyce Visual Basic], které jsou inicializovány uživatelem a vráceny při zavření dialogového okna, takže každý představuje další vrácenou položku.)

Poznámky

Mnoho tiskáren potřebuje až čtvrtinu palce netisknutého místa kolem okrajů každé stránky, aby bylo možné uchopit papír a přesunout ho po tiskárně. Jinak by toner fauloval mechanismus toku papíru. Oblast, kterou lze vytisknout, je "obrazová oblast".

Typ PrintDocumentImageableArea nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a teprve pak předána metodě. Tato metoda zobrazí požadavek na PrintDialog vstup od uživatele. Uživatel nakonfiguruje svoji tiskovou úlohu v dialogovém okně (včetně výběru tiskárny, formátu papíru, orientace a rozsahu stránek). Když je dialogové okno zavřené pageRangeSelection a pageRange obsahuje hodnoty a documentImageableArea odkazuje na skutečný objekt, jehož vlastnosti jsou inicializovány.

Pokud uživatel zruší nebo zavře dialogové okno, vrátí se zpět hodnota null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.

Viz také

• isXPS Conformance Tool