Propriedade Connect.FromCell (Visio)

Retorna a célula da qual uma conexão se origina. Somente leitura.

Sintaxe

expressão. FromCell

Expressão Uma variável que representa um objeto Connect .

Valor de retorno

Cell

Comentários

Uma conexão é definida por uma referência, em uma célula da forma em que a conexão se origina, a uma célula da forma com a qual a conexão é estabelecida. A propriedade FromCell retorna o objeto Cell relativo à célula da qual a conexão se origina.

A lista a seguir mostra as conexões possíveis e os valores das respectivas propriedades FromCell.

Uma conexão é definida por uma referência, em uma célula da forma em que a conexão se origina, a uma célula da forma com a qual a conexão é estabelecida. A propriedade FromCell retorna o objeto Cell relativo à célula da qual a conexão se origina.

A lista a seguir mostra as conexões possíveis e os valores das respectivas propriedades FromCell.

Desde a célula inicial ou final de uma forma 1D até...

• Uma célula de ponto de conexão: A propriedade FromCell retorna a célula BeginX ou EndX, dependendo de qual ponto de extremidade tenha sido colado.

• Uma célula de um guia ou ponto de guia: Quando a célula inicial ou final de uma forma 1D é colada a uma célula de um guia ou ponto de guia, duas conexões são criadas: uma da célula X do ponto de extremidade à célula Angle do guia e uma da célula Y do ponto de extremidade para a célula Angle do guia. A propriedade FromCell de um dos objetos Connect retorna a célula BeginX ou EndX e a propriedade FromCell do outro objeto Connect retorna a célula BeginY ou EndY, dependendo de qual ponto de extremidade tenha sido colado.

• O pino de uma forma 2D (cria cola dinâmica): A forma da qual a cola se origina deve ser roteável ou ter um tipo de cola dinâmica. A propriedade FromCell retorna a célula BeginX ou EndX, dependendo de qual ponto de extremidade tenha sido colado.

• Qualquer célula de uma linha de vértice em uma seção Geometry: A propriedade FromCell retorna a célula BeginX ou EndX, dependendo de qual ponto de extremidade foi colado.

• A célula inicial ou final de uma forma 1D: A propriedade FromCell retorna a célula BeginX ou EndX, dependendo de qual ponto de extremidade foi colado.

• A borda (uma célula na seção Alinhamento) de uma forma 2D: A propriedade FromCell retorna a célula BeginX ou EndX, dependendo de qual ponto de extremidade foi colado.

Da borda (uma célula na seção Alinhamento) de uma forma 2D para uma célula de um guia ou ponto de guia:

A propriedade FromCell retorna a célula Alignment que está colada à guia.

De uma célula de ponto de conexão para fora ou para dentro/para fora de uma forma 1D para uma célula de ponto de conexão interna ou externa que não é uma célula de um guia ou ponto de guia:

Quando essas células são coladas, duas conexões são criadas: uma da célula BeginX da forma 1D para a célula Connections.X i e outra da célula EndX da forma 1D para a célula Connections.Y i . A propriedade FromCell retorna BeginX de um dos objetos Connect e EndX do outro.

De uma célula do ponto de conexão para fora ou para dentro/para fora de uma forma 2D para uma célula de ponto de conexão para dentro ou para dentro/para fora que não é uma célula de um guia ou ponto de guia:

Se o ponto de conexão para fora não tem direção, a propriedade FromCell retorna a célula PinX. Se o ponto de conexão para fora tem uma direção, dois pontos de conexão são criados. A propriedade FromCell retorna a célula Angle de um dos objetos Connect e a célula PinX do outro.

De uma célula de ponto de controle para...

• Uma célula de ponto de conexão: A propriedade FromCell retorna a célula Controls.X i .

• Uma célula de um guia ou ponto de guia: Quando um ponto de controle é colado a uma célula de um guia ou ponto de guia diferente de uma célula de ponto de conexão, duas conexões são criadas. A propriedade FromCell de um objeto Connect retorna Controls.X i e o segundo objeto Connect retorna Controls.Y i.

• Qualquer célula de uma linha de vértice em uma seção Geometry: A propriedade FromCell retorna a célula Controls.X i .

• A célula inicial ou final de uma forma 1D que não é um guia ou ponto de guia: A propriedade FromCell retorna a célula Controls.X i .

• A borda (uma célula na seção Alinhamento) de uma forma 2D: A propriedade FromCell retorna a célula Controls.X i .

Exemplo

Esta macro do Microsoft Visual Basic for Applications (VBA) mostra como extrair informações de conexão de um desenho do Microsoft Visio. O exemplo exibe as informações de conexão na janela Imediato.

O exemplo presume que haja um documento ativo contendo pelo menos duas formas conectadas.

 
Public Sub FromCell_Example() 
  
    Dim vsoShapes As Visio.Shapes  
    Dim vsoShape As Visio.Shape  
    Dim vsoConnectCell As Visio.Cell  
    Dim vsoConnects As Visio.Connects  
    Dim vsoConnect As Visio.Connect  
    Dim intCurrentShapeID As Integer 
    Dim intCounter As Integer 
    Set vsoShapes = ActivePage.Shapes 
  
    'For each shape on the page, get all its connections. 
    For intCurrentShapeIndex = 1 To vsoShapes.Count  
        Set vsoShape = vsoShapes(intCurrentShapeIndex)  
        Set vsoConnects = vsoShape.Connects  
  
        'For each connection, get the cell the connection  
        'originates from, and print its name in the Immediate window. 
        For intCounter = 1 To vsoConnects.Count  
            Set vsoConnect = vsoConnects(intCounter)  
            Set vsoConnectCell = vsoConnect.FromCell  
            Debug.Print "From " & vsoConnectCell.Name  
        Next intCounter  
 
    Next intCurrentShapeIndex  
 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.