Shape.SpatialRelation-Eigenschaft (Visio)Shape.SpatialRelation Property (Visio)

Gibt eine ganze Zahl, die die räumliche Beziehung eines Shapes auf eine andere Form darstellt.Returns an integer that represents the spatial relationship of one shape to another shape. Beide Formen müssen auf dem gleichen Zeichenblatt oder in einem anderen Master sein.Both shapes must be on the same page or in the same master. Schreibgeschützt.Read-only.

SyntaxSyntax

expression.expression. SpatialRelation( _OtherShape_ , _Tolerance_ , _Flags_ )

Ausdruck Eine Variable, die ein Shape -Objekt darstellt.expression A variable that represents a Shape object.

ParameterParameters

NameName Erforderlich/OptionalRequired/Optional DatentypData type BeschreibungDescription
OtherShapeOtherShape ErforderlichRequired [IVSHAPE][IVSHAPE] Das andere Shape -Objekt Gegenstand des Vergleichs.The other Shape object involved in the comparison.
FehlertoleranzTolerance ErforderlichRequired DoubleDouble Ein Abstand, der in internen Zeichnungseinheiten in Bezug auf den Koordinatenbereich durch das übergeordnete Shape -Objekt definiert.A distance in internal drawing units with respect to the coordinate space defined by the Shape object's parent.
FlagsFlags ErforderlichRequired IntegerInteger Flags, die das Ergebnis beeinflussen.Flags that influence the result. Die Werte für dieses Argument finden Sie unter "Hinweise".See Remarks for the values of this argument.

RückgabewertReturn value

Ganze ZahlInteger

HinweiseRemarks

  • Die ganze Zahl, eine beliebige Kombination der Werte in VisSpatialRelationCodes in der Visio-Typbibliothek definiert werden kann.The integer returned can be any combination of the values defined in VisSpatialRelationCodes in the Visio type library. Die SpatialRelation -Eigenschaft gibt NULL (0) zurück, wenn die zwei verglichenen Shapes nicht in einer Beziehung in der Tabelle im Thema VisSpatialRelationCodes beschrieben sind.The SpatialRelation property returns zero (0) if the two shapes being compared are not in any of the relationships discussed in the table in the VisSpatialRelationCodes topic.

  • Das Flags-Argument kann eine beliebige Kombination der Werte der Konstanten in der folgenden Tabelle definiert sein.The Flags argument can be any combination of the values of the constants defined in the following table. Diese Konstanten werden in VisSpatialRelationFlags in der Visio-Typbibliothek deklariert.These constants are declared in VisSpatialRelationFlags in the Visio type library. Verwenden Sie die Zelle NoShow, um zu bestimmen, ob ein Geometrie-Abschnitt ausgeblendet oder sichtbar ist.Use the NoShow cell to determine whether a Geometry section is hidden or visible. Ausgeblendete geometrischen Abschnitte haben den Wert TRUE und sichtbar geometrischen Abschnitte in die Zelle NoShow den Wert FALSE haben.Hidden Geometry sections have a value of TRUE and visible Geometry sections have a value of FALSE in the NoShow cell.

** Konstante **** Constant** ** Wert **** Value** ** Beschreibung **** Description**
visSpatialIncludeContainerShapesvisSpatialIncludeContainerShapes &H80&H80 Enthalten Sie Container mit Daten.Include containers. Standardmäßig werden die Container nicht einbezogen.By default, containers are not included.
visSpatialIncludeDataGraphicsvisSpatialIncludeDataGraphics &H40&H40 Enthält Daten Grafik beschriftungs-Shapes und untergeordneter Shapes.Includes data graphic callout shapes and their sub-shapes. Standardmäßig werden Daten Grafik beschriftungs-Shapes und deren Teil-Shapes nicht einbezogen.By default, data graphic callout shapes and their subshapes are not included. Wenn die übergeordnete Form selbst eine Grafik Daten Legende ist, werden Suchvorgänge zwischen dem übergeordneten Shape-Geometrie und nicht-beschriftungs-Shapes, vorgenommen, wenn dieses Flag festgelegt ist.If the parent shape is itself a data graphic callout, searches are made between the parent shape's geometry and non-callout shapes, unless this flag is set.
visSpatialIncludeGuidesvisSpatialIncludeGuides &H2&H2 Hält eine Führungslinie Geometrie-Abschnitt.Considers a guide's Geometry section. Standardmäßig wirken sich Führungslinien nicht auf das Ergebnis aus.By default, guides do not influence the result.
visSpatialIncludeHiddenvisSpatialIncludeHidden &H10&H10 Reserviert für zukünftige Verwendung.Reserved for future use. Nicht verwenden.Do not use.
visSpatialIgnoreVisiblevisSpatialIgnoreVisible &H20&H20 Berücksichtigt keine sichtbaren geometrischen Abschnitte.Does not consider visible Geometry sections. In der Standardeinstellung beeinflussen sichtbar geometrischen Abschnitte das Ergebnis.By default, visible Geometry sections influence the result.

Hinweis Wenn zwei Shapes verglichen, berücksichtigt die SpatialRelation -Eigenschaft keine die Breite der Linie, Schatten, Linienenden, Steuerpunkte oder Verbindungspunkte eines Shapes.Note When it compares two shapes, the SpatialRelation property does not consider the width of a shape's line, shadows, line ends, control points, or connection points.

BeispielExample

Microsoft Visual Basic für Applikationen (VBA) wird gezeigt, wie die SpatialRelation -Eigenschaft in einem Ereignishandler für das ShapeAdded -Ereignis verwenden, um die räumliche Beziehung zwischen Shapes zu bestimmen.This Microsoft Visual Basic for Applications (VBA) example shows how to use the SpatialRelation property in an event handler for the ShapeAdded event to determine the spatial relationship between shapes.

Stellen Sie bevor das VBA-Projekt mit dem folgenden Code hinzufügen sicher, dass mindestens eine Form auf dem Zeichenblatt vorhanden ist.Before adding the following code to your VBA project, make sure there is at least one shape on the drawing page. Klicken Sie dann nach dem Hinzufügen des Codes, eine andere Form der Zeichnung hinzufügen.Then, after adding the code, add another shape to your drawing.

Public Sub Document_ShapeAdded(ByVal Shape As IVShape) 
 
    Dim vsoShapeOnPage As Visio.Shape  
    Dim intTolerance As Integer 
    Dim intReturnValue As VisSpatialRelationCodes  
    Dim intFlag As VisSpatialRelationFlags  
    Dim strReturn As String 
    On Error GoTo errHandler  
 
    'Initialize tolerance argument. 
    intTolerance = 0.25  
 
    'Initialize flags argument. 
    intFlag = visSpatialIncludeHidden  
    For Each vsoShapeOnPage In ActivePage.Shapes  
 
        'Get the spatial relationship. 
        intReturnValue = Shape.SpatialRelation(vsoShapeOnPage, _  
            intTolerance, intFlag)  
 
        'Convert return code to string value. 
        Select Case intReturnValue       
            Case VisSpatialRelationCodes.visSpatialContain  
                strReturn = "Contains"  
            Case VisSpatialRelationCodes.visSpatialContainedIn  
                strReturn = "is Contained in"  
            Case VisSpatialRelationCodes.visSpatialOverlap  
                strReturn = "overlaps"  
            Case VisSpatialRelationCodes.visSpatialTouching  
                strReturn = "is touching"  
            Case Else 
                strReturn = "has no relation with"  
        End Select  
        
        'Display relationship in the shape's text. 
        vsoShapeOnPage.Text = Shape.Name & " " & strReturn & " " & _  
            vsoShapeOnPage.Name  
 
    Next  
 
errHandler:  
 
End Sub