Punkt Structure

Stellt ein geordnetes Paar von x- und y-Koordinaten dar, das einen Punkt in einem zweidimensionalen Raum definiert.

Syntax


var point = {
    x : /* Ihr Wert */,
    y : /* Ihr Wert */
}


<object property="X,Y"/>
-or
<object property="X Y"/>

XAML Values

X

Der x-Koordinatenkomponente des Point-Werts.

Y

Der y-Koordinatenkomponente des Point-Werts.

Attribute

[Version(0x06020000)]

Member

PointStruktur hat diese Membertypen:

Konstruktoren

PointStruktur hat diese Konstruktoren.

KonstruktorBeschreibung
Point [C#, VB]Initializes a Point structure that contains the specified values.
Point [C++, JavaScript]Initializes a Point structure that contains the specified values.

 

Felder

PointStruktur hat diese Felder.

FeldDatentypBeschreibung
X | x [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Die horizontale Position des Punkts.

Y | y [C++, JavaScript]

Number [JavaScript] | System.Single [.NET] | float32 [C++]

Die vertikale Position des Punkts.

 

Methoden

The Point Struktur hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
Equals(Object) [C#, VB]Determines whether the specified object is equal to a Point.
Equals(Point) [C#, VB]Compares two Point structures for equality.
GetHashCode [C#, VB]Gets a hash code for this object.
ToString [C#, VB]Converts a Point to a String representation.
ToString(IFormatProvider) [C#, VB]Creates a String representation of this Point.

 

Operatoren

PointStruktur hat diese Operatoren.

OperatorBeschreibung
Equality Compares two Point structures for equality.
Inequality Compares two Point structures for inequality.

 

Eigenschaften

Der PointStruktur hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

X

Lese-/SchreibzugriffGets or sets the X-coordinate value of this Point.

Y

Lese-/SchreibzugriffGets or sets the Y-coordinate value of this Point.

 

Hinweise

Ein Point-Wert stellt gelegentlich auch einen Koordinatenraum auf der Ebene des Hauptfensters einer App dar. Es gibt aber andere mögliche Interpretationen von Point-Werten, die variieren können. Dies hängt von der Eigenschaft ab, die den Point-Wert verwendet.

JavaScript:  In JavaScript ist ein Point ein Objekt mit zwei Dateneigenschaften: x und y. Anders als x und y gelten die übrigen APIs, die in den Point-Memberlisten aufgeführt sind, nicht für die JavaScript-Programmierung.

Hinweise zur XAML-Syntax

Point-Werte werden umfassend für Grafikeigenschaften und ähnliche UI-Eigenschaften während des XAML-Vokabulars für Windows-Runtime-UI-Elemente verwendet.

Als Trennzeichen zwischen X und Y kann ein Leerzeichen oder ein Komma verwendet werden. Die allgemeine Konvention für Koordinatenpunkte besteht in der Verwendung eines Kommatrennzeichens.

Point-Strukturen können nicht als Ressourcen in einem ResourceDictionary deklariert werden.

Einige XAML-Verwendungen nutzen den Point-Typ zu Darstellung eines logischen Punkts. Weitere Informationen finden Sie in den Anmerkungen im Abschnitt "Logische Punkte".

Projektion und Member des Punkts

Wenn Sie eine Microsoft .NET-Sprache verwenden (C# oder Microsoft Visual Basic) oder Visual C++-Komponentenerweiterungen (C++/CX), sind für den Point Nichtdatenmember verfügbar, und seine Datenmember werden nicht als Felder, sondern als Eigenschaften mit Lese-/Schreibzugriff verfügbar gemacht.

Wenn Sie mit C++ unter Verwendung der Windows Template Runtime Library (WRL) programmieren, sind nur die Datenmemberfelder als Member von Point vorhanden, und Sie können die in der Membertabelle aufgeführten Hilfsprogramm-Methoden oder Eigenschaften nicht verwenden. WRL-Code kann auf ähnliche Hilfsmethoden zugreifen, die auch in der statischen PointHelper-Klasse verfügbar sind.

Point-Werte und wie sie von Eigenschaften interpretiert werden

Einige (aber nicht alle) Verwendungen des Point-Typs geben eine Position in einem Koordinatenraum an. Abhängig vom Kontext kann sich der Speicherort im Verweisrahmen eines Inhaltsbereichs oder innerhalb des Verweisrahmens für ein bestimmtes Layoutelement befinden.

X und Y für einen Point können in einigen Fällen nicht ganzzahlige Werte sein.

X und Y für Point können in einigen Fällen negativ sein. In der Regel führt dies zu einer Point, die eine Koordinate angibt, die absichtlich außerhalb des Bezugssystems liegt, sofern es keine weitere Übersetzung gibt. Einige XAML-Eigenschaften weisen jedoch einen Point mit negativem X oder Y als ungültigen Wert zurück. Werteinschränkungen werden in der Regel auf den Referenzseiten für Eigenschaften aufgeführt.

Logische Punkte

Einige Verwendungen des Point-Typs in Windows Store-Apps, die C++-, C#- oder Visual Basic-APIs verwenden, beziehen sich nicht direkt auf Koordinatenbezugssysteme. Stattdessen handelt es sich um logische Punkte, bei denen der erwartete Wert von X und Y jeweils zwischen 0 und 1 (inklusive) liegt. Dies ist ein häufiger Grund dafür, dass die Werte X und Y nicht auf ganzzahlige Werte beschränkt sind, sondern Gleitkommawerte verwendet werden können. Die logischen Punktwerte werden so interpretiert, dass die Laufzeitkoordinaten für die Darstellung oder das Verhalten möglicherweise von einer anderen Eigenschaft oder Einstellung angegeben oder geändert werden können. Oder manchmal enthalten die Punkte Informationen, die sich nicht auf den Koordinatenbereich beziehen. Beispiele für das logische Punktkonzept sind die Werte von Animation.KeySpline (platziert eine Animation), die RenderTransformOrigin-Eigenschaft einer UIElement-Klasse und die GradientStop.Offset-Werte für die LinearGradientBrush-Klasse.

Eine Point-Werteigenschaft, die eine logische Punktverwendung darstellt, kann Werte kleiner als 0 oder größer als 1 möglicherweise ungültig machen. Dieses Verhalten hängt jedoch von der jeweiligen Eigenschaft ab. Werteinschränkungen sind normalerweise auf den Referenzseiten für einzelne Eigenschaften anstatt im Wert aufgeführt.

Punktwerte und XAML-Grafik-APIs

Die grafischen Elemente, die zum Definieren einer XAML-UI verwendet werden, verwenden häufig Point-Werteigenschaften, um ihre Eigenschaften zu deklarieren. Beispielsweise verwendet eine EllipseGeometry einen Point-Wert, um ihre Center-Eigenschaft festzulegen.

Die grafischen Elemente verwenden eines der beiden Modelle. Einige der Grafikelemente sind von FrameworkElement abgeleitet. Diese Elemente verfügen über ein definiertes Renderingverhalten, wenn sie in einer UI platziert werden und wenn Elementeigenschaften zugewiesen werden. Beispiele für diesen Elementtyp sind Rectangle und alle andere Typen im Windows.UI.Xaml.Shapes-Namespace. Andere Grafikelemente leiten keine Werte von FrameworkElement ab und besitzen kein eigenes Verhalten zum Rendern. Stattdessen werden diese Elemente zusammengestellt, um den Wert einer Eigenschaft für ein anderes Element bereitzustellen, das ein Renderverhalten hat. Beispielsweise verfügen die grafischen Elemente, die Sie zum Zusammensetzen von Path.Data, wie LineSegment, verwenden, häufig über eine Point-Werteigenschaft.

Einige Grafikelemente verwenden die Mehrfachwerte, die in einer einzelnen Eigenschaft dargestellt werden. Diese Eigenschaften verwenden den PointCollection-Typ. Diese Eigenschaften unterstützen auch eine XAML-Syntax, die Attributzeichenfolge analysiert, um X und Y-Werte für mehrere Punkte abzurufen. Ein Beispiel einer Grafikelementeigenschaft, die PointCollection verwendet und Polygon.Points ist.

Point-Werte aus XAML-Eingabeereignissen und für Treffertests

Ein Point-Wert wird durch die Ereignisdaten für bestimmte Eingabeereignisse zurückgegeben. Beispielsweise stellt GetCurrentPoint einen Koordinatenwert bereit, von dem ein Pointer-Ereignis auf der Benutzeroberfläche der App aufgetreten ist. Im Allgemeinen verweisen diese Point-Werte auf ein bestimmtes Koordinatenbezugssystem. Dieses Bezugssystem ist wichtig. Bei Eingabeereignissen ist das Anwendungshauptfenster das Bezugssystem, nicht der gesamte Bildschirm. Dadurch wird ein konsistentes Bezugssystem ermöglicht, falls sich die App in der angedockten Ansicht befindet. Einige APIs wie GetCurrentPoint und GetPosition bieten auch eine Möglichkeit, zu einem elementspezifischen Bezugssystem zu übersetzen. Das ist beim Arbeiten mit Eingabe in ein einzelnes Steuerelement nützlich. Weitere Informationen finden Sie unter Schnellstart: Zeiger.

Die XAML-Benutzeroberfläche verfügt auch über ein Konzept mit der Bezeichnung "Treffertests". Mit diesem können Sie Hilfsprogrammmethoden verwenden, um zu testen, wie Eingabeereignisse die Quelle bilden würden, wenn der Benutzer eine Zeigeraktion an einer bestimmten Koordinatenposition der Benutzeroberfläche ausführen würde. Beispielsweise verwenden zwei Signaturen von FindElementsInHostCoordinates einen Point-Eingabeparameter, wie auch FindSubElementsForTouchTargeting. Weitere Informationen finden Sie unter Reaktion auf Mauseingaben.

Animieren von Punktwerten

Die Windows-Runtime bietet eine Möglichkeit, um die Werte jeder Eigenschaft zu animieren, die einen Point als Wert verwendet und als Abhängigkeitseigenschaft implementiert wird. Point verfügt über eine eigene Animationsunterstützung, da es nicht möglich ist, die x- und y-Werte eines Point individuell zu animieren, da Strukturen keine Abhängigkeitseigenschaften unterstützen können. Verwenden Sie den PointAnimation-Typ für From/To-Animationen, oder verwenden Sie abgeleitete PointAnimationUsingKeyFrames-Typen für Keyframe-Animationsverhalten. Weitere Informationen dazu, wie Sie einen Point-Wert animieren und zur Funktionsweise von Animationen finden Sie unter Storyboard-Animationen.

Anforderungen

Mindestens unterstützter Client

Windows 8

Mindestens unterstützter Server

Windows Server 2012

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

Windows.Foundation
Windows::Foundation [C++]

Metadaten

Windows.winmd
Platform.winmd

Assembly

System.Runtime.WindowsRuntime.dll

Siehe auch

PointAnimation
PointCollection
Schnellstart: Zeiger
Schnellstart: Zeichnen von Formen

 

 

Anzeigen:
© 2014 Microsoft