Compartilhar via

Método Document.Drop (Visio)

  • Artigo

Cria um novo objeto Master soltando um objeto em um objeto receptor, como um estêncil ou documento, ou a coleção Masters ou MasterShortcuts .

Sintaxe

expressão. Drop (ObjectToDrop, xPos, yPos)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ObjectToDrop Obrigatório [DESCONHECIDO] O objeto a ser solto. Normalmente, esse é um objeto do Visio, como um objeto Master, Shape ou Selection, mas pode ser qualquer objeto OLE que forneça uma interface IDataObject.
Xpos Obrigatório Integer A coordenada x na qual deve ser colocado o centro da largura da forma ou PinX.
Ypos Obrigatório Integer A coordenada y na qual deve ser colocado o centro da altura da forma ou PinY.

Valor de retorno

Master

Comentários

A utilização do método Drop é semelhante a mover uma forma com o mouse. O objeto descartado ( ObjectToDrop) pode ser um mestre ou uma forma na página de desenho.

Se ObjectToDrop for um Master, o marco do mestre será solto nas coordenadas especificadas. Frequentemente, mas não necessariamente, o marco de um mestre está no seu centro de rotação.

Para criar um novo mestre em um estêncil, aplique o método Drop para um objeto Document que representa um estêncil (o estêncil deve estar aberto como um original ou uma cópia em vez de somente leitura). Nesse caso, os argumentos xPos e yPos são ignorados e o novo mestre criado é retornado.

Exemplo

O exemplo a seguir mostra como usar o método Drop para criar um mestre soltando uma forma sobre um objeto Document.

 
Public Sub Drop_Example() 
 
    Dim vsoShape As Visio.Shape  
    Dim vsoMaster As Visio.Master  
 
    Set vsoShape = ActivePage.DrawRectangle(1, 2, 2, 1)  
 
    'Create a master in the document.  
    'The master appears on the document stencil.  
    Set vsoMaster = ActiveDocument.Drop(vsoShape, 0, 0)  
 
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.