Share via

ShareWindowCommandSource Classe

  • Referência

Definição

Namespace:
Windows.UI.Shell
Editar

Representa um objeto que seu aplicativo de comunicações pode usar para configurar a comunicação com o Shell de Janela para apresentar a interface do usuário para iniciar e interromper o compartilhamento de janelas.

Obtenha uma instância do ShareWindowCommandSource e registre-se para lidar com os eventos ShareWindowCommandSource.CommandRequested e ShareWindowCommandSource.CommandInvoked da instância. Esses eventos são gerados pelo Shell do Windows.

Importante

A API Windows.UI.Shell.ShareWindowCommandSource faz parte de um recurso de acesso limitado (consulte a classe LimitedAccessFeatures). Para obter mais informações ou para solicitar um token de desbloqueio, use o Formulário de Solicitação de Token de Acesso do 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
Herança
Object Platform::Object IInspectable ShareWindowCommandSource
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 11 (introduzida na 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v14.0)

Comentários

Essa funcionalidade aumenta o recurso de compartilhamento de janelas que seu aplicativo já implementa, fornecendo um método alternativo para selecionar janelas. O design permite que seu aplicativo apresente comandos iniciar o compartilhamento e interromper o compartilhamento; e implementá-los de uma maneira que corresponda à capacidade do aplicativo de compartilhar uma ou mais janelas.

Seu aplicativo de comunicações identifica a janela que corresponde à capacidade de compartilhar janelas— a janela de aplicativo único ou janelas que hospedam sessões de comunicação (chamadas). O Windows Shell usa isso para:

  • Obtenha informações de identificação do aplicativo, como seu ícone e nome, que serão apresentados com os comandos de compartilhamento.
  • Selecione entre várias fontes de comando de compartilhamento. O aplicativo de compartilhamento usado mais recentemente será selecionado.

Os eventos são usados para solicitar comandos e invocá-los, isso inclui a WindowId da janela a ser compartilhada.

IShareWindowCommandSourceInterop é uma interface de interoperação nativa que permite obter um objeto ShareWindowCommandSource .

Métodos

GetForCurrentView()

Um método estático que você pode usar para obter uma instância de um ShareWindowCommandSource.

Importante

A API ShareWindowCommandSource.GetForCurrentView faz parte de um recurso de acesso limitado (consulte a classe LimitedAccessFeatures). Para obter mais informações ou para solicitar um token de desbloqueio, use o Formulário de Solicitação de Token de Acesso do LAF.
ReportCommandChanged()

Indica ao Windows Shell que o estado de compartilhamento do aplicativo de comunicações foi alterado.

Chame esse método sempre que o estado de compartilhamento do aplicativo de comunicações for alterado. Se você compartilhar com êxito uma nova janela em uma chamada ou reunião ou remover uma janela já compartilhada (seja por meio de sua própria interface do usuário ou disparada por uma ação da Barra de Tarefas do Windows), notificará sua instância do ShareWindowCommandSource dessa alteração chamando ReportCommandChanged.

Em seguida, o Shell liberará todas as informações recebidas como parte de qualquer evento ShareWindowCommandSource.CommandRequested e atualizará seus comandos de compartilhamento visíveis para corresponder ao estado atual do aplicativo.
Start()

Indica que o aplicativo de chamada é atualmente uma fonte de comandos de compartilhamento de janela. Chame esse método durante uma chamada ou reunião para habilitar seu aplicativo de comunicações como uma fonte de comandos de compartilhamento de janela.
Stop()

Indica que o aplicativo de chamada não é uma fonte de comandos de compartilhamento de janela. Chame esse método quando uma chamada ou reunião terminar para desabilitar seu aplicativo de comunicações como uma fonte de comandos de compartilhamento de janela.

Eventos

CommandInvoked

Um evento gerado pelo Shell do Windows para dar ao seu aplicativo de comunicações a oportunidade de realmente iniciar ou parar de compartilhar uma janela específica.
CommandRequested

Um evento gerado pelo Windows Shell para dar ao seu aplicativo de comunicações a oportunidade de dar suporte ao início ou à interrupção do compartilhamento de uma janela específica.

Aplica-se a

Confira também