Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Solta o objeto especificado na lista especificada na posição especificada. Retorna a forma recém-solta.
Sintaxe
expression.
DropIntoList( _ObjectToDrop_ , _TargetList_ , _lPosition_ )
expressão Uma expressão que devolve um objeto Página .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| ObjectToDrop | Obrigatório | IUnknown | A fonte da forma a ser solta na lista. Pode ser um objeto Master, Selection, Shape ou IDataObject . Consulte Comentários para obter mais informações. |
| Lista de Destino | Obrigatório | Formato | A lista na qual ObjectToDrop deve ser solta. |
| lPosition | Obrigatório | Long | A posição da lista baseada em 1 para adicionar a forma. |
Valor de retorno
Formato
Comentários
Se ObjectToDrop for um objeto Selection, a seleção poderá conter somente uma única forma.
Se ObjectToDrop for um IDataObject, deve ser associado a um objeto do Microsoft Visio local que está na mesma instância que a página na qual ela está sendo solta.
O Visio devolve um erro de Destino Inválido se ObjectToDrop não corresponder aos requisitos de categoria da lista ou do contentor. É possível atribuir categorias às formas, e os contêineres podem ter categorias obrigatórias e excluídas.
As categorias são cadeias de caracteres definidas pelo usuário que você pode usar para categorizar formas e, assim, restringir a associação em um contêiner. Você pode definir categorias na célula User.msvShapeCategories no ShapeSheet para uma forma. Você pode definir várias categorias para uma forma separando as categorias com ponto-e-vírgulas.
Se ObjectToDrop não for um objeto do Microsoft Visio, ou se ele não contiver formas de nível superior na página, o Microsoft Visio retornará um erro de parâmetro inválido.
Se a propriedade ContainerProperties.LockMembership da lista for Verdadeiro, o Visio devolve um erro Desativado.
Exemplo
O exemplo de Visual Basic for Applications (VBA) seguinte mostra como utilizar o método DropIntoList para adicionar uma nova forma a uma lista existente na página ativa, na primeira posição da lista.
Application.ActivePage.DropIntoList vsoMaster, vsoListShape, 1
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.