Freigeben über


InputPane Klasse

Definition

Ermöglicht es einer App, Benachrichtigungen zu empfangen, wenn die angedockte Touchtastatur oder der Soft Input Panel (SIP) angezeigt oder ausgeblendet wird, und um zu bestimmen, welcher Teil des Anwendungsfensters durch den Eingabebereich verdeckt wird.

Hinweis

Die InputPane-APIs bieten nur genaue Okklusionsinformationen für ein angedocktes Panel. Für Windows 10 Creators Fall Update und höher empfiehlt es sich, die folgenden APIs zu verwenden, um die Okklusion durch angedockte, nicht angedockte, bewegliche und transitorische Eingabebereiche wie Soft Input Panels (SIP), Eingabemethoden-Editor-Kandidatenfenster (IME), nicht verwendete Symbolleisten usw. zu verarbeiten.

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
Vererbung
Object Platform::Object IInspectable InputPane
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Der Eingabebereich wird angezeigt, wenn der Benutzer eine Aktion ausführt, die die Eingabe von Informationen erfordert, z. B. das Auswählen eines Texteingabefelds. Standardmäßig verarbeitet Windows die Eingabebereichereignisse und positioniert Inhalte neu, sodass Benutzer sehen können, wo sie eingeben. Wenn Sie CoreTextEditContext.InputPaneDisplayPolicy in Ihrer App auf Manuell festlegen, sind Sie dafür verantwortlich, den Eingabebereich mithilfe von TryShow und TryHide anzuzeigen und auszublenden. Verwenden Sie diese Klasse, um das Standardverhalten zu überschreiben und den Eingabebereich anzupassen.

In einigen Fällen wird die Überlagerungsbenutzeroberfläche wie ein InputPane nicht vollständig unterstützt. Dies schließt Folgendes ein:

Rufen Sie GetForCurrentView auf, um ein InputPane-Objekt abzurufen.

Nachdem Sie sich für den Empfang von Eingabebereichbenachrichtigungen registriert haben, ruft das System Ihren Ereignisdelegat auf, wenn der Eingabebereich für das Fenster angezeigt wird, das beim Aufrufen der GetForCurrentView-Methode sichtbar war.

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading und Marshalling (C++/CX).

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1903 18362 GetForUIContext

Eigenschaften

OccludedRect

Ruft den Bereich des App-Fensters ab, der vom Eingabebereich verdeckt wird.

Visible

Ruft einen Wert ab, der angibt, ob der Eingabebereich angezeigt wird, oder legt diesen fest.

Wichtig

Gilt nur für die Xbox-Gerätefamilie.

Bei universellen Apps gibt die OccludedRect-Eigenschaft den Bereich des App-Fensters an, der durch den Eingabebereich blockiert wird.

Methoden

GetForCurrentView()

Ruft das InputPane-Objekt ab, das dem derzeit sichtbaren Anwendungsfenster zugeordnet ist.

GetForUIContext(UIContext)

Ruft das InputPane-Objekt ab, das der Ansicht mit dem angegebenen Kontextbezeichner zugeordnet ist.

TryHide()

Versucht, den InputPane auszublenden, wenn er sichtbar ist.

TryShow()

Versucht, den InputPane anzuzeigen, wenn er ausgeblendet ist.

Diese Methode ist eine "best effort" und garantiert nur, dass der Benutzer eine Möglichkeit hat, Text in das fokussierte Steuerelement einzugeben. Die Touchtastatur oder der Soft Input Panel (SIP) wird nur angezeigt, wenn keine Hardwaretastatur verfügbar ist.

Ereignisse

Hiding

Tritt auf, wenn der Eingabebereich beginnt, aus der Sicht zu gleiten.

Showing

Tritt auf, wenn der Eingabebereich beginnt, in die Ansicht zu gleiten.

Gilt für:

Weitere Informationen