Compartir a través de

ShareWindowCommandSource Clase

  • Referencia

Definición

Espacio de nombres:
Windows.UI.Shell
Editar

Representa un objeto que la aplicación de comunicaciones puede usar para configurar la comunicación con el Shell de ventana para presentar la interfaz de usuario para iniciar y detener el uso compartido de ventanas.

Obtenga una instancia de ShareWindowCommandSource y regístrese para controlar los eventos ShareWindowCommandSource.CommandRequested y ShareWindowCommandSource.CommandInvoked de la instancia. Estos eventos se generan mediante el Shell de Windows.

Importante

La API Windows.UI.Shell.ShareWindowCommandSource forma parte de una característica de acceso limitado (consulte La clase LimitedAccessFeatures). Para obtener más información o solicitar un token de desbloqueo, use el formulario de solicitud de token de acceso 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
Herencia
Object Platform::Object IInspectable ShareWindowCommandSource
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos
Windows 11 (se introdujo en la versión 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v14.0)

Comentarios

Esta funcionalidad aumenta la característica de uso compartido de ventanas que la aplicación ya implementa, lo que proporciona un método alternativo para seleccionar ventanas. El diseño permite que la aplicación presente comandos de inicio y detención del uso compartido; e implementarlas de una manera que corresponda a la capacidad de la aplicación para compartir una o varias ventanas.

La aplicación de comunicaciones identifica la ventana que corresponde a la capacidad de compartir ventanas, la ventana de una sola aplicación o las ventanas que hospedan sesiones de comunicación (llamadas). El Shell de Windows lo usa para:

  • Obtenga información de identificación de la aplicación, como su icono y nombre, que se presentará con los comandos de recurso compartido.
  • Seleccione entre varios orígenes de comandos de recurso compartido. Se seleccionará la aplicación de uso compartido usada más recientemente.

Los eventos se usan para solicitar comandos e invocarlos, lo que incluye windowId de la ventana que se va a compartir.

IShareWindowCommandSourceInterop es una interfaz de interoperación nativa que permite obtener un objeto ShareWindowCommandSource .

Métodos

GetForCurrentView()

Un método estático que puede usar para obtener una instancia de shareWindowCommandSource.

Importante

La API ShareWindowCommandSource.GetForCurrentView forma parte de una característica de acceso limitado (vea LimitedAccessFeatures class). Para obtener más información o solicitar un token de desbloqueo, use el formulario de solicitud de token de acceso laF.
ReportCommandChanged()

Indica al Shell de Windows que ha cambiado el estado de uso compartido de la aplicación de comunicaciones.

Llame a este método cada vez que cambie el estado de uso compartido de la aplicación de comunicaciones. Si comparte correctamente una nueva ventana en una llamada o reunión, o quita una ventana ya compartida (ya sea a través de su propia interfaz de usuario o desencadenada por una acción de barra de tareas de Windows), debe notificar a la instancia shareWindowCommandSource de ese cambio llamando a ReportCommandChanged.

Después, el Shell vaciará cualquier información que haya recibido como parte de cualquier evento ShareWindowCommandSource.CommandRequested y actualizará sus comandos de recurso compartido visibles para que coincidan con el estado actual de la aplicación.
Start()

Indica que la aplicación que realiza la llamada es actualmente un origen de comandos de uso compartido de ventanas. Llame a este método durante una llamada o reunión para habilitar la aplicación de comunicaciones como origen de comandos de uso compartido de ventanas.
Stop()

Indica que la aplicación que realiza la llamada no es un origen de comandos de uso compartido de ventanas. Llame a este método cuando una llamada o reunión termine para deshabilitar la aplicación de comunicaciones como origen de comandos de uso compartido de ventanas.

Eventos

CommandInvoked

Evento generado por el Shell de Windows para dar a la aplicación de comunicaciones una oportunidad para iniciar o dejar de compartir realmente una ventana determinada.
CommandRequested

Evento generado por el Shell de Windows para dar a la aplicación de comunicaciones una oportunidad para admitir el inicio o la detención de compartir una ventana determinada.

Se aplica a

Consulte también