IShellFolder2::GetDefaultColumn-Methode (shobjidl_core.h)

Ruft die Standardsortierungs- und Anzeigespalten ab.

Syntax

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

Parameter

[in] dwRes

Art: DWORD

Reserviert. Auf NULL festlegen.

[out] pSort

Typ: ULONG*

Ein Zeiger auf einen Wert, der den Index der standardmäßig sortierten Spalte empfängt.

[out] pDisplay

Typ: ULONG*

Ein Zeiger auf einen Wert, der den Index der Standardanzeigespalte empfängt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Fehlerwert zurück.

Hinweise

Hinweise für Benutzer

Beide spaltenbasierten Indizes, die von dieser Methode zurückgegeben werden, sind für die Verwendung durch eine Anwendung vorgesehen, die eine Ordneransicht dieses Ordners darstellt.

Die von pSort angegebene Spalte ist die Spalte, die zum Sortieren der Elemente im Ordner verwendet werden soll. Um die Sortierreihenfolge eines beliebigen Elementpaars zu bestimmen, übergeben Sie deren PIDLs an CompareIDs. Geben Sie die Spalte an, indem Sie den lParam-Parameter von CompareIDs auf den Wert festlegen, auf den pSort verweist.

Wenn in einer Ansicht nur eine Zeichenfolge zur Darstellung eines Elements angezeigt wird, sollte sie aus der durch pDisplay angegebenen Spalte entnommen werden. Übergeben Sie den Spaltenindex und die PIDL des Elements an IShellFolder2::GetDetailsOf , um die Zeichenfolge abzurufen.

Hinweise für Implementierer

Diese Methode ist Teil der Folder-Objektimplementierung einer Namespaceerweiterung. Es wird in der Regel von einem Ordneransichtsobjekt aufgerufen, um das Ordnerobjekt zu fragen, welche Spalte in microsoft Windows Explorer Detailansicht zum Sortieren der Elemente im Ordner verwendet werden soll. Beispielsweise kann ein Ordnerobjekt, das ein Transaktionsprotokoll darstellt, pSort auf die Spalte festlegen, in der die Transaktionszeit angezeigt wird. Die Elemente werden dann nach dem Zeitpunkt der Transaktion und nicht nach Namen sortiert.

Einige Clients rufen diese Methode möglicherweise auf, um den Index der Spalte mit den Namen anzufordern, die in der Strukturansicht angezeigt werden sollen. Legen Sie pDisplay auf den entsprechenden Spaltenindex fest. Der Client ruft dann die Anzeigenamen durch Aufrufen von IShellFolder2::GetDetailsOf ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll (Version 5.0 oder höher)