# Mostrar Janela

O bloco permite criar suas próprias janelas (formulários) e exibi-las em modo modal e não modal, incluindo de forma assíncrona em relação ao fluxo do script. Se um seletor for definido, as coordenadas da janela criada serão vinculadas ao controle em outro aplicativo.

Para criar e editar sua janela, utilize o botão "Editar..." dentro do bloco, e para criar janelas reutilizáveis - o botão "Editor de Janelas" na barra de ferramentas principal.

Cada chamada deste bloco ou mostra ou atualiza os dados da janela (se a janela já estiver na tela). No caso de a janela ser não modal, a chamada repetida do bloco "Mostrar Janela" permite atualizar dinamicamente os controles na janela e as variáveis que estão vinculadas aos elementos da janela.

Os valores de cada um dos controles, assim como as ações dos Usuários na janela, podem ser vinculados à alteração dos valores das variáveis selecionadas, e vice-versa - a alteração dos valores das variáveis leva à alteração dos valores dos respectivos controles. Essa funcionalidade permite desenvolver, no âmbito do script do Robô, sistemas de diálogo e especialistas ramificados, janelas de configurações do Robô, dicas interativas e assistentes, além de aplicativos inteiros com múltiplas janelas.

<table data-header-hidden><thead><tr><th width="181.58331298828125" valign="top"></th><th width="288.00006103515625" valign="top"></th></tr></thead><tbody><tr><td valign="top">Configuração</td><td valign="top">[Texto/Objeto] String de configuração. Para editar o valor, é necessário usar o botão "Editar" dentro do bloco.</td></tr><tr><td valign="top">Objeto da Janela</td><td valign="top">[Objeto] Variável com o objeto da janela. O objeto da janela pode ser obtido do bloco anterior "Mostrar Janela" no script, e isso é relevante para exibir a janela em modo não modal.</td></tr><tr><td valign="top">Modal</td><td valign="top">Quando ativado, a janela será exibida como modal. Caso contrário, após a exibição da janela, o controle será imediatamente transferido para o script.</td></tr><tr><td valign="top">Seletor</td><td valign="top"><p>[Seletor] Identificador do elemento ao qual a janela será vinculada ao ser exibida.</p><p>Se o seletor não for definido, a propriedade é ignorada. Se o elemento for encontrado, a janela será exibida de acordo com as configurações definidas nas propriedades deste bloco. Se o seletor não for encontrado, a janela será exibida no centro da tela.</p></td></tr><tr><td valign="top">ID do Processo</td><td valign="top"><p>[Link] Variável que armazena o identificador do Processo. Indica com qual aplicativo é necessário trabalhar.</p><p>Se o aplicativo especificado estiver minimizado ou sua janela estiver fechada por outras janelas, ele será trazido para o primeiro plano. Ao trabalhar com navegadores, o ID do Processo também indica a guia específica do navegador com a qual o bloco deve trabalhar.</p><p>Se a propriedade for deixada em branco, ou se a variável ID do Processo não tiver sido atribuída anteriormente no momento de iniciar o aplicativo ou abrir o navegador, o aplicativo e a guia do navegador serão definidos a partir do conteúdo da linha correspondente do seletor.</p><p>O ID do Processo pode ser obtido, por exemplo, usando os blocos "Iniciar Aplicativo" ou "Obter Processo".</p></td></tr><tr><td valign="top">Ângulo de Vinculação</td><td valign="top"><p>Seleção do valor do ângulo de vinculação da janela.</p><p>Se o seletor for definido, o valor indica a vinculação do canto superior esquerdo da janela ao canto do elemento encontrado (neste caso, o valor "Default" indicará o centro do elemento).</p><p>Se o seletor for definido, mas não for encontrado, a janela será exibida no centro da janela, independentemente do valor da propriedade.</p><p>Se o seletor não for definido, a propriedade indica a vinculação da janela à área de trabalho da tela principal.</p></td></tr><tr><td valign="top">Deslocamento X</td><td valign="top"><p>[Número] Deslocamento na coordenada X ao exibir a janela.</p><p>Se o seletor não for definido e o ângulo de vinculação for "Default", e esta propriedade tiver um valor, esse valor será considerado como coordenadas absolutas para exibir a janela.</p></td></tr><tr><td valign="top">Deslocamento Y</td><td valign="top"><p>[Número] Deslocamento na coordenada Y ao exibir a janela.</p><p>Se o seletor não for definido e o ângulo de vinculação for "Default", e esta propriedade tiver um valor, esse valor será considerado como coordenadas absolutas para exibir a janela.</p></td></tr><tr><td valign="top">Evento do Elemento</td><td valign="top"><p>[Texto] Evento gerado pelo elemento no formulário.</p><p>Formato do valor: "ControlName.EventName".</p><p>Se o botão no formulário contiver um valor DialogResult, esse valor será indicado nesta propriedade.</p><p>Por exemplo, "OK" ou "Cancelar".</p></td></tr><tr><td valign="top">Objeto da Janela</td><td valign="top">[Objeto] Retorna o objeto da janela criada. Esta propriedade é útil se você deseja mostrar a janela sem usar modalidade. Para isso, no próximo bloco, indique a variável desta propriedade. Nesse caso, os dados na janela serão atualizados sem criar uma nova instância da janela.</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" - por 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 execução. Valores possíveis:</p><ul><li>"Default" - por 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/dialogovye-okna-dialogs/pokazat-okno-invokeshowwindow.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.
