Método TextRange.PasteSpecial (PowerPoint)
Substitui o intervalo de texto com o conteúdo da área de transferência no formato especificado.
Sintaxe
expressão. PasteSpecial (DataType, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link)
Expressão Uma variável que representa um objeto TextRange .
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| DataType | Opcional | PpPasteDataType | Um formato para o conteúdo da Área de transferência, quando for inserido no documento. O valor padrão varia, de acordo com esse conteúdo. Ocorrerá um erro se o tipo de dado especificado no argumento DataType não tiver suporte do conteúdo da Área de transferência. |
| DisplayAsIcon | Opcional | MsoTriState | MsoTrue para exibir o objeto incorporado (ou link) como um ícone. |
| IconFileName | Opcional | String | Se DisplayAsIcon for definido como msoTrue, esse argumento será o caminho e o nome do arquivo no qual o ícone a ser exibido está armazenado. Se DisplayAsIcon for definido como msoFalse, este argumento será ignorado. |
| IconIndex | Opcional | Long | Se DisplayAsIcon for definido como msoTrue, esse argumento será um número que corresponde ao ícone que você deseja usar no arquivo de programa especificado por IconFilename. Por exemplo, 0 (zero) corresponde ao primeiro ícone, 1 corresponde ao segundo ícone. Se esse argumento for omitido, o primeiro ícone (padrão) é usado. Se DisplayAsIcon for definido como msoFalse, este argumento é ignorado. Se IconIndex estiver fora do intervalo válido, o ícone padrão (índice 0) é usado. |
| IconLabel | Opcional | String | Se DisplayAsIcon for definido como msoTrue, esse argumento será o texto que aparece abaixo do ícone. Se esse rótulo for omitido, o Microsoft PowerPoint gerará o rótulo de um ícone com base no conteúdo da área de transferência. Se DisplayAsIcon for definido como msoFalse, este argumento é ignorado. |
| Link | Opcional | MsoTriState | Determina se será criado um vínculo para o arquivo de origem do conteúdo da Área de transferência. Ocorrerá um erro se o conteúdo da Área de Transferência não oferecer suporte a um link. |
Valor de retorno
TextRange
Comentários
Tipos de dados válidos para o objeto TextRange são ppPasteText, ppPasteHTML e ppPasteRTF (qualquer outro formato gerará um erro). Se a operação de colagem for bem-sucedida, esse método retorna um objeto TextRange que representa o intervalo de texto que foi colado.
O valor do parâmetro DataType pode ser uma dessas constantes PpPasteDataType .
| ppPasteDefault |
| ppPasteHTML |
| ppPasteRTF |
| ppPasteText |
O valor do parâmetro DisplayAsIcon pode ser uma dessas constantes MsoTriState .
| Constante | Descrição |
|---|---|
| msoFalse | O padrão. Não exibe o objeto incorporado (ou link) como um ícone. |
| msoTrue | Exibe o objeto incorporado (ou link) como um ícone. |
Ocorrerá um erro se houver nenhum dado na área de transferência quando o método PasteSpecial for chamado.
Confira também
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.