Compartilhar via


Método Shape.Paste (Visio)

Cola o conteúdo da Área de Transferência em um objeto.

Sintaxe

expressão. Colar (Sinalizadores)

expressão Uma variável que representa um objeto Shape.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Flags Opcional Variant Determina como as formas são traduzidas durante a operação de colar.

Valor de retorno

Nada

Comentários

O método Paste funciona apenas com objetos Shape que sejam formas de grupo. Use a propriedade Type de uma forma para determinar se trata-se de um grupo.

Os possíveis valores de Flags são declarados pela biblioteca de tipos do Visio em VisCutCopyPasteCodes e são descritos na tabela a seguir.

Flag Valor Descrição
visCopyPasteNormal &H0 Segue o comportamento padrão de cópia.
visCopyPasteNoTranslate &H1 Copia formas para as localizações de coordenadas originais.
visCopyPasteCenter &H2 Copia formas para o centro da página.
visCopyPasteNoHealConnectors &H4 Não limpa conectores anexados a formas cortadas.
visCopyPasteNoContainerMembers &H8 Não corta e cola membros não selecionados de contêineres ou listas.
visCopyPasteNoAssociatedCallouts &H16 Não corta e cola textos explicativos não selecionados associados a formas.
visCopyPasteDontAddToContainers &H32 Não adiciona formas coladas a contêineres subjacentes.
visCopyPasteNoCascade &H64 Não desloca formas na cópia.

A definição de Flags como visCopyPasteNormal equivale ao comportamento na interface do usuário. Você deve usar visCopyPasteNormal e os outros sinalizadores de forma consistente. Por exemplo, se você utilizar o valor visCopyPasteNoTranslate para copiar, deve usá-lo também para colar, pois essa é a única maneira de garantir que as formas sejam coladas nas suas localizações de coordenadas originais.

Se precisar controlar o formato das informações coladas e (opcionalmente) estabelecer um vínculo com um arquivo de origem (por exemplo, um documento do Microsoft Word), use o método PasteSpecial.

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.