TextRange.PasteSpecial method (PowerPoint) (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. Ocorre um erro se os conteúdos da Área de Transferência não suportarem uma ligação.

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 destas constantes PpPasteDataType .

ppPasteDefault
ppPasteHTML
ppPasteRTF
ppPasteText

O valor do parâmetro DisplayAsIcon pode ser uma destas 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.