Condividi tramite

CoreFrameworkInputView Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.ViewManagement.Core
Modifica

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

In questo modo un framework consente di controllare la visualizzazione di un riquadro di input ancorato, non sincronizzato, spostato 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 oscurata 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
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

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

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

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

  • Pannello di input soft ancorato (SIP) come il pannello Touch keyboard and handwriting ( In genere, l'interfaccia utente dell'app riflows).
  • Barra degli strumenti mobile o SIP: in genere, l'interfaccia utente dell'app non esegue il reflow.
  • Pannelli di sovrapposizione, ad esempio finestre inline Ink o IME candidati, 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 loro di fornire informazioni, ad esempio immettendo 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 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 relativo modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX).

Metodi

GetForCurrentView()

Recupera l'oggetto CoreFrameworkInputView associato alla finestra corrente.
GetForUIContext(UIContext)

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

Eventi

OcclusionsChanged

Si verifica quando uno o più oggetti CoreInputViewOcclusion cambiano la loro posizione o l'area di occluding in risposta al riposizionamento del riquadro di input associato a CoreFrameworkInputView.
PrimaryViewAnimationStarting

Animazioni nell'applicazione che si verificano in risposta all'oggetto visualizzato o nascosto del riquadro di input associato a CoreFrameworkInputView.

Si applica a

Vedi anche