プログラム言語 FreeBasic |
OpenFileRequester
構文:Function OpenFileRequester(ByRef Title As String, ByRef curentdir As String, ByRef Pattern As String = "All files(*.*)"+Chr(0)+"*.*"+Chr(0), ByVal flag As Integer=0, ByRef templateName As String = "", ByVal hParentWin as HWND = 0) As String
templateName - ダイアログに表示されるデフォルトファイルの名前。このファイルは、関数の結果に割り当てることができます。
hParentWin - 親ウィンドウのハンドル
Windows , Linux
Linux と Windows で:
OFN_ALLOWMULTISELECT - ダイアログボックスで、一度に複数のファイルを(ShiftキーとCtrlキーを使用して)選択することができます。
このフラグで OFN_EXPLORER を指定すると、ダイアログは、エクスプローラ・スタイルのインターフェイスのダイアログになります。これ以外の場合は、古いスタイルのダイアログが表示されます。
複数のファイルのユーザー vibiraet 場合、パラメータ lpstrFile は、選択したファイルの名前に続いて、カレントディレクトリへのパスを返します。このパラメータは、最初のファイル名の nFileOffset シフト(オフセット)を指定し、パラメータが nFileExtension を使用されません。
このようなエクスプローラ・スタイル・ファイルのパスと、ファイル名は、ダイアログの最後のファイル名の後に追加の NULL 文字でゼロ(NULL)文字で区切られています。パスとファイル名を分割するためにヌル文字を使うためには、エクスプローラ風のダイアログでは、スペースを使ってファイル名の型を返すことができます。
古いスタイルのダイアログでは、パスとファイル名に名前にスペースが入っている短い(8.3)ファイル名を使用して、スペースと機能で区切られています。短期間で長いファイル名を変換するために、FindFirstFile を使うことができます。
Linux のみ:
OFN_DIRECTORY - フォルダを選択します
Windows のみ:
OFN_CREATEPROMPT -
ユーザーが、そこに存在しないファイルを指定すると、ダイアログは、指定された名前を持つ新しいファイルを作成するかどうか聞いてきます。ユーザーが新しいファイルの作成を選ぶと、ダイアログは閉じて、示された名前を返します。そうでない場合は、ダイアログは開いたままになります。
OFN_ENABLEHOOK -
パラメータ lpfnHook で定義された横取りの手続きを使えるようにします。
OFN_ENABLETEMPLATE -
このパラメータは、パラメータ hInstance の変数で指定されたモジュールが、リソース lpTemplateName ダイアログ・テンプレートを指していることを示しています。
OFN_ENABLETEMPLATEHANDLE -
パラメータ hInstance が、プリインストールされたテンプレートであるデータ・ブロックを識別することを示しています。
OFN_EXTENSIONDIFFERENT -
ユーザーが、パラメータ lpstrDefExt で使われる拡張子と異なる拡張子を入力したことを示しています。フラグ lpstrDefExt が NULL の場合、このフラグは、使用されません。
OFN_FILEMUSTEXIST -
ユーザーが、ダイアログ内の入力フィールド "ファイル名"に、既存のファイルの名前だけを入力できることを指定します。このフラグが指定され、ユーザーが無効なファイル名を入力すると、警告メッセージが表示されます。このオプションが指定されている場合、OFN_PATHMUSTEXIST フラグも使用されます。
OFN_HIDEREADONLY -
ダイアログで、 "読み取り専用"を非表示にします。
OFN_LONGNAMES -
古いスタイルのダイアログのため。このフラグは、長いファイル名の使用を指定します。このフラグを指定しないか、OFN_ALLOWMULTISELECT フラグが選ばれていると、ダイアログボックスは、スペースを含むファイルの短い名前(8.3)の古いスタイルの形式を使用します。エクスプローラ・スタイルのダイアログは、このフラグを無視し、常に長い名前を表示します。
OFN_NOCHANGEDIR - ユーザーが、範囲の検索で1つのフォルダから別のフォルダに移動した場合、現在のフォルダの初期値を設定します。
OFN_NODEREFERENCELINKS -
ダイアログに、ショートカット(LNK)のパスとファイル名を返すように示します。このフラグが設定されていない場合、ダイアログは、ショートカット先へのパスとファイル名を返します。
OFN_NOLONGNAMES -
古いスタイルのダイアログ。このフラグは、短い名前(8.3形式)を使用してダイアログボックスを引き起こします。エクスプローラ形式のダイアログは、このダイアログを無視して、常に長い名前を示します。
OFN_NONETWORKBUTTON -
ダイアログの"ネットワーク"ボタンを削除または無効にします。
OFN_NOREADONLYRETURN -
ダイアログは、選択したファイルに、"読み取り専用"フィールドが含まれておらず、かつ、コピープロテクトされたフォルダにあるわけではないことを指定します。
OFN_NOTESTFILECREATE -
ダイアログが閉じているとき、ファイルが作成されないことを指定します。アプリケーションは、権利の存在下でファイルに保存 "を作成するためになく変更することはありません"(nonmodify ネットワーク共有ポイント作成)ネットワーク内の場合、このフラグを指定する必要があります。
このフラグが ispolzrvanii だと、ドライブの完全な書き込み保護を確認するために実行されていない場合は、ディスクが挿入またはネットワークアクセス保護されています。このとき、アプリケーションで、ファイルを開くには、この操作を使用することは非常に注意しなければなりません。ファイルが閉じられた場合、ファイルを再び開くことはできません。
OFN_NOVALIDATE -
これは、入力ファイル名に無効な文字を使用することができるようにします。
通常、横取り(フック)プロセスが FILEOKSTRING を呼び出すことによって、ファイル名前の正しさをチェックします。
ファイル名の入力フィールドの[選択]ダイアログボックスが空または空白で満たされている場合は、ファイルとフォルダのリストが更新されます。
ボックスに、何か他のものが含まれている場合は、パラメータと nFileOffset および nFileExtension の値は、テキストを解析することによって設定します。この場合、テキストはデフォルトで、任意の拡張子またはパラメータ lpstrFileTitle で指定されたテキスト・バッファに追加されません。正しく nFileOffset の値が0より小さい場合、ファイル名を指定します。それ以外の場合は、名前は、nFileExtension が考慮され、OFN_NOVALIDATE フラグを指定されなかったように、 nFileOffset は使われます。(つまり、いつものように)
OFN_OVERWRITEPROMPT -
ファイルが既に存在する場合は、ダイアログが "名前を付けて保存"するように警告メッセージを発行します。ユーザーは、ファイルの上書きを確認する必要があります。
OFN_PATHMUSTEXIST -
ユーザーが、既存のパスとファイル名を指定できるようにします。ユーザーが不正なファイル名を指定すると、警告ウインドウが表示されます。
OFN_READONLY -
このフラグを使うと、ダイアログを作成するときにダイアログを選択するとき、 "読み取り専用"チェックボックスが選択されます。ダイアログが閉じているときは、このフラグは、フィールド "読み取り専用"ダイアログの状態を示します。
OFN_SHAREAWARE -
OpenFile 関数への呼び出しが、ネットワークへのアクセスの不足のため失敗した場合、このエラーを無視して、ダイアログは、選択したファイルの名前を返すことを指定します。
このフラグが設定されていない場合、ダイアログは、ネットワークリソース(ファイル)にアクセスが発生したエラーを、横取り(フック)の手続きに報告します。
OFN_SHOWHELP -
ダイアログ ボックスに [ヘルプ] ボタンを表示します。
hwndOwner パラメータは、ユーザーが [ヘルプ] ボタンを押すとき、ダイアログによって送られるメッセージ HELPMSGSTRING を受取るウインドウを指定する必要があります。