CoreInputView Classe

Definizione

Spazio dei nomi:

Windows.UI.ViewManagement.Core

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)]
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView

Public NotInheritable Class CoreInputView

Ereditarietà

Object Platform::Object IInspectable CoreInputView

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Vedi anche

• CoreFrameworkInputView