Condividi tramite


CoreInputView Classe

Definizione

Consente a un'app 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 CoreInputView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreInputView final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreInputView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreInputView
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView
Public NotInheritable Class CoreInputView
Ereditarietà
Object Platform::Object IInspectable CoreInputView
Attributi

Requisiti Windows

Famiglia di dispositivi
Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Commenti

La visualizzazione principale fa riferimento a una delle visualizzazioni CoreInputViewKind.Keyboard o CoreInputViewKind.Handwriting , mentre CoreInputView può essere uno dei valori di CoreInputViewKind.Handwriting.

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

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

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

  • Pannello SIP (Soft Input Panel) ancorato come la tastiera virtuale e il pannello di grafia , in genere i riflow dell'interfaccia utente dell'app.
  • Barra degli strumenti mobile o SIP: in genere, l'interfaccia utente dell'app non esegue il reflow.
  • Pannelli sovrapposti, ad esempio finestre candidate input penna o IME, in genere l'interfaccia utente dell'app non viene riflow 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 che forniscano 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. Se imposti CoreTextEditContext.InputPaneDisplayPolicy su Manuale nella tua app, devi visualizzare e nascondere il riquadro di input usando TryShowPrimaryView e TryHidePrimaryView. Usare questa classe per eseguire l'override del comportamento predefinito e personalizzare il riquadro di input.

Chiamare GetForCurrentView per ottenere un oggetto CoreInputView.

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 visibile quando è stato chiamato il metodo GetForCurrentView .

Nota

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

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1803 17134 TryTransferXYFocusToPrimaryView
1803 17134 XYFocusTransferredToPrimaryView
1803 17134 XYFocusTransferringFromPrimaryView
1809 17763 TryHide
1809 17763 TryShow
1809 17763 TryShow(CoreInputViewKind)
1903 18362 GetForUIContext
2004 19041 PrimaryViewHiding
2004 19041 PrimaryViewShowing

Metodi

GetCoreInputViewOcclusions()

Recupera un riferimento a ogni riquadro di input che attualmente occluda l'app.

GetForCurrentView()

Recupera l'oggetto CoreInputView associato alla finestra corrente.

GetForUIContext(UIContext)

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

IsKindSupported(CoreInputViewKind)

Ottiene un valore che indica se il tipo di CoreInputView specificato è supportato.

TryHide()

Tenta di nascondere (se visibile) il riquadro di input associato al riquadro CoreInputView .

TryHidePrimaryView()

Tenta di nascondere (se visibile) il riquadro di input associato a CoreInputView.

TryShow()

Tenta di visualizzare (se nascosto) il riquadro di input associato a CoreInputView.

TryShow(CoreInputViewKind)

Tenta di visualizzare (se nascosto) il tipo di riquadro di input specificato associato a CoreInputView.

TryShowPrimaryView()

Tenta di visualizzare (se nascosto) il riquadro CoreInputView .

Questo metodo è un metodo "migliore sforzo" e garantisce solo che l'utente abbia un modo per interagire con il controllo attivo. Per un pannello SIP (Soft Input Panel) ancorato come la tastiera virtuale e il pannello di grafia, il riquadro viene visualizzato solo se non è disponibile una tastiera hardware.

TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)

Tenta di spostare lo stato attivo dall'interfaccia utente dell'applicazione al riquadro di input.

Eventi

OcclusionsChanged

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

PrimaryViewAnimationStarting

Animazioni nell'applicazione che si verificano in risposta alla visualizzazione o al nascondiglio della visualizzazione primaria CoreInputView .

PrimaryViewHiding

Si verifica prima che il riquadro di input associato a CoreInputView sia nascosto (se visibile).

PrimaryViewShowing

Si verifica prima che venga visualizzato il riquadro di input associato a CoreInputView (se nascosto).

SupportedKindsChanged

Si verifica quando cambia la raccolta di visualizzazioni CoreInputViewKind supportate per CoreInputView .

XYFocusTransferredToPrimaryView

Si verifica quando lo stato attivo viene spostato nel riquadro di input dall'interfaccia utente dell'applicazione.

XYFocusTransferringFromPrimaryView

Si verifica prima che il riquadro di input perda lo stato attivo e prima che un elemento dell'interfaccia utente ottenga lo stato attivo.

Si applica a

Vedi anche