Shape.DistanceFrom-Eigenschaft (Visio)

  • Artikel

Gibt den Abstand zwischen einem Shape und einem anderen zurück, gemessen zwischen den nächstgelegenen Punkten auf den beiden Formen. Dabei müssen beide Shapes sich auf dem gleichen Zeichenblatt oder in dem gleichen Master-Shape befinden. Schreibgeschützt.

Syntax

Ausdruck. DistanceFrom( _OtherShape_ , _Flags_ )

expression Eine Variable, die ein Shape-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
OtherShape Erforderlich [IVSHAPE] Das andere Shape-Objekt, auf das sich der Vergleich bezieht.
Flags Erforderlich Integer Kennzeichen, die die im Ergebnis zurückgegebenen Eintragstypen beeinflussen.

Rückgabewert

Gleitkommawert mit doppelter Genauigkeit

Hinweise

Die DistanceFrom-Eigenschaft gibt Folgendes zurück:

  • Null, wobei eine Ausnahme ausgelöst wird, wenn sich die verglichenen Shapes in verschiedenen Master-Shapes oder auf verschiedenen Zeichenblättern befinden.

  • Null, wenn die verglichenen Shapes überlappen.

  • Null, wenn ein Shape das andere Shape enthält.

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 Shape oder OtherShape keine Geometrie enthält oder wenn Flags eine Berücksichtigung der Geometrie eines der Shapes ausschließt, gibt die DistanceFrom-Eigenschaft eine große Zahl (1E+30) zurück, die als unendlich auszulegen ist.

Die DistanceFrom-Eigenschaft berücksichtigt beim Vergleich zweier Shapes keine Breite von Linien, Schatten, Linienenden, Kontrollpunkte oder Verbindungspunkte.

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.