Método Page.DropConnected (Visio)

Cria um novo objeto Shape na página, coloca a nova forma em relação à forma de destino existente especificada e adiciona um conector da forma existente à nova forma. Retorna a forma recém-criada.

Sintaxe

expression. DropConnected( _ObjectToDrop_ , _TargetShape_ , _PlacementDir_ , _[Connector]_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ObjectToDrop Obrigatório [DESCONHECIDO] A forma a ser adicionada à página. Pode ser um objeto Master, MasterShortcut, Shape ou IDataObject .
TargetShape Obrigatório Formato A forma existente a partir da qual se deve alinhar, espaçar e conectar.
PlacementDir Obrigatório VisAutoConnectDir A direção de TargetShape na qual deve ser colocado ObjectToDrop.
Connector Opcional [DESCONHECIDO] O conector a ser usado. Pode ser um objeto Master, MasterShortcut, Shape ou IDataObject.

Valor de retorno

Formato

Comentários

O parâmetro ObjectToDrop deve ser um objeto que faz referência a uma forma bidimensional (2D). Se você passar uma seleção de formas representadas por um objeto IDataObject, o Visio usará somente a primeira dessas formas. Se ObjectToDrop não for um objeto do Visio válido, o Visio retornará um erro de parâmetro inválido. Se ObjectToDrop não for uma forma que corresponda ao contexto do método, o Visio retornará um erro de fonte inválida.

O parâmetro TargetShape deve ser uma forma de nível superior 2D na página. Se TargetShape for inválido, o Visio retornará um erro de fonte inválida.

O valor de parâmetro PlacementDir deve ser uma das constantes VisAutoConnectDir. Se você passar visAutoConnectDirNone para PlacementDir , o Visio colocará a forma em um local padrão (0,0) e o conectará; a forma não é colocada em relação ao destino.

O parâmetro Conector deve ser um objeto que faz referência a uma forma roteável unidimensional (1D). Se você passar uma seleção de formas representadas por um objeto IDataObject, o Visio usará somente a primeira dessas formas. Se Connector não for um objeto do Visio válido, o Visio retornará um erro de parâmetro inválido. Se Connector não for uma forma que corresponda ao contexto do método, o Visio retornará um erro de origem inválida.

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.