Condividi tramite


CoreFrameworkInputView Classe

Definizione

Fornisce ai framework dell'interfaccia utente la possibilità di gestire PrimaryViewAnimationStarting e eventi OcclusionsChanged dopo gli eventi CoreInputViewPrimaryViewAnimationStarting e OcclusionsChanged.

Ciò consente a un framework di controllare la visualizzazione di un riquadro di input ancorato, non ancorato, spostabile o transitorio (e interfaccia utente associata), ricevere notifiche quando il riquadro viene spostato, visualizzato o nascosto e per determinare quale parte della finestra dell'app viene nascosta dal riquadro.

Nota

Non supportato in HoloLens.

public ref class CoreFrameworkInputView 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 CoreFrameworkInputView 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 CoreFrameworkInputView
Public NotInheritable Class CoreFrameworkInputView
Ereditarietà
Object Platform::Object IInspectable CoreFrameworkInputView
Attributi

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

Usato solo da framework (ad esempio XAML) o da controlli di testo personalizzati.

Il framework può usare le informazioni esposte da questo oggetto per regolare e rielaborare l'interfaccia utente per tenere conto di qualsiasi occlusione.

Le API CoreFrameworkInputView supportano i tipi di riquadri di input seguenti.

  • Pannello SIP (Soft Input Panel) ancorato come tastiera virtuale e pannello di grafia, in genere il riflow dell'interfaccia utente dell'app.
  • Barra degli strumenti mobile o SIP: in genere, l'interfaccia utente dell'app non viene riflow.
  • Pannelli sovrapposti, ad esempio finestre candidate inline Ink o IME, in genere l'interfaccia utente dell'app non esegue il reflow per il controllo di modifica, ma esegue il reflow per i suggerimenti di testo/ricerca.

Il riquadro di input viene visualizzato quando l'utente esegue un'azione che richiede di fornire informazioni, ad esempio l'immissione di un campo di testo.

Per impostazione predefinita, Windows gestisce gli eventi del riquadro di input e riposiziona il contenuto in modo che gli utenti possano visualizzare il controllo con lo stato attivo.

Chiamare CoreFrameworkInputView.GetForCurrentView per ottenere un oggetto CoreFrameworkInputView.

Dopo la registrazione per ricevere le notifiche del riquadro di input, il sistema chiama il delegato dell'evento ogni volta che il riquadro viene visualizzato o nascosto per la finestra in primo piano quando si chiama il metodo CoreFrameworkInputView.GetForCurrentView.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading and Marshaling (C++/CX).

Metodi

GetForCurrentView()

Recupera l'oggetto CoreFrameworkInputView associato alla finestra corrente.

GetForUIContext(UIContext)

Ottiene un oggetto CoreFrameworkInputView associato alla vista con l'identificatore di contesto specificato.

Eventi

OcclusionsChanged

Si verifica quando uno o più CoreInputViewOcclusion oggetti modificano la posizione o l'area di occlusione in risposta al riposizionamento del riquadro di input associato all'CoreFrameworkInputView.

PrimaryViewAnimationStarting

Animazioni nell'applicazione che si verificano in risposta alla visualizzazione o alla nascondere del riquadro di input associato al CoreFrameworkInputView.

Si applica a

Vedi anche