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

mais simples. GlueTo (CellObject)

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

Parâmetros

Valor de retorno

Nada

Comentários

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

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

Da célula inicial ou final de uma forma 1D para...

• 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 é associada a uma célula de uma guia ou ponto de guia, duas conexões são criadas: uma da célula BeginX ou EndX com a célula Angle da guia e outra da célula BeginY ou EndY com a célula Angle da guia.

• O pino de uma forma 2D (cria cola dinâmica): A forma que está sendo associada deve ser roteável (ObjType inclui visLOFlagsRoutable) ou ter um tipo de associação dinâmica ( GlueType inclui visGlueTypeWalking) e não proíbe a associação 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 Geometria: É criado um ponto de conexão que está associado. A célula inicial ou final pode ser designada como a célula da qual associar. 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: É criado um ponto de conexão que está associado. A célula inicial ou final pode ser designada como a célula da qual associar. 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: É criado um ponto de conexão que está associado. A célula inicial ou final pode ser designada como a célula da qual associar. 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 para uma célula de uma 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 para dentro ou para dentro/para fora que não seja uma célula de uma guia ou ponto de guia: Quando essas células são associadas, duas conexões são criadas: uma da célula BeginX da forma 1D para a célula Connections.Xi e a outra da célula EndX da forma 1D para a célula Connections.Y i .

De uma célula de ponto de conexão para fora ou para dentro/para fora de uma forma 2D para uma célula de ponto de conexão do tipo para dentro ou para dentro/para fora que não seja uma célula de uma guia ou ponto de guia: Se o ponto de conexão para fora 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 Geometria: É criado um ponto de conexão que está associado. Qualquer célula na linha do ponto de controle pode ser designada como a célula da qual associar. 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 é uma guia ou ponto de guia: É criado um ponto de conexão que está associado. Qualquer célula na linha do ponto de controle pode ser designada como a célula da qual associar. 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: É criado um ponto de conexão que está associado. Qualquer célula na linha do ponto de controle pode ser designada como a célula da qual associar. 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.