ConnectorFormat Interface

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Contém propriedades e métodos que se aplicam a conectores.

public interface class ConnectorFormat

[System.Runtime.InteropServices.Guid("0002443E-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ConnectorFormat

Public Interface ConnectorFormat

Atributos

GuidAttribute InterfaceTypeAttribute

Comentários

Um conector é uma linha que anexa duas outras formas em pontos chamados sites de conexão. Se você reorganizar formas que estão conectadas, a geometria do conector será ajustada automaticamente para que as formas permaneçam conectadas.

Use a ConnectorFormat propriedade para retornar um objeto ConnectorFormat . Use os BeginConnect(Shape, Int32) métodos e EndConnect(Shape, Int32) para anexar as extremidades do conector a outras formas no documento. Use o RerouteConnections() método para localizar automaticamente o caminho mais curto entre as duas formas conectadas pelo conector. Use a Connector propriedade para ver se uma forma é um conector.

Observe que você atribui um tamanho e uma posição ao adicionar um conector à Shapes coleção, mas o tamanho e a posição são ajustados automaticamente quando você anexa o início e o fim do conector a outras formas na coleção. Portanto, se você pretende anexa um conector a outras formas, o tamanho inicial e a posição que você especificar serão irrelevantes. Da mesma forma, você especifica quais sites de conexão de uma forma para anexar o conector a quando você anexa o conector, mas o uso do método RerouteConnections depois que o conector é anexado pode alterar a quais sites de conexão o conector anexado, tornando sua escolha original de sites de conexão irrelevante.

Os sites de conexão são geralmente numerados conforme as regras apresentadas na tabela a seguir.

AutoFormas, WordArt, figuras e objetos OLE	Os sites de conexão são numerados começando pela parte superior e seguindo o sentido anti-horário.
Formas livres	Os sites de conexão são os vértices e correspondem aos números de vértice.

Propriedades

Application	Retorna um Application objeto que representa o aplicativo Microsoft Excel.
BeginConnected	True se o início do conector especificado estiver conectado a uma forma.
BeginConnectedShape	Retorna um Shape objeto que representa a forma à qual o início do conector especificado está anexado.
BeginConnectionSite	Retorna um número inteiro especificando o site de conexão ao qual o final de um conector está conectado.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual esse objeto foi criado.
EndConnected	msoTrue se o final do conector especificado estiver conectado a uma forma.
EndConnectedShape	Retorna um Shape objeto que representa a forma à qual o final do conector especificado está anexado.
EndConnectionSite	Retorna um número inteiro especificando o site de conexão ao qual o final de um conector está conectado.
Parent	Retorna o objeto pai do objeto especificado.
Type	Retorna ou define o tipo de formato do conector.

Métodos

BeginConnect(Shape, Int32)	Conecta o início do conector especificado a uma forma específica.
BeginDisconnect()	Desconecta o início do conector especificado da forma a qual ele está anexado.
EndConnect(Shape, Int32)	Anexa o final do conector especificado a uma forma específica.
EndDisconnect()	Desconecta o fim do conector especificado da forma à qual está anexado.