InjectedInputPointerOptions Enumeration
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.
Gibt die verschiedenen Optionen oder Modifizierer an, die zum Simulieren der Zeigereingabe über InjectedInputMouseInfo, InjectedInputPenInfo und InjectedInputTouchInfo verwendet werden.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class InjectedInputPointerOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
enum class InjectedInputPointerOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public enum InjectedInputPointerOptions
var value = Windows.UI.Input.Preview.Injection.InjectedInputPointerOptions.none
Public Enum InjectedInputPointerOptions
- Vererbung
-
InjectedInputPointerOptions
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
|
Felder
Canceled | 32768 | Gibt an, dass der Zeiger auf ungewöhnliche Weise abfährt, z. B. wenn das System ungültige Eingaben für den Zeiger empfängt oder wenn ein Gerät mit aktiven Zeigern abrupt abfährt. Wenn die Anwendung, die die Eingabe empfängt, dazu in der Lage ist, sollte sie die Interaktion als nicht abgeschlossen behandeln und alle Auswirkungen des Zeigers umkehren. |
CaptureChanged | 2097152 | Gibt an, dass dieser Zeiger von einem anderen Element erfasst (zugeordnet) wurde und das ursprüngliche Element die Erfassung verloren hat. |
Confidence | 16384 | Gibt einen Vorschlag vom Quellgerät an, ob der Zeiger eine beabsichtigte oder versehentliche Interaktion darstellt. Dies ist besonders für Touchzeiger relevant, bei denen eine versehentliche Interaktion (z. B. mit der Handfläche) Eingaben auslösen kann. Das Vorhandensein dieses Flags weist darauf hin, dass das Quellgerät eine hohe Sicherheit hat, dass diese Eingabe Teil einer beabsichtigten Interaktion ist. |
FirstButton | 16 | Gibt eine primäre Aktion an. Ein Touchzeiger hat dieses Flag festgelegt, wenn er mit der Digitizeroberfläche in Kontakt kommt. Ein Stiftzeiger hat dieses Flag festgelegt, wenn er mit der Digitizeroberfläche in Kontakt kommt, ohne dass Schaltflächen gedrückt werden. Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die linke Maustaste ausfällt. |
InContact | 4 | Gibt an, dass der Zeiger mit der Oberfläche oder dem Bereich des Digitizers in Kontakt steht. Wenn dieses Flag nicht festgelegt ist, gibt es einen zeigernden Zeiger an. |
InRange | 2 | Gibt an, dass der Zeiger weiterhin vorhanden ist. Wenn dieses Flag nicht festgelegt ist, gibt dies an, dass der Zeiger den Erkennungsbereich verlassen hat. |
New | 1 | Gibt die Ankunft eines neuen Zeigers an. |
None | 0 | Kein Zeigermodifizierer. Standard. |
PointerDown | 65536 | Gibt an, dass dieser Zeiger kontakt mit der Digitizeroberfläche hergestellt hat. Ein Fingereingabezeiger hat dieses Flag festgelegt, wenn er mit der Digitalisiereroberfläche in Kontakt steht. Bei einem Stiftzeiger ist dieses Flag festgelegt, wenn er mit der Digitalisiereroberfläche in Kontakt steht. Bei einem Mauszeiger ist dieses Flag festgelegt, wenn eine Maustaste gedrückt wird. |
PointerUp | 262144 | Gibt an, dass dieser Zeiger den Kontakt mit der Digitizeroberfläche beendet hat. Bei einem Fingereingabezeiger ist dieses Flag festgelegt, wenn der Kontakt mit der Digitalisiereroberfläche beendet wird. Bei einem Stiftzeiger ist dieses Flag festgelegt, wenn der Kontakt mit der Digitalisiereroberfläche beendet wird. Bei einem Mauszeiger ist dieses Flag festgelegt, wenn eine Maustaste losgelassen wird. |
Primary | 8192 | Gibt an, dass der Zeiger Aktionen ausführen kann, die über die für nicht primäre Zeiger verfügbaren hinausgehen. Wenn z. B. ein primärer Zeiger mit der Oberfläche eines Fensters in Kontakt tritt, kann er dem Fenster eine Aktivierungsmöglichkeit bieten. Der primäre Zeiger wird aus allen aktuellen Benutzerinteraktionen auf dem System (Maus, Toucheingabe, Stift usw.) identifiziert. Daher ist der primäre Zeiger möglicherweise nicht Ihrer App zugeordnet. Der erste Kontakt in einer Multitouchinteraktion wird als primärer Zeiger festgelegt. Sobald ein primärer Zeiger identifiziert wurde, müssen alle Kontakte aufgehoben werden, bevor ein neuer Kontakt als primärer Zeiger identifiziert werden kann. Für Apps, die zeigereingaben nicht verarbeiten, werden nur die Ereignisse des primären Zeigers zu Mausereignissen heraufgestuft. |
SecondButton | 32 | Gibt eine sekundäre Aktion an. Ein Fingereingabezeiger verwendet dieses Flag nicht. Bei einem Stiftzeiger ist dieses Flag festgelegt, wenn er mit der Digitalisiereroberfläche in Kontakt steht und die Stiftfasstaste gedrückt ist. Bei einem Mauszeiger ist dieses Flag festgelegt, wenn die rechte Maustaste nach unten ist. |
Update | 131072 | Gibt ein einfaches Update an, das keine Zeigerzustandsänderungen enthält. |
Beispiele
Hier sind einige herunterladbare Beispiele, die die grundlegende Eingabe- und Eingabeinjektion veranschaulichen:
- Eingabeeinschleusungsbeispiel (Maus zur Berührung)
- Beispiel für touchinjektion
- Eingabe: Beispiel für XAML-Benutzereingabeereignisse
Hinweise
Wichtig
Die APIs in diesem Namespace erfordern die eingeschränkte Funktion inputInjectionBrokered.
Bei Verwendung der Eingabeeinschleusung muss Dem Package.appxmanifest Folgendes hinzugefügt werden:
- An
<Package>
xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
IgnorableNamespaces="rescap"
- An
<Capabilities>
<rescap:Capability Name="inputInjectionBrokered" />