Método Shape.PasteSpecial (Visio)
Insere o conteúdo da Área de Transferência, permitindo que você controle o formato das informações coladas e (opcionalmente) estabeleça um vínculo com o arquivo de origem (por exemplo, um documento do Microsoft Word).
Sintaxe
expressão. PasteSpecial (Format, Link, DisplayAsIcon)
Expressão Uma variável que representa um objeto Shape .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| Format | Obrigatório | Long | O formato interno da Área de Transferência. |
| Link | Opcional | Variantes | True para estabelecer um vínculo com a origem dos dados colados; caso contrário, False (o padrão). Ignorado se os dados de origem não forem adequados ou não derem suporte para a vinculação. |
| DisplayAsIcon | Opcional | Variantes | True para exibir os dados colados como um ícone; caso contrário, False (o padrão). |
Valor de retorno
Nada
Comentários
Para simplesmente colar o conteúdo da Área de Transferência em um objeto, use o método Paste.
O método PasteSpecial de um objeto Shape 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.
O valor do argumento Format pode ser qualquer dos seguintes:
Um valor de VisPasteSpecialCodes (consulte a tabela a seguir).
Qualquer dos formatos padrão da Área de Transferência, por exemplo, CF_TEXT. Para obter mais informações, consulte o SDK da plataforma Microsoft no MSDN, o site Microsoft Developer Network.
Qualquer valor retornado de uma chamada para a função RegisterClipboardFormat. Para obter detalhes, consulte o SDK da plataforma Microsoft no MSDN.
Observação
Antes de chamar funções do Microsoft Windows, você deve entender como os tipos de dados e argumentos são manipulados pelas DLLs do Windows. A chamada incorreta de funções do Windows pode causar falhas de página inválida ou outros comportamentos inesperados. Para obter mais informações sobre como chamar funções do Windows, pesquise "Windows API" no MSDN.
Os possíveis valores de Format declarados pela biblioteca de tipos do Visio em VisPasteSpecialCodes são descritos na tabela a seguir.
| Constant | Valor | Descrição |
|---|---|---|
| visPasteBitmap | 2 | Colar bitmap. |
| visPasteDIB | 8 | Colar bitmap independente de dispositivo. |
| visPasteEMF | 14 | Colar metarquivo aperfeiçoado. |
| visPasteHyperlink | 65538 | Colar hiperlink. |
| visPasteInk | 65544 | Colar dados de Tinta. |
| visPasteMetafile | 3 | Colar metarquivo. |
| visPasteOEMText | 7 | Colar texto OEM. |
| visPasteOLEObject | 65536 | Colar objeto OLE. |
| visPasteRichText | 65537 | Colar rich text. |
| visPasteText | 1 | Colar texto ANSI. |
| visPasteURL | 65539 | Colar URL (Uniform Resource Locator). |
| visPasteVisioIcon | 65543 | Colar ícone do Visio. |
| visPasteVisioMastersXML | 65546 | Colar XML de mestres do Visio. |
| visPasteVisioMasters | 65541 | Colar mestres do Visio. |
| visPasteVisioShapesXML | 65545 | Colar XML de formas do Visio. |
| visPasteVisioShapesWithoutDataLinks | 65548 | Colar dados de desenho do Visio sem links de dados internos. |
| visPasteVisioShapes | 65540 | Colar formas do Visio. |
| visPasteVisioText | 65542 | Colar texto do Visio. |
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.