IShellFolder2::GetDefaultColumn メソッド (shobjidl_core.h)

既定の並べ替え列と表示列を取得します。

構文

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

パラメーター

[in] dwRes

型: DWORD

予約済み。 0 に設定します。

[out] pSort

種類: ULONG*

既定の並べ替えられた列のインデックスを受け取る値へのポインター。

[out] pDisplay

種類: ULONG*

既定の表示列のインデックスを受け取る値へのポインター。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合は COM エラー値を返します。

注釈

ユーザーへのメモ

このメソッドによって返される両方の列インデックスは、このフォルダーのフォルダー ビューを表示するアプリケーションで使用するためのものです。

pSort で指定された列は、フォルダー内のアイテムの並べ替えに使用する列です。 項目のペアの並べ替え順序を決定するには、その PID を CompareID に渡します。 CompareIDs の lParam パラメーターを pSort が指す値に設定して、列を指定します。

ビューにアイテムを表す文字列が 1 つだけ表示される場合は、 pDisplay で指定された列から取得する必要があります。 列インデックスと項目の PIDL を IShellFolder2::GetDetailsOf に渡して、文字列を取得します。

実装者へのメモ

このメソッドは、名前空間拡張機能のフォルダー オブジェクト実装の一部です。 通常、フォルダー ビュー オブジェクトによって呼び出され、フォルダー内のアイテムを並べ替えるために Microsoft Windows エクスプローラー Details ビューのどの列を使用するかをフォルダー オブジェクトに確認します。 たとえば、トランザクション ログを表すフォルダー オブジェクトは、トランザクション時間を表示する列に pSort を設定する場合があります。 その後、アイテムは、名前ではなく、トランザクションが実行された時刻で並べ替えられます。

一部のクライアントでは、このメソッドを呼び出して、ツリー ビューに表示する必要がある名前の列のインデックスを要求する場合があります。 pDisplay を適切な列インデックスに設定します。 その後、クライアントは IShellFolder2::GetDetailsOf を呼び出して表示名を取得します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 5.0 以降)