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

Статья
11/05/2008

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

Возвращает или задает имя файла Encapsulated PostScript и путь, по которому файл будет сохраняться, если свойству PrintAction присвоено значение PrintToFile.

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

Синтаксис

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

value = instance.PrintFileName

instance.PrintFileName = value

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

[BrowsableAttribute(true)]
public:
property String^ PrintFileName {
    String^ get ();
    void set (String^ value);
}

public function get PrintFileName () : String
public function set PrintFileName (value : String)

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

Тип: System.String
Возвращает значение типа String, которое содержит путь и имя файла.

Заметки

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

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

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

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

Примеры

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

Dim fileDialog As New Windows.Forms.SaveFileDialog
Dim fileToSave As String
fileDialog.Title = "Save to PostScript file"
fileDialog.AddExtension = True
fileDialog.Filter = "Encapsulated PostScript (*.eps)|"
fileDialog.InitialDirectory = _
  My.Computer.FileSystem.SpecialDirectories.CurrentUserApplicationData
fileDialog.ShowDialog()
fileToSave = fileDialog.FileName & ".eps"
PrintForm1.PrintFileName = filePath

Разрешения

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