Ler em inglês

Compartilhar via


Método Cell.GlueTo (Visio)

Cola uma forma na outra, de uma célula na primeira forma a uma célula na segunda forma.

Sintaxe

expressão. GlueTo (CellObject)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
CellObject Obrigatório [IVCELL] Uma expressão que retorna um objeto Cell que representa a parte da forma à qual associar.

Valor de retorno

Nada

Comentários

A seguir uma lista de conexões possíveis.

A seguir uma lista de conexões possíveis.

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

  • Uma célula de ponto de conexão.

  • 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 BeginX ou EndX para a célula Angle do guia e uma da célula BeginY ou EndY para a célula Angle do guia.

  • O pino de uma forma 2D (cria cola dinâmica): A forma que está sendo colada deve ser roteável (ObjType inclui visLOFlagsRoutable) ou ter um tipo de cola dinâmica (GlueType inclui visGlueTypeWalking) e não proíbe cola dinâmica (GlueType não inclui visGlueTypeNoWalking). Associar a PinX cria associação dinâmica com uma preferência de direção horizontal e associar a PinY cria associação dinâmica com uma preferência de direção vertical.

  • Qualquer célula de uma linha de vértice em uma seção Geometry: Um ponto de conexão é criado que está colado. A célula de início ou final pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

  • A célula inicial ou final de uma forma 1D: Um ponto de conexão é criado que está colado. A célula de início ou final pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

  • A borda (uma célula na seção Alinhamento) de uma forma 2D: Um ponto de conexão é criado que está colado. A célula de início ou final pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

Da borda (uma célula na seção Alinhamento) de uma forma 2D até uma célula de um guia ou ponto de 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.Xi e outra da célula EndX da forma 1D para a célula Connections.Y i .

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 externo tiver uma direção, dois pontos de conexão serão criados: um da célula Angle para a célula Connections.X i e outro da célula PinX para a célula Connections.Y i .

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

  • Uma célula de ponto de conexão.

  • Uma célula de uma guia ou ponto de guia: quando um ponto de controle for colado a uma célula de uma guia ou ponto de guia que não seja uma célula de ponto de conexão, duas conexões serão criadas — uma à PinX da guia e outra à PinY da guia.

  • Qualquer célula de uma linha de vértice em uma seção Geometry: Um ponto de conexão é criado que está colado. Qualquer célula na linha do ponto de controle pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

  • A célula inicial ou final de uma forma 1D que não é um guia ou ponto de guia: Um ponto de conexão é criado que está colado. Qualquer célula na linha do ponto de controle pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

  • A borda (uma célula na seção Alinhamento) de uma forma 2D: Um ponto de conexão é criado que está colado. Qualquer célula na linha do ponto de controle pode ser designada como a célula de onde colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de conexão.

Para obter detalhes sobre o tipo e a direção do ponto de conexão, consulte a seção Connection Points.

Exemplo

A seguinte macro mostra como usar o método GlueTo para associar formas.

 
Public Sub GlueTo_Example()  
 
    Dim vso1DShape As Visio.Shape  
    Dim vso2DShape1 As Visio.Shape  
    Dim vso2DShape2 As Visio.Shape  
    Dim vsoCellGlueFromBegin As Visio.Cell  
    Dim vsoCellGlueFromEnd As Visio.Cell  
    Dim vsoCellGlueToObject As Visio.Cell  
    Dim vsoCellGlueToObject2 As Visio.Cell  
 
    'Draw a line.  
    Set vso1DShape = ActivePage.DrawLine(3, 5, 5, 3)  
 
    'Draw the lower rectangle.  
    Set vso2DShape1 = ActivePage.DrawRectangle(1, 1, 4, 2)  
 
    'Draw the upper rectangle.  
    Set vso2DShape2 = ActivePage.DrawRectangle(5, 5, 8, 6)  
 
    'Get the Cell objects needed to make the connections.  
    Set vsoCellGlueFromBegin = vso1DShape.Cells("BeginX")  
    Set vsoCellGlueFromEnd = vso1DShape.Cells("EndX")  
    Set vsoCellGlueToObject = vso2DShape1.Cells("Geometry1.X3")  
    Set vsoCellGlueToObject2 = vso2DShape2.Cells("Geometry1.X1")  
 
    'Use the GlueTo method to glue the begin point of the 1D shape  
    'to the top right vertex (Geometry1.X3) of the lower 2D shape.  
    vsoCellGlueFromBegin.GlueTo vsoCellGlueToObject  
 
    'Use the GlueTo method to glue the endpoint of the 1D shape  
    'to the bottom left vertex (Geometry1.X1) of the upper 2D shape.  
    vsoCellGlueFromEnd.GlueTo vsoCellGlueToObject2  
 
    'You can also use the GlueTo method to glue  
    'by referencing a connection point cell.  
    Set vso1DShape = ActivePage.DrawLine(3, 5, 5, 3)  
    Set vsoCellGlueFromEnd = vso1DShape.Cells("EndX")  
    Set vsoCellGlueToObject = vso2DShape1.Cells("Connections.X1")  
    vsoCellGlueFromEnd.GlueTo vsoCellGlueToObject  
 
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.