ShareWindowCommandSource Classe

Référence

Définition

Espace de noms:: Windows.UI.Shell

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Représente un objet que votre application de communication peut utiliser pour configurer la communication avec Window Shell afin de présenter l’interface utilisateur pour le démarrage et l’arrêt du partage de fenêtre.

Obtenez une instance de ShareWindowCommandSource et inscrivez-vous pour gérer les événements ShareWindowCommandSource.CommandRequested et ShareWindowCommandSource.CommandInvoked du instance. Ces événements sont déclenchés par l’interpréteur de commandes Windows.

Important

L’API Windows.UI.Shell.ShareWindowCommandSource fait partie d’une fonctionnalité à accès limité (voir classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, utilisez le formulaire de demande de jeton d’accès LAF.

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

Héritage: Object Platform::Object IInspectable ShareWindowCommandSource

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 11 (introduit dans 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v14.0)

Remarques

Cette fonctionnalité augmente la fonctionnalité de partage de fenêtres que votre application implémente déjà, en fournissant une autre méthode pour sélectionner des fenêtres. La conception permet à votre application de présenter les commandes démarrer le partage et arrêter le partage ; et de les implémenter d’une manière qui correspond à la capacité de votre application à partager une ou plusieurs fenêtres.

Votre application de communication identifie la fenêtre qui correspond à la possibilité de partager des fenêtres, à savoir la fenêtre d’application unique ou les fenêtres qui hébergent des sessions de communication (appels). L’interpréteur de commandes Windows utilise ceci pour :

Obtenez les informations d’identification de l’application, telles que son icône et son nom, qui seront présentées avec les commandes de partage.
Sélectionnez parmi plusieurs sources de commande de partage. L’application de partage la plus récente utilisée sera sélectionnée.

Les événements sont utilisés pour demander des commandes et les appeler, ce qui inclut le WindowId de la fenêtre à partager.

IShareWindowCommandSourceInterop est une interface d’interopérabilité native qui permet d’obtenir un objet ShareWindowCommandSource .

Méthodes

GetForCurrentView()	Méthode statique que vous pouvez utiliser pour obtenir une instance d’un ShareWindowCommandSource. Important L’API ShareWindowCommandSource.GetForCurrentView fait partie d’une fonctionnalité à accès limité (voir classe LimitedAccessFeatures). Pour plus d’informations ou pour demander un jeton de déverrouillage, utilisez le formulaire de demande de jeton d’accès LAF.
ReportCommandChanged()	Indique à l’interpréteur de commandes Windows que l’état de partage de votre application de communication a changé. Appelez cette méthode chaque fois que l’état de partage de votre application de communication change. Si vous partagez une nouvelle fenêtre dans un appel ou une réunion, ou si vous supprimez une fenêtre déjà partagée (que ce soit via votre propre interface utilisateur ou déclenchée par une action de barre des tâches Windows), vous devez informer votre instance ShareWindowCommandSource de cette modification en appelant ReportCommandChanged. L’interpréteur de commandes vide ensuite toutes les informations qu’il a reçues dans le cadre d’un événement ShareWindowCommandSource.CommandRequested et met à jour ses commandes de partage visibles pour qu’elles correspondent à l’état actuel de votre application.
Start()	Indique que l’application appelante est actuellement une source de commandes de partage de fenêtres. Appelez cette méthode lors d’un appel ou d’une réunion pour activer votre application de communication en tant que source de commandes de partage de fenêtre.
Stop()	Indique que l’application appelante n’est pas une source de commandes de partage de fenêtres. Appelez cette méthode lorsqu’un appel ou une réunion se termine pour désactiver votre application de communication en tant que source de commandes de partage de fenêtre.

Événements

CommandInvoked	Événement déclenché par Windows Shell pour permettre à votre application de communication de démarrer ou d’arrêter le partage d’une fenêtre particulière.
CommandRequested	Événement déclenché par Windows Shell pour permettre à votre application de communication de prendre en charge le démarrage ou l’arrêt du partage d’une fenêtre particulière.

S’applique à

Partager via