Método de ConnectorFormat. endConnect (Excel)ConnectorFormat.EndConnect method (Excel)

Anexa o final do conector especificado a uma forma específica.Attaches the end of the specified connector to a specified shape. Se já houver uma conexão entre o final do conector e outra forma, essa conexão será desfeito.If there's already a connection between the end of the connector and another shape, that connection is broken.

Se o final do conector não estiver posicionado no site de conexão especificado, esse método Move o final do conector para o site de conexão e ajusta o tamanho e posição do conector.If the end of the connector isn't already positioned at the specified connecting site, this method moves the end of the connector to the connecting site and adjusts the size and position of the connector.

Use o método BeginConnect para anexar o início do conector a uma forma.Use the BeginConnect method to attach the beginning of the connector to a shape.

SintaxeSyntax

expressão. EndConnect (ConnectedShape, ConnectionSite)expression.EndConnect (ConnectedShape, ConnectionSite)

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

ParâmetrosParameters

NomeName Obrigatório/OpcionalRequired/Optional Tipo de dadosData type DescriçãoDescription
ConnectedShapeConnectedShape ObrigatórioRequired ShapeShape A forma para anexar a extremidade do conector.The shape to attach the end of the connector to. O objeto Shape especificado deve ser no mesmo conjunto de formas que o conector.The specified Shape object must be in the same Shapes collection as the connector.
ConnectionSiteConnectionSite ObrigatórioRequired LongLong Deve ser um inteiro entre 1 e o inteiro retornado pela propriedade ConnectionSiteCount da forma especificada.Must be an integer between 1 and the integer returned by the ConnectionSiteCount property of the specified shape. Se desejar que o conector encontre automaticamente o caminho mais curto entre as duas formas de se conectar, especifique qualquer número inteiro válido para este argumento e, em seguida, use o método RerouteConnections depois que o conector é anexado às formas em ambas as extremidades.If you want the connector to automatically find the shortest path between the two shapes it connects, specify any valid integer for this argument and then use the RerouteConnections method after the connector is attached to shapes at both ends.

ComentáriosRemarks

Quando você anexa um conector a um objeto, o tamanho e posição do conector são ajustados automaticamente, se necessário.When you attach a connector to an object, the size and position of the connector are automatically adjusted, if necessary.

ExemploExample

Este exemplo adiciona dois retângulos a mydocument e os conecta com um conector curvo.This example adds two rectangles to myDocument and connects them with a curved connector. Observe que o método RerouteConnections torna irrelevantes quais valores você fornece para os argumentos ConnectionSite usados com os métodos BeginConnect e EndConnect.Notice that the RerouteConnections method makes it irrelevant what values you supply for the ConnectionSite arguments used with the BeginConnect and EndConnect methods.

Set myDocument = Worksheets(1) 
Set s = myDocument.Shapes 
Set firstRect = s.AddShape(msoShapeRectangle, 100, 50, 200, 100) 
Set secondRect = s.AddShape(msoShapeRectangle, 300, 300, 200, 100) 
Set c = s.AddConnector(msoConnectorCurve, 0, 0, 100, 100) 
With c.ConnectorFormat 
 .BeginConnect ConnectedShape:=firstRect, ConnectionSite:=1 
 .EndConnect ConnectedShape:=secondRect, ConnectionSite:=1 
 c.RerouteConnections 
End With

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.