# Busca de Fragmentos

Busca de fragmentos em um documento Word. O bloco funciona apenas quando a propriedade "Usar COM" está ativada nos blocos "Criar documento" ou "Abrir documento".

<table data-header-hidden><thead><tr><th width="233" valign="top"></th><th width="311" valign="top"></th></tr></thead><tbody><tr><td valign="top">Link para o documento</td><td valign="top"><p>[Link] Link para o documento Word aberto, onde a operação está ocorrendo no momento.</p><p>O nome da variável nesta propriedade deve coincidir com o nome da variável na propriedade "Link para o documento", dos blocos "Criar documento" ou "Abrir documento" do grupo Word, que foram usados anteriormente para criar ou abrir este documento.</p></td></tr><tr><td valign="top">Texto</td><td valign="top">[Texto] A string que precisa ser encontrada.</td></tr><tr><td valign="top">Índice inicial da página</td><td valign="top">[Número] Índice inicial da página para busca. A numeração começa em 1.</td></tr><tr><td valign="top">Índice final da página</td><td valign="top">[Número] Índice final da página para busca. A numeração começa em 1.</td></tr><tr><td valign="top">Índice inicial do caractere</td><td valign="top"><p>[Número] Índice inicial do caractere para busca. A numeração começa em 0.</p><p>Se a propriedade "Índice inicial da página" estiver definida e for maior que zero, esta propriedade será ignorada.</p></td></tr><tr><td valign="top">Índice final do caractere</td><td valign="top"><p>[Número] Índice final do caractere para busca. A numeração começa em 0.</p><p>Se a propriedade "Índice final da página" estiver definida e for maior que zero, esta propriedade será ignorada.</p></td></tr><tr><td valign="top">Lista de fragmentos</td><td valign="top"><p>[Lista] Lista de referências ao objeto Range.</p><p>Exemplos de propriedades disponíveis, aplicáveis ao primeiro elemento do array (com índice 0):</p><ul><li>$ListRanges[0].Start - índice inicial do caractere;</li><li>$ListRanges[0].End - índice final do caractere;</li><li>$ListRanges[0].Text - texto do fragmento.</li></ul><p>Para substituir o texto no documento por este fragmento, atribua um novo valor à propriedade Text, por exemplo, $ListRanges[0].Text = "Novo texto".</p></td></tr><tr><td valign="top">Nível de tratamento</td><td valign="top"><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for selecionado, o valor do bloco "Início" deste diagrama será utilizado.</p></td></tr><tr><td valign="top">Nível de mensagens</td><td valign="top"><p>Seleção do nível de mensagens que os blocos exibirão durante a operação. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for selecionado, o valor do bloco "Início" deste diagrama será utilizado.</p></td></tr><tr><td valign="top">Texto do erro</td><td valign="top">[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/word-word-automation/poisk-fragmentov-searchrangesworddocument.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.