ShareWindowCommandSource Klasse

Referenz

Definition

Namespace:: Windows.UI.Shell

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.

Bearbeiten

Stellt ein Objekt dar, das Ihre Kommunikations-App verwenden kann, um die Kommunikation mit der Fenstershell einzurichten, um die Benutzeroberfläche zum Starten und Beenden der Fensterfreigabe zu präsentieren.

Rufen Sie eine instance von ShareWindowCommandSource ab, und registrieren Sie sich, um die Ereignisse ShareWindowCommandSource.CommandRequested und ShareWindowCommandSource.CommandInvoked des instance zu behandeln. Diese Ereignisse werden von der Windows-Shell ausgelöst.

Wichtig

Die Windows.UI.Shell.ShareWindowCommandSource-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Um weitere Informationen zu erhalten oder ein Entsperrtoken anzufordern, verwenden Sie das ANFORDERUNGSFORMULAR für LAF-Zugriffstoken.

public ref class ShareWindowCommandSource sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ShareWindowCommandSource final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ShareWindowCommandSource

Public NotInheritable Class ShareWindowCommandSource

Vererbung: Object Platform::Object IInspectable ShareWindowCommandSource

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 (eingeführt in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v14.0)

Hinweise

Diese Funktion erweitert das Feature zur Fensterfreigabe, das Ihre Anwendung bereits implementiert, und bietet eine alternative Methode zum Auswählen von Fenstern. Das Design ermöglicht es Ihrer App, Befehle zum Starten der Freigabe und zum Beenden der Freigabe anzuzeigen. und diese auf eine Weise zu implementieren, die der Fähigkeit Ihrer App entspricht, ein oder mehrere Fenster freizugeben.

Ihre Kommunikations-App identifiziert das Fenster, das der Möglichkeit zum Freigeben von Fenstern entspricht– das einzelne App-Fenster oder Fenster, die Kommunikationssitzungen (Aufrufe) hosten. Die Windows Shell verwendet folgendes:

Rufen Sie Anwendungsidentifikationsinformationen ab, z. B. das Symbol und den Namen, die mit den Freigabebefehlen angezeigt werden.
Wählen Sie zwischen mehreren Freigabebefehlsquellen aus. Die zuletzt verwendete Freigabe-App wird ausgewählt.

Ereignisse werden verwendet, um Befehle anzufordern und aufzurufen. Dies schließt die WindowId des freigegebenen Fensters ein.

IShareWindowCommandSourceInterop ist eine native Interoperationsschnittstelle, die das Abrufen eines ShareWindowCommandSource-Objekts ermöglicht.

Methoden

GetForCurrentView()	Eine statische Methode, mit der Sie eine instance einer ShareWindowCommandSource abrufen können. Wichtig Die ShareWindowCommandSource.GetForCurrentView-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Um weitere Informationen zu erhalten oder ein Entsperrtoken anzufordern, verwenden Sie das ANFORDERUNGSFORMULAR für LAF-Zugriffstoken.
ReportCommandChanged()	Gibt der Windows Shell an, dass sich der Freigabestatus Ihrer Kommunikations-App geändert hat. Rufen Sie diese Methode auf, wenn sich der Freigabestatus Ihrer Kommunikations-App ändert. Wenn Sie erfolgreich ein neues Fenster in einem Anruf oder einer Besprechung freigeben oder ein bereits freigegebenes Fenster entfernen (unabhängig davon, ob es sich um eine eigene Benutzeroberfläche handelt oder durch eine Windows Taskbar-Aktion ausgelöst wurde), müssen Sie Ihren ShareWindowCommandSource-instance über diese Änderung benachrichtigen, indem Sie ReportCommandChanged aufrufen. Die Shell löscht dann alle Informationen, die sie im Rahmen eines ShareWindowCommandSource.CommandRequested-Ereignisses erhalten hat, und aktualisiert ihre sichtbaren Freigabebefehle so, dass sie dem aktuellen Zustand Ihrer App entsprechen.
Start()	Gibt an, dass die aufrufende App derzeit eine Quelle für Fensterfreigabebefehle ist. Rufen Sie diese Methode während eines Aufrufs oder einer Besprechung auf, um Ihre Kommunikations-App als Quelle für Fensterfreigabebefehle zu aktivieren.
Stop()	Gibt an, dass die aufrufende App keine Quelle von Fensterfreigabebefehlen ist. Rufen Sie diese Methode auf, wenn ein Aufruf oder eine Besprechung endet, um Ihre Kommunikations-App als Quelle für Fensterfreigabebefehle zu deaktivieren.

Ereignisse

CommandInvoked	Ein Ereignis, das von der Windows Shell ausgelöst wird, um Ihrer Kommunikations-App die Möglichkeit zu geben, die Freigabe eines bestimmten Fensters tatsächlich zu starten oder zu beenden.
CommandRequested	Ein Ereignis, das von der Windows Shell ausgelöst wird, um Ihrer Kommunikations-App die Möglichkeit zu geben, das Starten oder Beenden der Freigabe eines bestimmten Fensters zu unterstützen.

Gilt für:

Freigeben über