Método Page.DropIntoList (Visio)
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 retorna um objeto Page .
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 Mestre, Seleção, Forma ou IDataObject . Consulte Comentários para obter mais informações. |
| Targetlist | 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 retornará um erro de destino inválido se ObjectToDrop não corresponder aos requisitos de categoria da lista ou do contêiner. É 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 True, o Visio retornará um erro desabilitado.
Exemplo
O exemplo de Visual Basic for Applications (VBA) a seguir mostra como usar 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.