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

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 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 ativado ou desativado 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, verdadeiro ou falso.

    Casos de uso

    • Seleção de preferências do usuário - Permite que os usuários habilite/desabilite 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 estará habilitado.
    GetNativeProperty
    Obtém o valor da propriedade interna do elemento atual.
    InvokeNativeMethod
    Invoca o método interno 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. 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 interna do elemento atual.
    SetVisibility
    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.
    MenuClick no ContextContextMenuClick
    Ocorre quando uma opção no menu de contexto é clicada.
    MouseEnter
    Ocorre quando o mouse entra nesse campo de elemento.
    MouseLeave
    Ocorre quando o mouse sai desse campo de elemento.
    EmMouseClick
    Ocorre quando o elemento é clicado.
    GotFocus
    Ocorre quando o foco está no elemento atual.
    LostFocus
    Ocorre quando o foco sai do elemento atual.