(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

ArcSegment-Klasse

Stellt einen elliptischen Bogen zwischen zwei Punkten dar.

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public sealed class ArcSegment : PathSegment

Der ArcSegment-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeArcSegment() Initialisiert eine neue Instanz der ArcSegment-Klasse.
Öffentliche MethodeArcSegment(Point, Size, Double, Boolean, SweepDirection, Boolean) Initialisiert eine neue Instanz der ArcSegment-Klasse.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftCanFreezeRuft einen Wert ab, der angibt, ob das Objekt als nicht änderbar festgelegt werden kann. (Von Freezable geerbt.)
Öffentliche EigenschaftDependencyObjectTypeRuft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt.  (Von DependencyObject geerbt.)
Öffentliche EigenschaftDispatcherRuft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
Öffentliche EigenschaftHasAnimatedPropertiesRuft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Von Animatable geerbt.)
Öffentliche EigenschaftIsFrozenRuft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist. (Von Freezable geerbt.)
Öffentliche EigenschaftIsLargeArcRuft einen Wert ab, der angibt, ob der Bogen größer als 180 Grad sein soll, oder legt diesen fest.
Öffentliche EigenschaftIsSealedRuft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)
Öffentliche EigenschaftIsSmoothJoinRuft einen Wert ab, der angibt, ob die Verbindung zwischen diesem PathSegment und dem vorherigen PathSegment als Ecke gezeichnet wird, wenn mit einem Pen Striche gezeichnet werden, oder legt diesen fest. (Von PathSegment geerbt.)
Öffentliche EigenschaftIsStrokedRuft einen Wert ab, der angibt, ob das Segment mit Strichen gezeichnet wird, oder legt diesen fest. (Von PathSegment geerbt.)
Öffentliche EigenschaftPoint Ruft den Endpunkt des elliptischen Bogens ab oder legt diesen fest.
Öffentliche EigenschaftRotationAngleRuft den Betrag (in Grad) ab, um den die Ellipse um die x-Achse gedreht wird, oder legt diesen fest.
Öffentliche EigenschaftSize Ruft den x-Radius und den y-Radius des Bogens als Size-Struktur ab oder legt diese fest.
Öffentliche EigenschaftSweepDirection Ruft einen Wert ab, der angibt, ob der Bogen in der Clockwise-Richtung oder der Counterclockwise-Richtung gezeichnet wird, oder legt diesen fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeApplyAnimationClock(DependencyProperty, AnimationClock)Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.)
Öffentliche MethodeApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.)
Öffentliche MethodeBeginAnimation(DependencyProperty, AnimationTimeline)Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.)
Öffentliche MethodeBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.)
Öffentliche MethodeCheckAccessBestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Öffentliche MethodeClearValue(DependencyProperty)Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.)
Öffentliche MethodeClearValue(DependencyPropertyKey)Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.)
Öffentliche MethodeCloneErstellt einen änderbaren Klon der ArcSegment, indem tiefe Kopien von den Werten dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die jedoch möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte.
Öffentliche MethodeCloneCurrentValueErstellt einen änderbaren Klon des ArcSegment-Objekts, indem tiefe Kopien von den aktuellen Werten dieses Objekts erzeugt werden. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert.
Öffentliche MethodeCoerceValueWandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.)
Öffentliche MethodeEqualsBestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.)
Öffentliche MethodeFreeze()Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest. (Von Freezable geerbt.)
Öffentliche MethodeGetAnimationBaseValueGibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Von Animatable geerbt.)
Öffentliche MethodeGetAsFrozenErstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
Öffentliche MethodeGetCurrentValueAsFrozenErstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
Öffentliche MethodeGetHashCodeRuft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.)
Öffentliche MethodeGetLocalValueEnumeratorErstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeGetValueGibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.)
Öffentliche MethodeInvalidatePropertyBerechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.)
Öffentliche MethodeReadLocalValueGibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.)
Öffentliche MethodeSetCurrentValueLegt den Wert einer -Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Von DependencyObject geerbt.)
Öffentliche MethodeSetValue(DependencyProperty, Object)Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Öffentliche MethodeSetValue(DependencyPropertyKey, Object)Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Geschützte MethodeShouldSerializePropertyGibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Öffentliche MethodeVerifyAccessErzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliches EreignisChangedTritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Von Freezable geerbt.)
Zum Seitenanfang

  NameBeschreibung
Öffentliches FeldStatischer MemberIsLargeArcPropertyBezeichnet die IsLargeArc-Abhängigkeitseigenschaft.
Öffentliches FeldStatischer MemberPointProperty Bezeichnet die Point-Abhängigkeitseigenschaft.
Öffentliches FeldStatischer MemberRotationAnglePropertyBezeichnet die RotationAngle-Abhängigkeitseigenschaft.
Öffentliches FeldStatischer MemberSizeProperty Bezeichnet die Size-Abhängigkeitseigenschaft.
Öffentliches FeldStatischer MemberSweepDirectionPropertyBezeichnet die SweepDirection-Abhängigkeitseigenschaft.
Zum Seitenanfang

Verwenden Sie zum Speichern von ArcSegment-Objekten und anderen Segmenten ein PathFigure-Objekt.

Ein elliptischer Bogen wird durch dessen Start- und Endpunkte, den x-Radius und den y-Radius, den Drehfaktor der x-Achse (einen Wert, derangibt, ob der Bogen größer als 180 Grad sein soll) sowie einen Wert definiert, der die Richtung beschreibt, in der der Bogen gezeichnet wird. Die ArcSegment-Klasse enthält keine Eigenschaft für den Anfangspunkt des Bogens. Sie definiert nur den Zielpunkt des dargestellten Bogens. Der Anfangspunkt des Bogens ist der aktuelle Punkt der PathFigure, der das ArcSegment hinzugefügt wird.

Die folgenden Abbildungen veranschaulichen die Einstellungen für den anderen Endpunkt, Size und RotationAngle.

ArcSegments mit unterschiedlichen Point-EinstellungenArcSegments mit unterschiedlichen Size-EinstellungenArcSegments mit unterschiedlichen RotationAngle-Einstellungen

IsLargeArc und SweepDirection

Bei den meisten Angaben für die Position, Größe und Drehung eines Bogens können vier unterschiedliche Bögen gezeichnet werden. Welcher dieser Bögen verwendet werden soll, wird von der IsLargeArc-Eigenschaft und der SweepDirection-Eigenschaft bestimmt.

Von den vier möglichen Bogenkrümmungen stellen zwei große Bögen mit Krümmungen von mindestens 180 Grad dar und zwei kleinere Bögen mit Krümmungen von maximal 180 Grad. Wenn IsLargeArc auf true festgelegt ist, wird eine der beiden größeren Bogenkrümmungen ausgewählt, andernfalls, beim Wert false, wird eine der kleineren Bogenkrümmungen ausgewählt. Die anderen beiden möglichen Bogen werden jeweils in einer anderen Richtung gezeichnet: Counterclockwise oder Clockwise. Die SweepDirection-Eigenschaft gibt an, welche von diesen verwendet werden soll.

Die folgenden Abbildungen veranschaulichen andere Einstellungen für IsLargeArc und SweepDirection.

ArcSegment-Objekte mit anderen IsLargeArc-Einstellungen

ArcSegments mit unterschiedlichen IsLargeArc-Einstellungen
ArcSegment-Objekte mit anderen SweepDirection-Einstellungen

ArcSegments mit unterschiedlichen SweepDirection-Einstellungen

Features von Freezable

Ein ArcSegment ist ein Typ von Freezable-Objekt. Informationen zu Funktionen von Freezable, z. B. Einfrieren und Klonen, finden Sie in der Übersicht über Freezable-Objekte.

In diesem Beispiel wird veranschaulicht, wie ein elliptischer Bogen gezeichnet wird. Verwenden Sie zum Erstellen eines elliptischen Bogens die Klassen PathGeometry, PathFigure und ArcSegment.

In den folgenden Beispielen wird ein elliptischer Bogen von (10,100) nach (200,100) gezeichnet. Der Bogen verfügt über die folgenden Merkmale: Size 100 mal 50 geräteunabhängige Pixel, RotationAngle 45 Grad, IsLargeArc-Festlegung auf true und SweepDirection-Festlegung auf Counterclockwise.

[xaml]

In Extensible Application Markup Language (XAML) können Sie zum Beschreiben eines Pfads die Attributsyntax verwenden.


<Path Stroke="Black" StrokeThickness="1"  
  Data="M 10,100 A 100,50 45 1 0 200,100" />


[xaml]

(Beachten Sie, dass mithilfe dieser Attributsyntax eigentlich eine StreamGeometry erstellt wird, bei der es sich um eine vereinfachte Version von PathGeometry handelt. Weitere Informationen finden Sie auf der Seite Pfadmarkupsyntax.)

Ein elliptischer Bogen kann in XAML ebenfalls explizit mithilfe der Objekttags gezeichnet werden. Das Folgende entspricht dem vorhergehenden XAML-Markup.


<Path Stroke="Black" StrokeThickness="1">
  <Path.Data>
    <PathGeometry>
      <PathGeometry.Figures>
        <PathFigureCollection>
          <PathFigure StartPoint="10,100">
            <PathFigure.Segments>
              <PathSegmentCollection>
                <ArcSegment Size="100,50" RotationAngle="45" IsLargeArc="True" SweepDirection="CounterClockwise" Point="200,100" />
              </PathSegmentCollection>
            </PathFigure.Segments>
          </PathFigure>
        </PathFigureCollection>
      </PathGeometry.Figures>
    </PathGeometry>
  </Path.Data>
</Path>


Dieses Beispiel ist ein Teil eines umfangreicheren Beispiels. Das vollständige Beispiel finden Sie unter Beispiele zu Geometrie.

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2014 Microsoft