Cell.GlueTo method (Visio) (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 De célula .

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 de início ou de fim 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 de início ou fim de uma forma 1D está colada a uma célula de um guia ou ponto de guia, são criadas duas ligações: uma da célula BeginX ou EndX à célula Angle do guia e outra da célula BeginY ou EndY até à célula Angle do guia.

• O pino de uma forma 2D (cria cola dinâmica): A forma que está a ser colada tem de ser encaminhável (ObjType inclui visLOFlagsRoutable) ou ter um tipo de cola dinâmico (GlueType inclui visGlueTypeWalking) e não proíbe a 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 numa secção de Geometria: É criado um ponto de ligação colado a. A célula de início ou de fim pode ser designada como a célula a partir da quais colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligação.

• A célula de início ou de fim de uma forma 1D: É criado um ponto de ligação colado a. A célula de início ou de fim pode ser designada como a célula a partir da quais colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligação.

• O limite (uma célula na secção Alinhamento) de uma forma 2D: É criado um ponto de ligação colado a. A célula de início ou de fim pode ser designada como a célula a partir da quais colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligação.

Da margem (uma célula na secção Alinhamento) de uma forma 2D a uma célula de um guia ou ponto de guia.

De uma célula de ponto de ligação para fora ou para dentro/para fora de uma forma 1D para uma célula de ponto de ligação para dentro ou para dentro/para fora que não seja uma célula de um guia ou ponto de guia: Quando estas células estão coladas, são criadas duas ligações: uma da célula BeginX da forma 1D para a célula Connections.Xi e a outra da célula EndX da forma 1D até à célula Connections.Y i .

De uma célula de ponto de ligação para fora ou para dentro/para fora de uma forma 2D para uma célula de ponto de ligação de tipo para dentro ou para dentro/para fora que não seja uma célula de um guia ou ponto de guia: Se o ponto de ligação para fora tiver uma direção, são criados dois pontos de ligação: um da célula Ângulo para a célula Connections.X i e o 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 numa secção de Geometria: É criado um ponto de ligação colado a. Qualquer célula na linha do ponto de controlo pode ser designada como a célula a partir da qual colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligação.

• A célula de início ou fim de uma forma 1D que não é um guia ou ponto de guia: É criado um ponto de ligação colado a. Qualquer célula na linha do ponto de controlo pode ser designada como a célula a partir da qual colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligação.

• O limite (uma célula na secção Alinhamento) de uma forma 2D: É criado um ponto de ligação colado a. Qualquer célula na linha do ponto de controlo pode ser designada como a célula a partir da qual colar. O método GlueTo estabelece novas fórmulas nas células X e Y da linha de ligaçã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.