IShellFolderView::GetArrangeParam メソッド (shlobj_core.h)

  • [アーティクル]

ビューの配置パラメーターを取得します。ビューの並べ替え方法です。

メモ このメソッドは、Windows Vista の時点では非推奨です。 それ以降のバージョンの Windows では、変更または使用できない可能性があります。 代わりに IFolderView2::GetSortColumns を 使用することをお勧めします。
 

構文

HRESULT GetArrangeParam(
  [out] LPARAM *plParamSort
);

パラメーター

[out] plParamSort

種類: LPARAM*

plParamSort の下位 16 ビットは、並べ替え規則を定義します。 ほとんどのアプリケーションでは、並べ替えルールを既定値の 0 に設定し、項目を名前で並べ替える必要があることを示します。 システムは、他の並べ替えルールを定義しません。 一部のフォルダー オブジェクトでは、呼び出し元のアプリケーションで plParamSort の下位 16 ビットを使用して、フォルダー固有の並べ替え規則を指定できる場合があります。 ルールとそれに関連付けられている plParamSort 値は、 フォルダーによって定義されます。

システム フォルダー ビュー オブジェクトが IShellFolderView::GetArrangeParam を呼び出すと、 plParamSort の下位 16 ビットを使用して、配置に使用する列が指定されます。

並べ替え規則を変更するフラグには、 plParamSort の上位 16 ビットが使用されます。 現在、システムは次の修飾子フラグを定義しています。

SHCIDS_ALLFIELDS

バージョン 5.0。 表示名だけでなく、 ITEMIDLIST 構造体に含まれるすべての情報を配置します。 このフラグは、 IShellFolder2 インターフェイスをサポートするフォルダー オブジェクトに対してのみ有効です。 たとえば、2 つの項目がファイルの場合、フォルダーは構造体内の名前、サイズ、ファイル時刻、属性、およびその他の情報を配置します。 このフラグが設定されている場合、 plParamSort の下位 16 ビットは 0 である必要があります。

SHCIDS_CANONICALONLY

バージョン 5.0。 名前で並べ替えるときは、システム名を配置しますが、表示名は配置しないでください。 このフラグが渡されると、2 つの項目は、一貫性のある並べ替え関数を実装している限り、Shell フォルダーが最も効率的であると判断する条件によって配置されます。 このフラグを他のフラグと組み合わせることはできません。

戻り値

型: HRESULT

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shlobj_core.h