InputPane Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 InputPanePublic NotInheritable Class InputPane- Vererbung
- 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:
- Apps im Vollbildmodus, z. B. Spiele.
- Holografische Windows-Apps in holografischer Ansicht.
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. |