ファイルまたはディレクトリを指定できるダイアログボックスを表示します。

このダイアログボックスを使用すると、既存のファイルまたはディレクトリを選択したり、新規のファイルまたはディレクトリの位置および名前を選択できます。

(macOS) このVIは、macOS特有のファイルのデフォルトアプリケーションの指定方法を認識しません。ただし、パターン入力を使用して、ファイル名に拡張子を含むファイルのファイルタイプを指定できます。


icon

ダイアログボックスオプション

オプション 説明
単一項目選択に制限

ユーザは1つまたは複数のファイルを選択できます。このオプションの選択を解除すると、ユーザが選択可能なファイルまたはフォルダタイプのオプションが淡色表示されます。

  • ファイルまたはフォルダ
    次のオプションがあります。
    • ファイル—ユーザは1つのファイルのみを選択できます。
    • フォルダ—ユーザは1つのフォルダのみを選択できます。
    • ファイルまたはフォルダ—ファイルまたはフォルダのいずれかを選択できます。
  • 新規または既存
    次のオプションがあります。
    • 既存—ユーザは既存のファイルまたはフォルダのみを選択できます。
    • 新規—ユーザは新しいファイルまたはフォルダの名前の入力のみを行えます。
    • 新規または既存—ユーザは既存のファイルやフォルダを選択するか、新しいファイルやフォルダを作成できます。
llbおよびlvlibp内にあるファイルの選択を許可

LLBまたはパックライブラリからファイルを選択できるように指定します。このチェックボックスがオフの場合、LLBまたはパックライブラリを選択することは可能ですが、LLBまたはパックライブラリ内のファイルを選択することはできません。

メモ ファイル・ダイアログ・エクスプレスVIを使用してLLBまたはパックされたライブラリを選択するには、 LLBおよびパックされたプロジェクト・ライブラリのファイルの選択を許可する チェックボックスのチェックを外し、ファイル・ダイアログ・ボックスからLLBまたはパックされたライブラリを選択します。または、llbおよびlvlibp内にあるファイルの選択を許可チェックボックスをオンにし、ファイルまたはフォルダオプションボタンを選択し、ファイルダイアログボックスでLLBまたはパックライブラリを選択して、表示される2番目のファイルダイアログボックスのファイルリストから2番目のフォルダアイコンを選択します。

入力/出力

  • cstr.png ボタンラベル

    ファイルダイアログボックスにあるOKまたは現在のディレクトリボタンに表示するラベルです。Express VIでユーザがディレクトリを選択できるように設定している場合は、この入力を使用して現在のディレクトリボタンのラベルを指定します。ユーザがディレクトリを選択できないよう設定している場合は、この入力を使用して、OKボタンのラベルを指定します。

    たとえば、構成ダイアログボックスでファイルのみを選択する場合、ユーザはデータを追加する既存ファイルを選択する必要があるため、追加ボタンラベルに配線するとよい場合があります。

    ボタンラベルがそのボタンの幅よりも長い場合、ファイルダイアログボックスはラベル全体を表示しません。たとえば、英語バージョンのWindowsでは、ボタンは約11文字の幅になります。

  • cstr.png パターン (すべてのファイル)

    ダイアログボックスに表示されるファイルを名前がパターン (すべてのファイル) に一致するファイルに制限します。パターン (すべてのファイル) は表示されるディレクトリを制限しません。

    このVIのパターンマッチングは、WindowsおよびLinuxで使用するファイル名のワイルドカードマッチング法と似ています。疑問符 (?) またはアスタリスク (*) 以外の文字を指定すると、このVIではそれらの文字が含まれているファイルまたはディレクトリのみを表示します。疑問符 (?) を指定して、任意の1文字と一致させることができます。アスタリスク (*) を指定すると、文字がない、または複数の文字のシーケンスと一致させることができます。

    たとえば、*.vi;test*.llbパターン (すべてのファイル) は、.viの拡張子のあるファイルのすべて、およびtestで始まるファイル名で.llbの拡張子のあるファイルのすべての一致を返します。

    複数のパターンを一致させるには、セミコロン (;) でパターンを区切ります。空白、タブ、復帰などの空白文字は、文字通りに扱われます。拡張子パターンの一部でない限り、空白文字は使用しないでください。たとえば、*.html;*.docを使用した場合、ダイアログボックスに.htmlおよび.docで終了するファイルのすべてが表示されます。*.html; *.docを使用すると、.htmlで終了するファイルのみがダイアログボックス表示されます。

  • cpath.png 開始パス

    ファイルダイアログボックスで、LabVIEWで最初に表示されるディレクトリのパスです。

    開始パスは有効でも、既存のディレクトリを基準としていない場合、Lパスが有効なディレクトリパスまたは空のパスになるまで、LabVIEWはパスの末端から名前を削除します。開始パスが無効または未配線の場合、ファイルダイアログボックスで参照された最後のディレクトリが最初にダイアログボックスに表示されます。

  • cstr.png デフォルト名

    初期ファイル名またはディレクトリ名としてダイアログボックスに表示される名前です。

    デフォルトは空の文字列です。

  • cerrcodeclst.png エラー入力

    このノードの実行前に発生したエラーの状態を示します。

  • cstr.png プロンプト

    ファイルダイアログボックスのタイトルとして表示されるカスタムメッセージです。(WindowsおよびLinux) デフォルトダイアログボックスのタイトルはファイルのパスを選択または入力です。(macOS) デフォルトのダイアログボックスはファイルを選択または新規ファイルを作成です。

  • cstr.png パターンラベル

    カスタムパターンの隣にあるファイルダイアログボックスに表示するラベルです。

    この入力を配線しない場合、または入力に空文字列が含まれている場合、任意のカスタムパターンの横にあるデフォルトのラベルはカスタムパターンです。文字列をパターンへ配線しない場合、LabVIEWはこの入力を無視します。

  • ierrcodeclst.png エラー出力

    エラー情報が含まれています。この出力は、標準エラー出力として機能します。

  • ipath.png 選択されたパス

    このダイアログボックスを使用して選択されたファイルまたはディレクトリの完全パスです。

    ダイアログボックスをキャンセルすると、VIは選択されたパス<無効パス>に設定します。この出力は、 Configure File Dialog ダイアログボックスの Limit selection to single item チェックボックスにチェックマークを入れた場合に利用できます。

  • ibool.png 存在する

    選択されたパスで特定のファイルまたはディレクトリを指定する場合は、TRUEになります。

  • ibool.png キャンセルされた

    ダイアログボックスをキャンセルすると、TRUEになります。

  • i1dpath.png 選択されたパス

    このダイアログボックスを使用して、選択されたファイルまたはディレクトリの完全パスの名前を含みます。ファイルダイアログを構成ダイアログボックスの単一項目選択に制限にチェックマークを付けない場合、この出力は有効です。