PrintQueue.CreateXpsDocumentWriter Метод

Ссылка

Определение

Пространство имен:: System.Printing

Сборка:: System.Printing.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Создает объект XpsDocumentWriter.

Перегрузки

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Создает объект XpsDocumentWriter, открывает стандартный диалог печати Windows, передает в него диапазон страниц и описание задания печати и возвращает параметр `ref` (`ByRef` в Visual Basic), представляющий сведения об области печати и размерах носителя.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows и возвращает параметр `ref` (`ByRef` в Visual Basic), представляющий сведения об области печати и размерах носителя.
CreateXpsDocumentWriter(PrintQueue)	Создает объект XpsDocumentWriter и связывает его с указанной очередью печати.
CreateXpsDocumentWriter(Double, Double)	Создает объект XpsDocumentWriter с указанными размерами.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows (и передает в него описание задания) и возвращает параметр `ref` (`ByRef` в Visual Basic), представляющий сведения об области печати и размерах носителя.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows, передает в него диапазон страниц и возвращает параметр `ref` (`ByRef` в Visual Basic), представляющий сведения об области печати и размерах носителя.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартный диалог печати Windows, передает в него диапазон страниц и описание задания печати и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

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

Параметры

documentImageableArea: PrintDocumentImageableArea

Ссылка на объект, который содержит размеры области станицы, на которой устройство может печатать. Этот параметр передается неинициализированным, потому что у его типа данных нет открытого конструктора.

pageRangeSelection: PageRangeSelection

Значение, указывающее, необходимо ли печатать все страницы или только диапазон, заданный пользователем.

pageRange: PageRange

Печатаемый диапазон страниц.

Возвращаемое значение

XpsDocumentWriter

Объект XpsDocumentWriter, осуществляющий запись данных XPS в поток. Это может быть null. (Все параметры documentImageableArea, pageRangeSelection и pageRange являются параметрами ref [ByRef в Visual Basic], которые инициализируются пользователем и возвращаются при закрытии диалогового окна, поэтому каждый из них представляет собой дополнительный возвращаемый элемент.)

Атрибуты: SecurityCriticalAttribute

Многим принтерам требуется до четверти дюйма непечатаемого пространства по краям каждой страницы, чтобы схватить бумагу и переместить ее через принтер. В противном случае тонер будет сорвать механизм потока бумаги. Область, которая может быть напечатана, является "доступной для изображения областью".

Тип PrintDocumentImageableArea не имеет открытого конструктора. Таким образом, переменная documentImageableArea должна быть объявлена и назначена null и только затем передана в метод . Этот метод отображает обязательные PrintDialog входные данные от пользователя. Пользователь настраивает задание печати в диалоговом окне (включая выбор принтера, размера бумаги, ориентации и диапазона страниц). Если диалоговое окно закрыто и pageRangeSelectionpageRange имеет значения, и documentImageableArea указывает на фактический объект, свойства которого инициализированы.

Если пользователь отменяет или закрывает диалоговое окно, возвращается nullзначение . Как следствие, возвращаемое значение должно быть проверено null приложением.

См. также раздел

Средство соответствия isXPS

Применяется к

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

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

Параметры

documentImageableArea: PrintDocumentImageableArea

Возвращаемое значение

XpsDocumentWriter

Объект XpsDocumentWriter, осуществляющий запись данных XPS в поток. Это может быть null. (Параметр documentImageableArea является ref [ByRef в Visual Basic] параметром, который инициализируется методом и представляет собой второй возвращаемый элемент.)

Атрибуты: SecurityCriticalAttribute

Тип PrintDocumentImageableArea не имеет открытого конструктора. Таким образом, переменная documentImageableArea должна быть объявлена и назначена null и только затем передана в метод . Этот метод отображает обязательные PrintDialog входные данные от пользователя. После того как пользователь выберет принтер, размер бумаги и ориентацию и закрыл диалоговое окно, documentImageableArea указывает на фактический объект и его свойства инициализируются.

См. также раздел

Средство соответствия isXPS

Применяется к

CreateXpsDocumentWriter(PrintQueue)

Создает объект XpsDocumentWriter и связывает его с указанной очередью печати.

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

Параметры

printQueue: PrintQueue

Очередь для печати документа XPS.

Возвращаемое значение

XpsDocumentWriter

Объект XpsDocumentWriter, осуществляющий запись в поток XPS.

Примеры

В следующем примере показано, как использовать этот метод для создания 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()

См. также раздел

Средство соответствия isXPS

Применяется к

CreateXpsDocumentWriter(Double, Double)

Создает объект XpsDocumentWriter с указанными размерами.

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

Параметры

width: Double

Ширина документа XPS.

height: Double

Высота документа XPS.

Возвращаемое значение

XpsDocumentWriter

Объект XpsDocumentWriter, осуществляющий запись в поток XPS. Это может быть null.

Атрибуты: SecurityCriticalAttribute

Этот метод отображает обязательные PrintDialog входные данные от пользователя. Если пользователь отменяет или закрывает диалоговое окно, возвращается nullзначение . Как следствие, возвращаемое значение должно быть проверено null приложением.

См. также раздел

Средство соответствия isXPS

Применяется к

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows (и передает в него описание задания) и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

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

Параметры

jobDescription: String

Имя для задания печати. Оно отображается в пользовательском интерфейсе печати Windows.

documentImageableArea: PrintDocumentImageableArea

Возвращаемое значение

XpsDocumentWriter

Атрибуты: SecurityCriticalAttribute

Тип PrintDocumentImageableArea не имеет открытого конструктора. Таким образом, переменная documentImageableArea должна быть объявлена и назначена null и только затем передана в метод . Этот метод отображает обязательные PrintDialog входные данные от пользователя. После того как пользователь выберет принтер, размер бумаги и ориентацию и закрыл диалоговое окно, documentImageableArea указывает на фактический объект, и его свойства инициализируются.

См. также раздел

Средство соответствия isXPS

Применяется к

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows, передает в него диапазон страниц и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

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

Параметры

jobDescription: String

Имя для задания печати. Оно отображается в пользовательском интерфейсе печати Windows.

documentImageableArea: PrintDocumentImageableArea

pageRangeSelection: PageRangeSelection

Значение, указывающее, необходимо ли печатать все страницы или только диапазон, заданный пользователем.

pageRange: PageRange

Печатаемый диапазон страниц.

Возвращаемое значение

XpsDocumentWriter

Атрибуты: SecurityCriticalAttribute

См. также раздел

Средство соответствия isXPS

Применяется к

Поделиться через

PrintQueue.CreateXpsDocumentWriter Метод

Определение

Перегрузки

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Параметры

Возвращаемое значение

Комментарии

См. также раздел

Применяется к

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Параметры

Возвращаемое значение

Комментарии

См. также раздел

Применяется к

CreateXpsDocumentWriter(PrintQueue)

Параметры

Возвращаемое значение

Примеры

См. также раздел

Применяется к

CreateXpsDocumentWriter(Double, Double)

Параметры

Возвращаемое значение

Комментарии

См. также раздел

Применяется к

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Параметры

Возвращаемое значение

Комментарии

См. также раздел

Применяется к

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Параметры

Возвращаемое значение

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы