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и pageRangeSelectionpageRange все ref параметры [ByRefв Visual Basic], которые инициализированы пользователем и возвращаются при закрытии диалогового окна, поэтому каждый представляет дополнительный возвращаемый элемент.)

Комментарии

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

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

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

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. (Параметр является параметром documentImageableArearef [ByRef в Visual Basic], который инициализирован методом, поэтому он представляет второй возвращаемый элемент.)

Комментарии

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

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

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

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

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 приложением.

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. (Параметр является параметром documentImageableArearef [ByRef в Visual Basic], который инициализирован методом, поэтому он представляет второй возвращаемый элемент.)

Комментарии

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

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

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

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и pageRangeSelectionpageRange все ref параметры [ByRefв Visual Basic], которые инициализированы пользователем и возвращаются при закрытии диалогового окна, поэтому каждый представляет дополнительный возвращаемый элемент.)

Комментарии

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

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

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