IFileDialog::SetFilter メソッド (shobjidl_core.h)

  • [アーティクル]

[非推奨。 SetFilter は Windows 7 以降では使用できません。

フィルターを設定します。

構文

HRESULT SetFilter(
  IShellItemFilter *pFilter
);

パラメーター

pFilter

種類: IShellItemFilter*

設定する IShellItemFilter へのポインター。

戻り値

型: HRESULT

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

注釈

このメソッドは、アプリケーションで特別なフィルター処理を実行して、ダイアログ ボックスのビューから一部の項目を削除する必要がある場合に使用できます。 IncludeItem は、通常はビューに含まれるアイテムごとに呼び出されます。 GetEnumFlagsForItem は使用されません。 ファイルの種類でフィルター処理するには、 IFileDialog::SetFileTypes を使用する必要があります。アイテム数が多いフォルダーでは、 IShellItemFilter を適用するよりもパフォーマンスが向上する可能性があるためです。

要件

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