Método TextRange.PasteSpecial (PowerPoint)

  • Artigo

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

Objeto TextRange

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.