Printer.PrintAction - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает или задает значение, определяющее, куда выводятся данные: на принтер, в окно предварительного просмотра печати или в файл.

Пространство имен: Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6
Сборка: Microsoft.VisualBasic.PowerPacks.Vs (в Microsoft.VisualBasic.PowerPacks.Vs.dll)

Синтаксис

'Декларация
Public Property PrintAction As PrintAction
'Применение
Dim instance As Printer
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

public PrintAction PrintAction { get; set; }

public:
property PrintAction PrintAction {
    PrintAction get ();
    void set (PrintAction value);
}

public function get PrintAction () : PrintAction
public function set PrintAction (value : PrintAction)

Значение свойства

Тип: System.Drawing.Printing.PrintAction
Возвращает значение перечисления PrintAction.

Заметки

При выборе значения PrintToPrinter вывод осуществляется на принтер, используемый по умолчанию. Если принтер не установлен, происходит ошибка.

При выборе значения PrintToPreview вывод осуществляется через стандартный элемент управления PrintPreviewDialog.

При выборе значения PrintToFile вывод осуществляется в файл Encapsulated PostScript (с расширением EPS, PS или AI), путь к которому задан свойством PrintFileName. Если имя файла не указано, происходит ошибка. Файлы сохраняются в 8-битном формате PostScript (оттенки серого). 24-битный формат RGB PostScript не поддерживается.

Примечание.
Пользователю не предлагается указать путь к файлу или его расширение. Чтобы убедиться, что путь к файлу и расширение файла указаны правильно, можно использовать собственное диалоговое окно. Для этого перед вызовом метода Print следует использовать компонент SaveFileDialog, присваивая возвращаемое значение свойству PrintFileName.

Пользователю не предлагается указать путь к файлу или его расширение. Чтобы убедиться, что путь к файлу и расширение файла указаны правильно, можно использовать собственное диалоговое окно. Для этого перед вызовом метода Print следует использовать компонент SaveFileDialog, присваивая возвращаемое значение свойству PrintFileName.

В следующей таблице представлены значения PrintAction, которые допускается использовать для задания значения свойства PrintAction:

Имя перечисления	Описание
PrintToFile	Печать направляется в файл.
PrintToPreview	Печать направляется в диалоговое окно предварительного просмотра.
PrintToPrinter	Печать направляется на принтер.

Примечание.
Функции и объекты пространства имен Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 предназначены для использования инструментами обновления Visual Basic 6.0 до Visual Basic 2008. В большинстве случаев эти функции и объекты дублируют функциональные возможности, реализованные в других пространствах имен в .NET Framework. Они необходимы только в тех случаях, когда модель кода Visual Basic 6.0 значительно отличается от реализации .NET Framework.

Функции и объекты пространства имен Microsoft.VisualBasic.PowerPacks.Printing.Compatibility.VB6 предназначены для использования инструментами обновления Visual Basic 6.0 до Visual Basic 2008. В большинстве случаев эти функции и объекты дублируют функциональные возможности, реализованные в других пространствах имен в .NET Framework. Они необходимы только в тех случаях, когда модель кода Visual Basic 6.0 значительно отличается от реализации .NET Framework.

Примеры

В следующем примере демонстрируется, как задать свойство PrintAction. Пример требует наличия трех элементов управления RadioButton, которые дают пользователю возможность выбрать метод печати.

Dim Printer As New Printer
If RadioButton1.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPrinter
ElseIf RadioButton2.Checked = True Then
    Printer.PrintAction = Printing.PrintAction.PrintToPreview
Else
    Printer.PrintFileName = _ My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData _ 
    & "Form1.eps"
    Printer.PrintAction = Printing.PrintAction.PrintToFile
End If

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.