PrintQueue.CreateXpsDocumentWriter Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří objekt XpsDocumentWriter.
Přetížení
| Name | Description |
|---|---|
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a popisem tiskové úlohy a vrátí |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows a vrátí |
| CreateXpsDocumentWriter(PrintQueue) |
XpsDocumentWriter Vytvoří objekt a přidruží ho k zadané tiskové frontě. |
| CreateXpsDocumentWriter(Double, Double) |
XpsDocumentWriter Vytvoří objekt se zadanými dimenzemi. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows (a poskytne ho popis úlohy) a vrátí |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a vrátí |
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a popisem tiskové úlohy 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, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref 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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
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 které může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, tento parametr je předán neinicializován.
- 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é jsou vytištěny.
Návraty
Zápis XpsDocumentWriter dat XPS do datového proudu. To může být null. (Parametry documentImageableArea, pageRangeSelectiona pageRange jsou všechny ref [ByRef v jazyce Visual Basic] parametry, 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.)
- Atributy
Poznámky
Mnoho tiskáren potřebuje až čtvrtinu palce netisknutelného prostoru kolem okrajů každé stránky, aby papír uchopil a prošel tiskárnou. Jinak by toner zastřelil mechanismus toku papíru. Oblast, kterou lze vytisknout, je "oblast s možností obrázku".
PrintDocumentImageableArea Typ nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a následně předána metodě. Tato metoda zobrazí PrintDialog požadavek na vstup od uživatele. Uživatel nakonfiguruje svoji tiskovou úlohu v dialogovém okně (včetně výběru tiskárny, velikosti papíru, orientace a rozsahu stránek). Při zavření pageRangeSelection dialogového okna a pageRange obsahují hodnoty a documentImageableArea odkazuje na skutečný objekt, jehož vlastnosti jsou inicializovány.
Pokud uživatel zruší nebo zavře dialogové okno, vrátí hodnotu null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.
Platí pro
CreateXpsDocumentWriter(PrintDocumentImageableArea)
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o oblasti s možností obrázku a rozměrech média.
public:
static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
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 které může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, tento parametr je předán neinicializován.
Návraty
Zápis XpsDocumentWriter dat XPS do datového proudu. To může 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.)
- Atributy
Poznámky
Mnoho tiskáren potřebuje až čtvrtinu palce netisknutelného prostoru kolem okrajů každé stránky, aby papír uchopil a prošel tiskárnou. Jinak by toner zastřelil mechanismus toku papíru. Oblast, kterou lze vytisknout, je "oblast s možností obrázku".
PrintDocumentImageableArea Typ nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a následně předána metodě. Tato metoda zobrazí PrintDialog požadavek na vstup od uživatele. Po výběru tiskárny, formátu papíru a orientace a zavření dialogového okna documentImageableArea odkazuje na skutečný objekt a jeho vlastnosti se inicializují.
Pokud uživatel zruší nebo zavře dialogové okno, vrátí hodnotu null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.
Platí pro
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
Zápis XpsDocumentWriter do datového proudu XPS.
Příklady
Následující příklad ukazuje, jak použít tuto metodu XpsDocumentWriterk vytvoření .
// -------------------- 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()
Platí pro
CreateXpsDocumentWriter(Double, Double)
XpsDocumentWriter Vytvoří objekt se zadanými dimenzemi.
public:
static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref double width, ref double height);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref double width, ref double height);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter
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
Zápis XpsDocumentWriter do datového proudu XPS. To může být null.
- Atributy
Poznámky
Tato metoda zobrazí PrintDialog požadavek na vstup od uživatele. Pokud uživatel zruší nebo zavře dialogové okno, vrátí hodnotu null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.
Platí pro
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows (a poskytne ho popis úlohy) a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o oblasti s možností obrázku a rozměrech média.
public:
static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);
[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
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 uživatelském rozhraní pro tisk ve Windows.
- documentImageableArea
- PrintDocumentImageableArea
Odkaz na objekt, který obsahuje rozměry oblasti stránky, na které může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, tento parametr je předán neinicializován.
Návraty
Zápis XpsDocumentWriter dat XPS do datového proudu. To může 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.)
- Atributy
Poznámky
Mnoho tiskáren potřebuje až čtvrtinu palce netisknutelného prostoru kolem okrajů každé stránky, aby papír uchopil a prošel tiskárnou. Jinak by toner zastřelil mechanismus toku papíru. Oblast, kterou lze vytisknout, je "oblast s možností obrázku".
PrintDocumentImageableArea Typ nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a následně předána metodě. Tato metoda zobrazí PrintDialog požadavek na 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í hodnotu null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.
Platí pro
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)
XpsDocumentWriter Vytvoří objekt, otevře dialogové okno společného tisku systému Windows, zobrazí dialogové okno s rozsahem stránek a vrátí ref parametr (ByRefv jazyce Visual Basic), který představuje informace o oblasti s možností obrázku 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);
[System.Security.SecurityCritical]
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);
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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter
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 uživatelském rozhraní pro tisk ve Windows.
- documentImageableArea
- PrintDocumentImageableArea
Odkaz na objekt, který obsahuje rozměry oblasti stránky, na které může zařízení tisknout. Vzhledem k tomu, že jeho datový typ nemá žádný veřejný konstruktor, tento parametr je předán neinicializován.
- 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é jsou vytištěny.
Návraty
Zápis XpsDocumentWriter dat XPS do datového proudu. To může být null. (Parametry documentImageableArea, pageRangeSelectiona pageRange jsou všechny ref [ByRef v jazyce Visual Basic] parametry, 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.)
- Atributy
Poznámky
Mnoho tiskáren potřebuje až čtvrtinu palce netisknutelného prostoru kolem okrajů každé stránky, aby papír uchopil a prošel tiskárnou. Jinak by toner zastřelil mechanismus toku papíru. Oblast, kterou lze vytisknout, je "oblast s možností obrázku".
PrintDocumentImageableArea Typ nemá žádný veřejný konstruktor. Proto musí být proměnná documentImageableArea deklarována a přiřazena null a následně předána metodě. Tato metoda zobrazí PrintDialog požadavek na vstup od uživatele. Uživatel nakonfiguruje svoji tiskovou úlohu v dialogovém okně (včetně výběru tiskárny, velikosti papíru, orientace a rozsahu stránek). Při zavření pageRangeSelection dialogového okna a pageRange obsahují hodnoty a documentImageableArea odkazuje na skutečný objekt, jehož vlastnosti jsou inicializovány.
Pokud uživatel zruší nebo zavře dialogové okno, vrátí hodnotu null. V důsledku toho musí být vrácená hodnota zkontrolována null vaší aplikací.