4D Doc Center : Botões de opção e botões imagem de opção

4D v14.3

Botões de opção e botões imagem de opção

Os botões de opção e os botões de opção de imagem são objetos que permitem ao usuário selecionar um valor ou imagem entre um grupo de valores ou de imagens. Um botão de opção aparece como um círculo seguido por um texto. Os botões de opção de imagem mostram um ícone ou uma imagem e estão sobre uma imagem.

Nota: Os botões de opção 3D funcionam igual, porém sua aparência é definida pelas propriedades da família de botões 3D. Para maiores informações, consulte o parágrafo Botões 3D, caixa de seleção 3D e botões de opção 3D.

Cada tipo de botão de opção é selecionado da mesma maneira: você clica no objeto para selecioná-lo. Também é possível clicar em um botão de opção de imagem marcado para desmarcá-lo, porém não se pode fazer isso com um botão de opção.

Os botões de opção de imagem são similares aos botões inversos em que são transparentes até que sejam selecionados. Quando são selecionados, invertem a imagem atrás deles até que outro botão de opção seja selecionado.

A parte restante desta seção utiliza o termo “botão de opção” para todos os tipos de botões de opção.

Os botões de opção são utilizados em forma de conjuntos coordenados: somente um botão por vez pode ser selecionado no conjunto. Para funcionar de maneira coordenada, um conjunto de botões de opção deve estar agrupado no editor de formulários. Para fazer isso, é possível utilizar o comando Grupo no menu Objeto ou o botão correspondente da barra de ferramentas do formulário.

Em versões anteriores de 4D, o funcionamento coordenado de um conjunto de botões de opção era obtido ao dar a mesma letra inicial a suas variáveis associadas (por exemplo, m_botao1, m_botao2, m_botao3, etc.). Por razões de compatibilidade, este principio é mantido por padrão em bancos de dados convertidos. No entanto, é possível forçar o uso deste novo modo de utilização nas Preferências (consulte o parágrafo Página Compatibilidade).

Os efeitos dos botões de opção são controlados com métodos. Como todos os botões, um botão de opção é inicializado em 0 quando o formulário é aberto pela primeira vez. Um método associado a um botão de opção é executado quando se seleciona o botão.

O exemplo a seguir representa um grupo de botões de opção 3D utilizado em uma base de dados de uma coleção de videos para introduzir a velocidade de gravação. (SP, LP, ou EP).

Ao selecionar um botão de opção de um grupo o botão se põe em 1 e os outros botões do grupo em 0. Só é possível selecionar um botão de opção ao mesmo tempo.

Nota: também pode associar as variáveis de tipo booleano aos botões de opção. Nesse caso, quando um botão de um grupo for selecionado, sua variável é verdadeira e as variáveis para os outros botões de opção são falsas.

O exemplo a seguir é de um botão de opção imagem. O botão de opção imagem selecionado aparece com fundo preto:

O valor contido em um objeto de botão de opção não é salvo automaticamente; os valores de botões de opção devem ser armazenados em suas variáveis e manejados com a ajuda de métodos.