Shape.DistanceFrom-Eigenschaft (Visio)
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.