PrintForm.PrintFileName プロパティ

2008-08-22

更新 : 2007 年 11 月

PrintAction プロパティが PrintToFile に設定されている場合、EPS (Encapsulated PostScript) ファイルの名前と保存場所のパスを取得または設定します。

名前空間 : 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 に設定されている場合、フォームのイメージは EPS (Encapsulated PostScript) ファイル (.eps、.ps、または .ai) に保存されます。PrintFileName プロパティにより、ファイルへのパスが指定されます。

メモ :
他のアプリケーションがファイルを PostScript ファイルとして認識できるようにするには、PrintFileName プロパティの中で、有効な PostScript ファイル名拡張子 (.eps、.ps、または .ai) を使用する必要があります。

PrintFileName を指定しないと、実行時にユーザーがファイル名を入力するように求められます。

メモユーザーがパスやファイル名拡張子の入力を求められることはありません。ファイルのパスと拡張子が適切であることを確認するために、独自のダイアログボックスを実装できます。これを行うには、Print メソッドの呼び出し前に、SaveFileDialog コンポーネントを使用し、その戻り値を PrintFileName プロパティに割り当てます。

例

以下の例では、ファイル名を入力するようユーザーに求めるダイアログボックスを表示した後、それを PrintFileName プロパティに割り当てる方法を示します。この例では、フォームに PrintForm1 という名前の PrintForm コンポーネントが必要です。

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