IFileOpenDialog_GetSelectedItems

ダイアログで現在選択されているアイテムを取得する。これらのアイテムはビュー内で選択されているものや、ファイル名編集ボックスで選択されているテキストである場合がある。

IFileOpenDialog_GetSelectedItems this, ppsai

this : [comobj] IFileOpenDialog インターフェースの COM オブジェクト変数
ppsai : [comobj] 型: IShellItemArray** 選択されたアイテムにアクセスするための IShellItemArray へのポインターのアドレス。

(プラグイン / モジュール : com_misc.dll)

解説

ダイアログで現在選択されているアイテムを取得する。これらのアイテムはビュー内で選択されているものや、ファイル名編集ボックスで選択されているテキストである場合がある。

[戻り値]
型: HRESULT このメソッドが成功した場合 S_OK を返す。そうでなければ HRESULT エラーコードを返す。

[備考]

このメソッドは単一アイテム選択にも複数アイテム選択にも使用できる。ユーザーがファイル名フィールドに新しいテキストを入力している場合、この操作は時間がかかる可能性がある。アプリケーションがこのメソッドを呼び出すと、アプリケーションはファイル名フィールドのテキストを解析する。例えばネットワーク共有の場合、この操作にはある程度時間がかかることがある。ただしこの操作は
UI をブロックしない。ユーザーは操作を停止でき、その結果 IFileOpenDialog::GetSelectedItems
は失敗コードを返すことになる。

情報