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);

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

Параметры

documentImageableArea

PrintDocumentImageableArea

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

pageRangeSelection

PageRangeSelection

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

pageRange

PageRange

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

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

XpsDocumentWriter

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

Комментарии

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

Тип 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);

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

Параметры

documentImageableArea

PrintDocumentImageableArea

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

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

XpsDocumentWriter

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

Комментарии

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

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

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

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

• Средство соответствия 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);

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

Параметры

width

Double

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

height

Double

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

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

XpsDocumentWriter

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

Комментарии

Этот метод отображает обязательные 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);

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

Параметры

jobDescription

String

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

documentImageableArea

PrintDocumentImageableArea

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

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

XpsDocumentWriter

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

Комментарии

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

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

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

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

• Средство соответствия 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);

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

Параметры

jobDescription

String

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

documentImageableArea

PrintDocumentImageableArea

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

pageRangeSelection

PageRangeSelection

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

pageRange

PageRange

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

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

XpsDocumentWriter

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

Комментарии

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

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

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

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

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