ShareWindowCommandSource Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Shell

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Rappresenta un oggetto che l'app di comunicazione può usare per configurare la comunicazione con Window Shell per presentare l'interfaccia utente per avviare e arrestare la condivisione delle finestre.

Ottenere un'istanza di ShareWindowCommandSource e registrare per gestire gli eventi ShareWindowCommandSource.CommandRequested e ShareWindowCommandSource.CommandInrichiamare . Tali eventi vengono generati da Windows Shell.

Importante

L'API Windows.UI.Shell.ShareWindowCommandSource fa parte di una funzionalità di accesso limitato (vedere La classe LimitedAccessFeatures). Per altre informazioni o per richiedere un token di sblocco, usare il modulo richiesta token di accesso 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

Ereditarietà: Object Platform::Object IInspectable ShareWindowCommandSource

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 11 (è stato introdotto in 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v14.0)

Commenti

Questa funzionalità aumenta la funzionalità di condivisione delle finestre già implementata dall'applicazione, fornendo un metodo alternativo per la selezione di finestre. La progettazione consente all'app di presentare comandi di condivisione e interruzione della condivisione; e per implementare tali elementi in modo che corrispondano alla possibilità dell'app di condividere una o più finestre.

L'app per le comunicazioni identifica la finestra corrispondente alla possibilità di condividere le finestre, ovvero la singola finestra dell'app o le finestre che ospitano sessioni di comunicazione (chiamate). Windows Shell usa questa opzione per:

Ottenere informazioni di identificazione dell'applicazione, ad esempio l'icona e il nome, che verranno presentati con i comandi di condivisione.
Selezionare tra più origini dei comandi di condivisione. L'app di condivisione usata più di recente verrà selezionata.

Gli eventi vengono usati per richiedere i comandi e richiamarli, questo include windowId della finestra da condividere.

IShareWindowCommandSourceInterop è un'interfaccia di interoperabilità nativa che consente di ottenere un oggetto ShareWindowCommandSource .

Metodi

GetForCurrentView()	Metodo statico che è possibile usare per ottenere un'istanza di ShareWindowCommandSource. Importante L'API ShareWindowCommandSource.GetForCurrentView fa parte di una funzionalità di accesso limitato (vedere La classe LimitedAccessFeatures). Per altre informazioni o per richiedere un token di sblocco, usare il modulo richiesta token di accesso LAF.
ReportCommandChanged()	Indica a Windows Shell che lo stato di condivisione dell'app per le comunicazioni è cambiato. Chiamare questo metodo ogni volta che cambia lo stato di condivisione dell'app per le comunicazioni. Se si condivide correttamente una nuova finestra in una chiamata o in una riunione oppure si rimuove una finestra già condivisa (se si tratta di un'interfaccia utente personalizzata o attivata da un'azione della barra delle applicazioni di Windows), è necessario inviare una notifica all'istanza di ShareWindowCommandSource di tale modifica chiamando ReportCommandChanged. Shell scarica quindi tutte le informazioni ricevute come parte di qualsiasi evento ShareWindowCommandSource.CommandRequested e aggiornerà i comandi di condivisione visibili per corrispondere allo stato corrente dell'app.
Start()	Indica che l'app chiamante è attualmente un'origine dei comandi di condivisione delle finestre. Chiamare questo metodo durante una chiamata o una riunione per abilitare l'app di comunicazione come origine dei comandi di condivisione delle finestre.
Stop()	Indica che l'app chiamante non è un'origine dei comandi di condivisione delle finestre. Chiamare questo metodo quando una chiamata o una riunione termina per disabilitare l'app di comunicazione come origine dei comandi di condivisione delle finestre.

Eventi

CommandInvoked	Evento generato da Windows Shell per offrire all'app per le comunicazioni un'opportunità di avviare o arrestare la condivisione di una determinata finestra.
CommandRequested	Evento generato da Windows Shell per offrire all'app di comunicazione un'opportunità di supporto per l'avvio o l'arresto della condivisione di una determinata finestra.

Si applica a

Condividi tramite