Métodos e eventos do elemento de caixa de seleção

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura
  • O elemento de caixa de seleção em Design studio de RPA para desktop permite capturar entradas verdadeiro ou falso, sim ou não ou ligado ou desligado dos usuários. Ele ajuda na tomada de decisões, habilitando ou desabilitando recursos e controlando a execução do fluxo de trabalho.

    Os métodos e eventos do elemento Caixa de seleção são exibidos no painel Explorador de objetos. Você pode usar este elemento para apresentar seleções sim ou não ou verdadeiro ou falso.

    Casos de uso

    • Seleção de preferências do usuário - Permite que os usuários ativem/desativem opções específicas, como "Executar em segundo plano" ou "Enviar notificação por e-mail".
    • Execução condicional - Com base no fato de a caixa de seleção estar marcada, a automação pode executar ou ignorar determinadas etapas.
    • Opções de seleção múltipla - Você também pode usar o elemento de caixa de seleção em grupos para exibir várias opções em um formulário. Quando várias caixas de seleção estão disponíveis, os usuários podem selecionar várias opções. Por exemplo, selecionar vários formatos de arquivo para exportação.
    • Validação e confirmação - Garanta que um usuário tenha confirmado termos, acordos ou concluído uma etapa necessária antes de prosseguir.

    Métodos

    Verificado
    Define um valor do elemento atual.
    Habilitar
    Obtém ou define um valor que indica se o elemento pode responder à interação do usuário.
    • Se verdadeiro, o elemento será habilitado
    • Se falso, o elemento não está habilitado.
    GetNativeProperty
    Obtém o valor da propriedade interna do elemento atual.
    InvokeNativeMethod
    Invoca o método integrado do elemento atual.
    Está verificado
    Retorna um valor booliano se o elemento atual está selecionado ou limpo.
    SetContextMenu
    Define o menu de contexto do elemento de IU. Ele aceita a entrada em uma matriz de cadeia de caracteres ou em uma cadeia de caracteres separada por vírgulas.
    SetNativeProperty
    Define o valor da propriedade integrada do elemento atual.
    Visibilidade
    Obtém ou define um valor que indica se o elemento atual e todos os seus elementos secundários são exibidos.
    • Se verdadeiro, o elemento atual e todos os seus elementos secundários serão exibidos.
    • Se falso, o elemento atual e todos os seus elementos secundários não serão exibidos.

    Eventos

    OnStateChanged
    Ocorre quando um estado é alterado.
    MenuContextMenuClick
    Ocorre quando uma opção no menu de contexto é clicada.
    Enter
    Ocorre quando o dispositivo do mouse entra nesse campo de elemento.
    MouseLeave
    Ocorre quando o dispositivo do mouse sai desse campo de elemento.
    Clique com o mouse
    Ocorre quando o elemento é clicado.
    Foco
    Ocorre quando o foco está no elemento atual.
    Foco perdido
    Ocorre quando o foco se move para fora do elemento atual.