Compartilhar via


Coleção Controls (referência da API do cliente)

Use a coleção Controls para acessar controles associados a colunas.

Como cada coluna pode ser representada mais de uma vez na página, a coleção de controles fornece acesso a todos os controles que representam essa coluna. Se a coluna for representada por apenas um controle na página, o comprimento dessa coleção será 1. Quando você usa o método getName de controle, o nome do primeiro controle será o mesmo que o nome da coluna. A segunda instância de um controle para essa coluna será <columnName>1. O padrão <columnName>+N continuará para cada controle adicional adicionado ao formulário para uma coluna específica.

Quando um formulário exibe um controle de fluxo de processo empresarial no cabeçalho, controles adicionais serão adicionados para cada coluna exibida no fluxo do processo empresarial. Esses controles têm um nome exclusivo como o seguinte: nome header_process_<column>.

Ao executar ações em controles vinculados a uma coluna, você sempre deve considerar que o controle pode ser incluído na página mais de uma vez e você geralmente deve executar as mesmas ações para cada controle da coluna. Você pode fazer isso fazendo um loop pela coleção de controles de coluna e executar as ações em cada controle.

Colunas (referência à API do Cliente)