Share via

ICustomDestinationList::BeginList-Methode (shobjidl_core.h)

  • Artikel

Initiiert eine Erstellungssitzung für eine benutzerdefinierte Sprungliste.

Syntax

HRESULT BeginList(
  [out] UINT   *pcMinSlots,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[out] pcMinSlots

Typ: UINT*

Ein Zeiger, der, wenn diese Methode zurückgibt, auf die aktuelle Benutzereinstellung für die Option Anzahl der zuletzt verwendeten Elemente zeigt, die im Eigenschaftenfenster der Taskleiste und des Startmenüsin Jump Listen angezeigt werden. Der Standardwert ist 10. Dies ist die maximale Anzahl von Zielen, die angezeigt werden, und es ist eine Summe aller Ziele, unabhängig von der Kategorie. Es können weitere Ziele hinzugefügt werden, die jedoch nicht auf der Benutzeroberfläche angezeigt werden.

In einer Sprungliste werden immer mindestens so viele Slots angezeigt– Ziele und, falls Platz vorhanden ist, Aufgaben.

Diese Zahl enthält keine Trennzeichen und Abschnittsheader, solange die Gesamtzahl der Trennzeichen und Header nicht mehr als vier beträgt. Trennzeichen und Abschnittsheader über die ersten vier hinaus können die Anzahl der angezeigten Ziele verringern, wenn der Speicherplatz eingeschränkt ist. Diese Zahl wirkt sich nicht auf die Standardbefehlseinträge zum Anheften oder Lösen, Schließen des Fensters oder Starten eines neuen instance aus. Dies wirkt sich auch nicht auf Aufgaben oder angeheftete Elemente aus. Die Anzahl der angezeigten Elemente basiert auf dem für die Sprungliste verfügbaren Platz.

[in] riid

Typ: REFIID

Ein Verweis auf die IID einer Schnittstelle, die in ppv abgerufen werden soll( in der Regel IID_IObjectArray), die alle Elemente darstellt, die derzeit in der Liste der entfernten Ziele für die Anwendung gespeichert sind. Diese Informationen werden verwendet, um sicherzustellen, dass entfernte Elemente nicht Teil der neuen Sprungliste sind.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel ein IObjectArray, das eine Auflistung von IShellItem- und IShellLink-Objekten darstellt, die die entfernten Elemente darstellen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn eine Anwendung über eine explizite Anwendungsbenutzermodell-ID (AppUserModelID) verfügt, müssen Sie ICustomDestinationList::SetAppID aufrufen, bevor Sie diese Methode aufrufen.

Die im ppv-Parameter abgerufene IObjectArray-Schnittstelle stellt dieselbe Liste entfernter Ziele dar, die über GetRemovedDestinations abgerufen wird. Wenn eine neue Sprungliste generiert wird, müssen Anwendungen zuerst alle entfernten Ziele verarbeiten. Überwachungsdaten für jedes Element in der entfernten Liste müssen gelöscht werden. Wenn eine Anwendung versucht, ein Element über AppendCategory einzuschließen, das in dieser Liste der entfernten Ziele vorhanden ist, schlägt der AppendCategory-Aufruf fehl. Dadurch wird sichergestellt, dass Anwendungen die Auswahl der entfernten Elemente des Benutzers berücksichtigen. Nachdem ein Aufruf von CommitList ohne fehlgeschlagenen Aufruf von AppendCategory erfolgt ist, da seit BeginList versucht wurde, ein entferntes Element erneut hinzuzufügen, wird die Liste der entfernten Ziele gelöscht. Nach dieser Zeit kann ein zuvor entferntes Element zur Zielliste zurückkehren, wenn der Benutzer das Element weiterhin verwendet.

BeginList muss aufgerufen werden, um die Liste zu initiieren, bevor aufruft wird, um sie über AppendCategory, AppendKnownCategory oder AddUserTasks aufzufüllen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.1 oder höher)

Weitere Informationen

ICustomDestinationList

Taskleistenerweiterungen