IFileOpenDialog::GetSelectedItems メソッド (shobjidl_core.h)

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

構文

HRESULT GetSelectedItems(
  [out] IShellItemArray **ppsai
);

パラメーター

[out] ppsai

種類: IShellItemArray**

選択した項目にアクセスできる IShellItemArray へのポインターのアドレス。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、1 つの項目または複数の項目の選択に使用できます。 ユーザーがファイル名フィールドに新しいテキストを入力した場合は、時間のかかる操作になる可能性があります。 アプリケーションがこのメソッドを呼び出すと、 フィールド内のテキストが filename 解析されます。 たとえば、これがネットワーク共有の場合、操作に時間がかかる可能性があります。 ただし、ユーザーが操作を停止でき、 IFileOpenDialog::GetSelectedItems によってエラー コードが返されるため、この操作によって UI がブロックされることはありません。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)