Freigeben über


ICustomDestinationList::AddUserTasks-Methode (shobjidl_core.h)

Gibt Elemente an, die in die Kategorie Aufgaben einer benutzerdefinierten Sprungliste aufgenommen werden sollen.

Syntax

HRESULT AddUserTasks(
  [in] IObjectArray *poa
);

Parameter

[in] poa

Typ: IObjectArray*

Ein Zeiger auf ein IObjectArray-Objekt , das ein oder mehrere IShellLink-Objekte (oder seltener IShellItem)-Objekte darstellt, die die Aufgaben darstellen.

Hinweis Jeder hier verwendete IShellLink muss eine Argumentliste über SetArguments deklarieren. Das Hinzufügen eines IShellLink-Objekts ohne Argumente zu einer benutzerdefinierten Kategorie wird nicht unterstützt. Ein Benutzer kann diese Art von Element nicht aus einer Sprungliste anheften oder entfernen, noch kann sie hinzugefügt oder entfernt werden.
 

Rückgabewert

Typ: HRESULT

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

Hinweise

Sie müssen ICustomDestinationList::BeginList aufrufen, bevor Sie diese Methode aufrufen.

Der Kategorieheader Aufgaben wird in der Liste standardmäßig immer angezeigt, es sei denn, die Kategorie ist leer. Dieser Headertext kann nicht geändert werden. Sie wird in der vom Benutzer ausgewählten Sprache angezeigt.

Die Kategorie Aufgaben , obwohl sie immer als letzte Kategorie in einer Sprungliste angezeigt wird, hat Vorrang vor allen anderen Kategorien in der Liste. Diese Liste wird ausgefüllt, und dann wird der verbleibende Platz den anderen Kategorien zugeordnet. Im Gegensatz zu anderen Kategorien können Elemente in der Kategorie Aufgaben nicht vom Benutzer entfernt oder angeheftet werden. Anwendungen müssen den Wert für den Benutzer der Aufgaben in dieser Kategorie mit dem für andere Kategorien erforderlichen Speicherplatz abgleichen.

Aufgaben sollten sich auf den Antrag als Ganzes beziehen; Sie sind nicht für ein einzelnes Fenster oder Dokument spezifisch. Für diese präziseren kontextbezogenen Aufgaben kann eine Anwendung sie über eine Miniaturansicht-Symbolleiste bereitstellen.

Hinweis Es wird dringend empfohlen, dass die Aufgabenliste statisch ist. Die Aufgabenliste sollte unabhängig vom Status oder status der Anwendung gleich bleiben. Diese Aufgaben sind auch dann verfügbar, wenn die Anwendung nicht ausgeführt wird. Es gibt kein programmgesteuertes Verbot, AddUserTasks zu verwenden, um die Aufgabenliste zu variieren, wenn sie aktualisiert wird, aber Sie sollten bedenken, dass dies den Benutzer verwirren könnte, der nicht erwartet, dass sich dieser Teil der Sprungliste ändert. Wenn eine Anwendung jedoch den Status einer Aufgabe ändert, z. B. "Anmelden" in "Abmelden", liegt es in der Verantwortung dieser Anwendung sicherzustellen, dass die Aufgabenliste korrekt und aktuell ist. Wenn die Anwendung unerwartet heruntergefahren wird, verwendet die Taskleiste außerdem ihre letzte bekannte gute Version der Aufgabenliste, ohne die Anwendung aufzurufen, um eine anzufordern, was zu der Möglichkeit führt, dass elemente veraltet sind.
 

IShellLink-Instanzen , die über das IObjectArray bereitgestellt werden, auf das von poa verwiesen wird, müssen Folgendes bereitstellen:

Der Anzeigename muss über die System.Title-Eigenschaft (PKEY_Title) des Elements festgelegt werden. Die -Eigenschaft kann den Anzeigenamen direkt enthalten, oder es kann sich um eine indirekte Zeichenfolgendarstellung wie "@shell32.dll,-1324" handeln, um eine gespeicherte Zeichenfolge zu verwenden. Eine indirekte Zeichenfolge ermöglicht die Anzeige des Elementnamens in der ausgewählten Sprache des Benutzers.

Optional kann das Beschreibungsfeld (SetDescription) so festgelegt werden, dass eine benutzerdefinierte QuickInfo für das Element in der Sprungliste bereitgestellt wird.

Eine Aufgabenliste kann auch Trennzeichen enthalten. Diese werden erstellt, indem ein leerer IShellLink (dies ist die einzige Ausnahme von der Argumentlistenanforderung) und die System.AppUserModel.IsDestListSeparator-Eigenschaft über die IPropertyStore-Schnittstelle des IShellLink-Objekts auf TRUE festgelegt wird. Alle anderen Werte im IShellLink werden ignoriert. Trennzeichen nehmen kein volles Leerzeichen in der Liste ein und werden nicht in die Anzahl der Elemente in der Liste gezählt. Wenn zwei Trennzeichen ohne Elemente dazwischen bereitgestellt werden, wird eines der Trennzeichen nicht angezeigt. Trennzeichen am Anfang oder Ende der Liste werden ebenfalls ignoriert.

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

ICustomDestinationList::AppendCategory

ICustomDestinationList::AppendKnownCategory

Taskleistenerweiterungen