CoreInputView Klasse

Definition

Namespace:

Windows.UI.ViewManagement.Core

Ermöglicht einer App, die Anzeige eines angedockten, nicht angedockten, beweglichen oder transitorischen Eingabebereichs (und der zugeordneten Benutzeroberfläche) zu steuern, Benachrichtigungen zu empfangen, wenn der Bereich verschoben, angezeigt oder ausgeblendet wird, und um zu bestimmen, welcher Teil des App-Fensters durch den Bereich verdeckt wird.

Hinweis

Wird in HoloLens nicht unterstützt.

public ref class CoreInputView sealed

/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView

Public NotInheritable Class CoreInputView

Vererbung

Object Platform::Object IInspectable CoreInputView

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Die primäre Ansicht bezieht sich auf die Ansichten CoreInputViewKind.Keyboard oder CoreInputViewKind.Handwriting , während CoreInputView beliebige Werte aus CoreInputViewKind.Handwriting sein kann.

Wird nur von Frameworks (z. B. XAML) oder benutzerdefinierten Textsteuerelementen verwendet.

Ihre App kann die von diesem Objekt verfügbar gemachten Informationen verwenden, um die Benutzeroberfläche anzupassen und neu zuflowen, um jede Verdeckung zu berücksichtigen.

Die CoreInputView-APIs unterstützen die folgenden Arten von Eingabebereichen.

• Angedockter Soft Input Panel (SIP) wie die Touchtastatur und der Handschriftbereich – in der Regel wird die Benutzeroberfläche Der App neu durchläuft.
• Schwebende Symbolleiste oder SIP: In der Regel wird die App-Benutzeroberfläche nicht neu flowen.
• Überlagern von Bereichen wie Inline-Freihand- oder IME-Kandidatenfenstern. In der Regel wird die App-Benutzeroberfläche nicht für das Bearbeitungssteuerelement neu flowen, sondern für die Text-/Suchvorschläge neu abfließen.

Der Eingabebereich wird angezeigt, wenn der Benutzer eine Aktion ausführt, die die Bereitstellung von Informationen erfordert, z. B. das Eingeben eines Textfelds.

Standardmäßig verarbeitet Windows Eingabebereichereignisse und positioniert Inhalte neu, sodass Benutzer das Steuerelement mit Fokus sehen können. Wenn Sie CoreTextEditContext.InputPaneDisplayPolicy in Ihrer App auf Manuell festlegen, sind Sie für das Anzeigen und Ausblenden des Eingabebereichs mit TryShowPrimaryView und TryHidePrimaryView verantwortlich. Verwenden Sie diese Klasse, um das Standardverhalten zu überschreiben und den Eingabebereich anzupassen.

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

Nachdem Sie sich für den Empfang von Eingabebereichbenachrichtigungen registriert haben, ruft das System Ihren Ereignisdelegat auf, wenn der Bereich 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
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

Methoden

GetCoreInputViewOcclusions()	Ruft einen Verweis auf jeden Eingabebereich ab, der derzeit die App verdeckt.
GetForCurrentView()	Ruft das CoreInputView-Objekt ab, das dem aktuellen Fenster zugeordnet ist.
GetForUIContext(UIContext)	Ruft ein CoreInputView-Objekt ab, das der Ansicht mit dem angegebenen Kontextbezeichner zugeordnet ist.
IsKindSupported(CoreInputViewKind)	Ruft ab, ob der angegebene CoreInputView-Typ unterstützt wird.
TryHide()	Versucht, den Dem CoreInputView-Bereich zugeordneten Eingabebereich auszublenden (sofern sichtbar).
TryHidePrimaryView()	Versucht, den der CoreInputView zugeordneten Eingabebereich auszublenden (sofern sichtbar).
TryShow()	Versucht, den der CoreInputView zugeordneten Eingabebereich anzuzeigen (falls ausgeblendet).
TryShow(CoreInputViewKind)	Versucht, den angegebenen Typ des Eingabebereichs anzuzeigen (falls ausgeblendet), der der CoreInputView zugeordnet ist.
TryShowPrimaryView()	Versucht, den CoreInputView-Bereich anzuzeigen (falls ausgeblendet). Diese Methode ist ein "Best Effort" und garantiert nur, dass der Benutzer eine Möglichkeit hat, mit dem fokussierten Steuerelement zu interagieren. Bei einem angedockten Soft Input Panel (SIP) wie der Touchtastatur- und Handschriftbereich wird der Bereich nur angezeigt, wenn keine Hardwaretastatur verfügbar ist.
TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)	Versucht, den Fokus von der Anwendungsoberfläche in den Eingabebereich zu verschieben.

Ereignisse

OcclusionsChanged	Tritt auf, wenn mindestens ein CoreInputViewOcclusion-Objekt seine Position oder den verschließenden Bereich als Reaktion auf die Neupositionierung des Eingabebereichs ändert, der der CoreInputView zugeordnet ist.
PrimaryViewAnimationStarting	Animationen in der Anwendung, die als Reaktion auf das Ein- oder Ausblenden der primären CoreInputView-Ansicht auftreten.
PrimaryViewHiding	Tritt auf, bevor der Eingabebereich, der der CoreInputView zugeordnet ist, ausgeblendet wird (sofern sichtbar).
PrimaryViewShowing	Tritt auf, bevor der Eingabebereich angezeigt wird, der der CoreInputView zugeordnet ist (falls ausgeblendet).
SupportedKindsChanged	Tritt auf, wenn sich die Auflistung der unterstützten CoreInputViewKind-Ansichten für die CoreInputView ändert.
XYFocusTransferredToPrimaryView	Tritt auf, wenn der Fokus von der Anwendungsoberfläche in den Eingabebereich verschoben wird.
XYFocusTransferringFromPrimaryView	Tritt auf, bevor der Eingabebereich den Fokus verliert und bevor ein UI-Element den Fokus erhält.

Weitere Informationen

• CoreFrameworkInputView