Shape.DistanceFromPoint-Eigenschaft (Visio)

  • Artikel

Gibt den Abstand zwischen einem Shape und einem Punkt zurück. Schreibgeschützt.

Syntax

Ausdruck. DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )

expression Eine Variable, die ein Shape-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
x Erforderlich Double Eine x-Koordinate.
y Erforderlich Double Eine y-Koordinate.
Flags Erforderlich Integer Kennzeichen, die die im Ergebnis zurückgegebenen Eintragstypen beeinflussen.
pvPathIndex Optional Variant Identifiziert in Verbindung mit den Argumenten pvCurveIndex und pvt den Punkt auf dem Shape.
pvCurveIndex Optional Variant Identifiziert in Verbindung mit den Argumenten pvPathIndex und pvt den Punkt auf dem Shape.
Pvt Optional Variant Identifiziert in Verbindung mit den Argumenten pvPathIndex und pvCurveIndex den Punkt auf dem Shape.

Rückgabewert

Gleitkommawert mit doppelter Genauigkeit

Hinweise

Der Punkt ( x,y) wird in internen Zeichnungseinheiten (Zoll in der Zeichnung) in Bezug auf den Koordinatenraum ausgedrückt, der von dem Blatt definiert wird, das unmittelbar ThisShape enthält.

Die Argumente pvPathIndex, pvCurveIndex und pvt geben optional Werte zurück, die den Punkt identifizieren, von dem der zurückgegebene Abstand gemessen wird. Rufen Sie diesen Punkt auf ( xOnThis,yOnThis). Es liegt entlang der c'ten Kurve des p'ten Pfads von ThisShape und kann bestimmt werden durch:

ThisShape.Paths(*pvPathIndex).Item(*pvCurveIndex).Point(*pvt,&xOnThis ,&yOnthis)

Verwenden Sie die PointAndDerivatives-Methode anstelle der Point-Methode , wenn Sie die erste und zweite Ableitung an position t entlang der Kurve finden möchten.

Wenn pvPathIndex oder pvCurveIndex nicht Null ist, wird ein Integer-Wert (Typ VT_I4) zurückgegeben. Wenn pvt nicht Null ist, gibt DistanceFromPoint einen Double-Wert (Typ VT_R8) zurück.

Die DistanceFromPoint-Eigenschaft berücksichtigt, dass Führungslinien eine Erweiterung besitzen und berücksichtigt die gefüllten Bereiche und Pfade eines Shapes.

Das Argument Flags kann eine beliebige Kombination der Konstanten sein, die in der folgenden Tabelle definiert werden. Diese Konstanten werden auch in VisSpatialRelationFlags der Microsoft Visio-Typbibliothek definiert.

Konstante Wert Beschreibung
visSpatialIncludeDataGraphics &H40 Enthält Beschriftungs-Shapes (einschließlich untergeordneter Shapes) für Datengrafiken. Standardmäßig werden Beschriftungs-Shapes für Datengrafiken und ihre untergeordneten Shapes nicht berücksichtigt. Wenn das übergeordnete Shape eine Datengrafikbeschriftung ist und dieses Kennzeichen nicht festgelegt ist, werden Suchläufe zwischen der Geometrie des übergeordneten Shapes und Shapes, die keine Beschriftungs-Shapes sind, durchgeführt.
visSpatialIncludeHidden &H10 Ausgeblendete Geometrie-Abschnitte berücksichtigen. Ausgeblendete Geometry-Abschnitte haben standardmäßig keinen Einfluss auf das Ergebnis.
visSpatialIgnoreVisible &H20 Sichtbare Geometrie-Abschnitte nicht berücksichtigen. Standardmäßig wirken sich sichtbare Geometrie-Abschnitte auf das Ergebnis aus.

Verwenden Sie die Zelle NoShow, um zu bestimmen, ob der Abschnitt Geometry verborgen oder sichtbar ist. Für verborgene Abschnitte enthält die Zelle NoShow den Wert True und für sichtbare Abschnitte enthält diese Zelle den Wert False.

Wenn das übergeordnete Objekt keine Geometrie enthält oder wenn Flags eine Berücksichtigung der Geometrie ausschließt, gibt die DistanceFromPoint-Eigenschaft eine große Zahl (1E+30) zurück, die als unendlich auszulegen ist.

Die DistanceFromPoint-Eigenschaft berücksichtigt beim Berechnen des Ergebnisses keine Breite von Linien, Schatten, Linienenden, Kontrollpunkte oder Verbindungspunkte eines Shapes.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.