CoreInputView Classe
Definizione
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.
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 CoreInputViewPublic NotInheritable Class CoreInputView- Ereditarietà
- 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. |