WindowTabManager Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht einer App die Verwaltung der Beziehung zwischen den Registerkarten der In-App-Benutzeroberfläche und den Darstellungen der Registerkarten in der Systemshell-Benutzeroberfläche.
public ref class WindowTabManager sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Shell.WindowTabManagerContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WindowTabManager final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Shell.WindowTabManagerContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WindowTabManager
Public NotInheritable Class WindowTabManager
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows Desktop Extension SDK (eingeführt in 10.0.23504.0)
|
API contract |
Windows.UI.Shell.WindowTabManagerContract (eingeführt in v1.0)
|
Hinweise
Wichtig
Diese API gilt nur für Win32-Desktop-Apps. UWP und andere App-Typen werden nicht unterstützt.
Wenn Ihre App visuelle Registerkarten zum Organisieren und Trennen von Inhalten verwendet, können Sie diese Registerkarten in der Benutzeroberfläche der Systemshell verfügbar machen WindowTabManager
, um den Zugriff zu erleichtern.
Mit WindowTabManager
kann eine App Informationen zu ihren In-App-Registerkartenansichten für die Windows-Shell freigeben. Wie die Shell auf die Informationen reagiert, falls überhaupt, liegt im Ermessen der Shell. (Mit anderen Worten, die Implementierung kann auf einigen Shells inert sein.)
WindowsTabManager
speichert die Liste der Registerkarten, über die die App die Windows-Shell wissen soll, und lässt die App angeben, welche die derzeit aktive Registerkarte ist. Die App kann auch Informationen zum Titel, zum Symbol, zur Gruppierung und zu einer alternativen Anwendungs-ID bereitstellen.
WindowsTabManager
stellt außerdem Ereignisse bereit, die die App abonnieren kann, um mit ihren Registerkarten auf Interaktionen mit der Windows-Shell zu reagieren. Beispielsweise, wenn Sie zu einer anderen Registerkarte wechseln, eine Registerkarte schließen oder wissen, dass eine Vorschau einer Registerkarte angezeigt wird.
Eigenschaften
Tabs |
Ruft die Auflistung von Registerkarten ab, die von diesem Registerkarten-Manager verwaltet werden. |
Methoden
GetForWindow(WindowId) |
Ruft eine instance von ab, die |
IsSupported() |
Ruft einen Wert ab, der angibt, ob die Registerkartenverwaltung von der aktuellen Systemshell unterstützt wird. |
IsTabTearOutSupported() |
Ruft einen Wert ab, der angibt, ob die aktuelle Systemshell das Herausreißen einer Registerkarte in ein separates Fenster unterstützt. |
SetActiveTab(WindowTab) |
Benachrichtigt das System, um die angegebene Registerkarte zur aktiven Registerkarte zu machen. |
Ereignisse
TabCloseRequested |
Tritt auf, wenn eine Registerkarte über eine Systemshelloberfläche geschlossen wird. |
TabSwitchRequested |
Tritt auf, wenn eine Registerkarte von einer Systemshelloberfläche auf eine Registerkarte umgeschaltet wird. |
TabTearOutRequested |
Tritt auf, wenn die Systemshell ein separates Fenster für eine bestimmte Registerkarte anfordert. |
TabThumbnailRequested |
Tritt auf, wenn das System eine Registerkarte in einer Shelloberfläche anzeigt, die eine Miniaturansicht anzeigt, als Signal an die App, eine aktuelle Miniaturansicht zu generieren. |