InputPane 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 ricevere notifiche quando la tastiera virtuale ancorata o il pannello SIP (Soft Input Panel), sta per essere visualizzata o nascosta e per determinare quale parte della finestra dell'applicazione è nascosta dal riquadro di input.
Nota
Le API InputPane forniscono informazioni accurate sull'occlusione solo per un pannello ancorato. Per Windows 10 Creators Fall Update e versioni successive, è consigliabile usare le API seguenti per gestire l'occlusione tramite i riquadri di input ancorati, non ancorati, spostabili e transitori, ad esempio pannelli di input soft (SIP), finestre candidate dell'editor di metodi di input (IME), barre degli strumenti mobili e così via.
public ref class InputPane sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPanePublic NotInheritable Class InputPane- Ereditarietà
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
Il riquadro di input viene visualizzato quando l'utente esegue un'azione che richiede l'immissione di informazioni, ad esempio la selezione di un campo di immissione di testo. Per impostazione predefinita, Windows gestisce gli eventi del riquadro di input e riposiziona il contenuto in modo che gli utenti possano vedere dove digitano. Se imposti CoreTextEditContext.InputPaneDisplayPolicy su Manuale nella tua app, devi visualizzare e nascondere il riquadro di input usando TryShow e TryHide. Usare questa classe per eseguire l'override del comportamento predefinito e personalizzare il riquadro di input.
In alcuni casi, l'interfaccia utente di sovrapposizione, ad esempio inputpane, non è completamente supportata. ad esempio:
- app in modalità schermo intero, come i giochi.
- App di Windows Holographic nella visualizzazione olografica.
Chiamare GetForCurrentView per ottenere un oggetto InputPane.
Dopo la registrazione per ricevere le notifiche del riquadro di input, il sistema chiama il delegato dell'evento ogni volta che il riquadro di input 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 |
|---|---|---|
| 1903 | 18362 | GetForUIContext |
Proprietà
| OccludedRect |
Ottiene l'area della finestra dell'app nascosta dal riquadro di input. |
| Visible |
Ottiene o imposta un valore che indica se viene visualizzato il riquadro di input. Importante Valido solo per la famiglia di dispositivi Xbox. Per le app universali, la proprietà OccludedRect indica l'area della finestra dell'app bloccata dal riquadro di input. |
Metodi
| GetForCurrentView() |
Ottiene l'oggetto InputPane associato alla finestra dell'applicazione attualmente visibile. |
| GetForUIContext(UIContext) |
Ottiene l'oggetto InputPane associato alla visualizzazione con l'identificatore di contesto specificato. |
| TryHide() |
Tenta di nascondere InputPane, se visibile. |
| TryShow() |
Prova a visualizzare InputPane, se è nascosto. Questo metodo è un metodo "migliore sforzo" e garantisce solo che l'utente abbia un modo per immettere testo nel controllo attivo. La tastiera virtuale o il pannello SIP (Soft Input Panel), viene visualizzato solo se non è disponibile una tastiera hardware. |
Eventi
| Hiding |
Si verifica quando il riquadro di input inizia a scorrere all'esterno della visualizzazione. |
| Showing |
Si verifica quando il riquadro di input inizia a scorrere in visualizzazione. |