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

Статья
11/05/2008

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

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

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

Синтаксис

'Декларация
<BrowsableAttribute(True)> _
Public Property PrintAction As PrintAction
'Применение
Dim instance As PrintForm
Dim value As PrintAction

value = instance.PrintAction

instance.PrintAction = value

[BrowsableAttribute(true)]
public PrintAction PrintAction { get; set; }

[BrowsableAttribute(true)]
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 вывод осуществляется на принтер, используемый системой по умолчанию. Эту стандартную настройку можно изменить, явным образом задав принтер и свойства принтера с помощью свойства PrinterSettings. Если принтер по умолчанию недоступен, пользователю будет предложено выбрать принтер.

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

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

Примечание.
Файлы сохраняются в 8-битном формате PostScript (оттенки серого). 24-битный формат RGB PostScript не поддерживается.

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

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

Примеры

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

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

Разрешения

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