ICustomDestinationList::AppendKnownCategory-Methode (shobjidl_core.h)

Artikel
08/26/2023

Gibt an, dass die Kategorie Häufig oder Zuletzt verwendet in eine benutzerdefinierte Sprungliste aufgenommen werden soll.

Syntax

HRESULT AppendKnownCategory(
  [in] KNOWNDESTCATEGORY category
);

Parameter

[in] category

Typ: KNOWNDESTCATEGORY

Einer der folgenden Werte, der angibt, welche bekannte Kategorie der Liste hinzugefügt werden soll:

KDC_FREQUENT (1)

0x1. Fügen Sie die Kategorie Häufig hinzu.

KDC_RECENT (2)

0x2. Fügen Sie die Kategorie Zuletzt verwendet hinzu.

Rückgabewert

Typ: HRESULT

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

Wenn eine Datenschutzeinstellung Gruppenrichtlinie oder Benutzerdatenschutz vorhanden ist, kann sich dies auf das Ergebnis dieser Methode auswirken. Kategorien, die benutzerspezifische Elemente basierend auf der individuellen Nutzung enthalten, sind in diesen Datenschutzeinstellungen nicht zulässig. Aus diesem Grund enthalten die über diese Methode hinzugefügten Kategorien Zuletzt oder Häufig keine Daten, und Kategorien ohne Daten werden nicht angezeigt. In diesem Fall führt dieser Methodenaufruf jedoch nicht zu einem Fehlercode.

Hinweise

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

Die Kategorie Zuletzt verwendet wird in einer Standardmäßigen Sprungliste angezeigt, aber um sie in einer benutzerdefinierten Sprungliste zusammen mit benutzerdefinierten Kategorien anzuzeigen, müssen Sie sie explizit über diese Methode anfordern.

Sowohl bei AppendCategory als auch bei AppendKnownCategory sollte eine benutzerdefinierte Sprungliste entworfen werden, um zu vermeiden, dass Elemente in mehr als einer Kategorie angezeigt werden. Wenn zwei Kategorien einfach unterschiedliche Ansichten für die gleichen Daten sind, sollte eine dieser Kategorien entfernt werden, da sie den Platz für Sprunglisten verwendet, ohne zur Benutzerfreundlichkeit beizutragen. Duplikate werden vom System nicht ausgeblendet, außer im Fall eines angehefteten Ziels. In diesem Fall wird dieses Ziel in der Kategorie Angeheftet angezeigt und in allen anderen ausgeblendet.

Die Kategorien Häufig und Zuletzt verwendet enthalten wahrscheinlich eine gewisse Überlappung, weshalb Sie nicht beide Kategorien einer einzelnen Sprungliste hinzufügen sollten. Welche der beiden für Ihre Anwendung am besten geeignet ist, hängt von ihrer Art ab. Eine Anwendung, die Dateien wie Microsoft Word oder Microsoft Paint generiert, sollte die Kategorie Zuletzt verwendet verwenden, da Benutzer am ehesten zu Dateien zurückkehren möchten, an denen sie kürzlich gearbeitet haben. Eine Anwendung, die mehr zum Durchsuchen oder Wiedergeben von an anderer Stelle erstellten Daten verwendet wird, sollte die Kategorie Häufig verwenden, da der Benutzer mit größerer Wahrscheinlichkeit auf eine größere Anzahl von Elementen zugreift, viele davon nur einmal. Anders ausgedrückt: Wenn Ihre Anwendung höchstwahrscheinlich nur ein paar Mal auf eine große Anzahl von Elementen zugreift, was zu der kleineren Gruppe von Elementen beiträgt, auf die Benutzer häufig zugreifen möchten, ist Frequent die beste Wahl. Wenn Ihre Anwendung in den meisten Fällen eher auf eine kleinere Anzahl neuerer Elemente zugreift, sollten Sie Zuletzt verwendet auswählen.

Kategorien in einer benutzerdefinierten Sprungliste, einschließlich der bekannten Kategorie Zuletzt verwendet oder Häufig , werden in der Reihenfolge angezeigt, in der sie hinzugefügt werden, wobei die zuletzt hinzugefügten Kategorien am Ende der Liste stehen.

Eine beliebige Anzahl von Zielen, die über den Wert hinzugefügt werden, auf den der parameter pcMinItems in ICustomDestinationList::BeginList verweist, werden nicht angezeigt.

Leere Kategorien werden nicht angezeigt.

Der Inhalt der Kategorien Häufig und Zuletzt verwendet wird für jede Anwendung berechnet, die SHAddToRecentDocs direkt verwendet. In einigen Fällen von Benutzeraktionen, z. B. das Öffnen einer Datei über Windows Explorer oder die Verwendung des Dialogfelds "Gemeinsame Datei" zum Öffnen, Speichern oder Erstellen einer Datei, ruft die Shell SHAddToRecentDocs im Namen einer Anwendung auf, und diese Aufrufe werden auch in der Nutzungsstatistik berücksichtigt. Die Shell ruft auch SHAddToRecentDocs im Namen der Anwendung auf, wenn ein Ziel über die Jump List gestartet wird. Es empfiehlt sich jedoch, dass die Anwendung SHAddToRecentDocs selbst explizit aufruft , auch wenn erwartet wird, dass die Shell den Aufruf tätigen wird. Dadurch wird sichergestellt, dass die Nutzung aufgezeichnet wird, und die Algorithmen zur Nachverfolgung der letzten oder häufigen Nutzung korrigieren alle doppelten Aufrufe.

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)