Condividi tramite


InputPane Classe

Definizione

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 InputPane
Public NotInheritable Class InputPane
Ereditarietà
Object Platform::Object IInspectable InputPane
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:

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.

Si applica a

Vedi anche