Ler em inglês

Compartilhar via


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.