Table of contents
TOC
Recolher sumário
Expandir sumário

Método connectedshapes (Visio)Shape.ConnectedShapes Method (Visio)

office 365 dev account|Última Atualização: 22/03/2018
|
2 Colaboradores

Retorna uma matriz que contém os IDs (identificadores) das formas que são conectadas à forma.Returns an array that contains the identifiers (IDs) of the shapes that are connected to the shape.

SintaxeSyntax

expressão . ConnectedShapes ( Sinalizadores , CategoryFilter )expression . ConnectedShapes( Flags , CategoryFilter )

expressão Uma variável que representa um objeto Shape .expression A variable that represents a Shape object.

ParâmetrosParameters

NomeNameObrigatório/opcionalRequired/OptionalTipo de dadosData TypeDescriçãoDescription
SinalizadoresFlagsObrigatórioRequiredVisConnectedShapesFlagsVisConnectedShapesFlagsFiltra a matriz de IDs de forma retornados pela direcionalidade dos conectores. Consulte Comentários para obter os valores possíveis.Filters the array of returned shape IDs by the directionality of the connectors. See Remarks for possible values.
CategoryFilterCategoryFilterObrigatórioRequiredStringStringFiltra a matriz de IDs de forma retornados limitando-a aos IDs de formas que correspondem à categoria especificada.Filters the array of returned shape IDs by limiting it to the IDs of shapes that match the specified category.

Valor retornadoReturn Value

Long()Long()

ComentáriosRemarks

O valor Flags deve ser uma das constantes VisConnectedShapesFlags a seguir.The Flags value must be one of the following VisConnectedShapesFlags constants.

ConstanteConstantValorValueDescriçãoDescription
visConnectedShapesAllNodesvisConnectedShapesAllNodes00Retorna IDs de formas que são associados às conexões de entrada e de saída.Return IDs of shapes that are associated with both incoming and outgoing connections.
visConnectedShapesIncomingNodesvisConnectedShapesIncomingNodes11Retorna IDs de formas que são associados às conexões de entrada.Return IDs of shapes that are associated with incoming connections.
visConnectedShapesOutgoingNodesvisConnectedShapesOutgoingNodes22Retorna IDs de formas que são associados às conexões de saída.Return IDs of shapes that are associated with outgoing connections.

As categorias são cadeias de caracteres definidas pelo usuário que você pode usar para categorizar formas, e assim, restringir a associação em um contêiner. Você pode definir categorias na célula User.msvShapeCategories do ShapeSheet para uma forma. Você pode definir várias categorias para uma forma separando-as com ponto-e-vírgulas.Categories are user-defined strings that you can use to categorize shapes and thereby to restrict membership in a container. You can define categories in the User.msvShapeCategories cell in the ShapeSheet for a shape. You can define multiple categories for a shape by separating the categories with semi-colons.

Se o objeto de origem for uma forma 1D ou parte de um mestre, o método ConnectedShapes retornará um erro de origem inválida.If the source object is a 1-D shape or part of a master, the ConnectedShapes method returns an Invalid Source error.

Se nenhuma forma conectada qualificada existir, o método ConnectedShapes retorna uma matriz vazia.If no qualifying connected shapes exist, the ConnectedShapes method returns an empty array.

ExemplosExamples

O seguinte macro Visual Basic for Applications (VBA) mostra como usar o método ConnectedShapes para localizar os nomes de todas as formas no final de conexões de saída de uma forma selecionada.The following Visual Basic for Applications (VBA) macro shows how to use the ConnectedShapes method to find the names of all the shapes at the other end of outgoing connections from a selected shape.

O exemplo de código fornecido pelo:ícone de membro da comunidadeFred DiggsSample code provided by:Community Member IconFred Diggs

Public Sub ConnectedShapes_Outgoing_Example()
' Get the shapes that are connected to the selected shape
' by outgoing connectors.
    Dim vsoShape As Visio.Shape
    Dim lngShapeIDs() As Long
    Dim intCount As Integer

    If ActiveWindow.Selection.Count = 0 Then
        MsgBox ("Please select a shape that has connections")
        Exit Sub
    Else
        Set vsoShape = ActiveWindow.Selection(1)
    End If

    lngShapeIDs = vsoShape.ConnectedShapes _
      (visConnectedShapesOutgoingNodes, "")
    Debug.Print "Shapes at the end of outgoing connectors:"
    For intCount = 0 To UBound(lngShapeIDs)
        Debug.Print ActivePage.Shapes(lngShapeIDs(intCount)).Name
    Next
End Sub

A seguinte macro do VBA mostra como usar o método ConnectedShapes para localizar os nomes de todas as formas no final de conexões de entrada para uma forma selecionada.The following VBA macro shows how to use the ConnectedShapes method to find the names of all the shapes at the other end of incoming connections to a selected shape.

O exemplo de código fornecido pelo:ícone de membro da comunidadeFred DiggsSample code provided by:Community Member IconFred Diggs

Public Sub ConnectedShapes_Incoming_Example()
' Get the shapes that are at the other end of 
' incoming connections to a selected shape
    Dim vsoShape As Visio.Shape
    Dim lngShapeIDs() As Long
    Dim intCount As Integer

    If ActiveWindow.Selection.Count = 0 Then
        MsgBox ("Please select a shape that has connections.")
        Exit Sub
    Else
        Set vsoShape = ActiveWindow.Selection(1)
    End If

    lngShapeIDs = vsoShape.ConnectedShapes _
      (visConnectedShapesIncomingNodes, "")
    Debug.Print "Shapes that are at the other end of incoming connections:"
    For intCount = 0 To UBound(lngShapeIDs)
        Debug.Print ActivePage.Shapes(lngShapeIDs(intCount)).Name
    Next
End Sub
© 2018 Microsoft