Controles de Formulários

Você utiliza controles para exibir campos no formulário. O Designer fornece controles para caixas de texto, lista de opções, caixa de opções, botões de opções, e assim por diante. Por exemplo, você pode associar um campo que contém uma cadeia com um controle de caixa de texto. Alguns controles podem ser utilizados somente com tipos de campos específicos. Por exemplo, o controle de visualização de lista e o controle pai/filho podem ser utilizados somente com um campo de lista de referência.

Você pode utilizar alguns controles para desempenhar tarefas especiais. Botões de comandos e listas de opções podem ser associadas com scripts de registros. Por exemplo, no esquema TestStudio, um botão de comando é associado ao script de registro Build_Properties, que permite que os usuários visualizem as propriedades da construção selecionada.

O Designer também fornece um controle ActiveX que você pode utilizar para incorporar qualquer controle ActiveX registrado em um formulário. Por exemplo, você poderia utilizar um controle ActiveX para interagir com um banco de dados de externo. Antes de utilizar este controle, você deve estar familiarizado com a funcionalidade do ActiveX e como registrar seus controles. Observe que você pode utilizar controles ActiveX somente com o Cliente Rational ClearQuest para Windows.

Os controles de formulário a seguir são suportados:

Controle de Formulário
Descrição
ActiveX
Incorpora qualquer controle ActiveX registrado a um formulário. Você grava o script de registro de inicialização e o script de registro de ação.
Anexo
Exibe uma lista de arquivos anexados e inclui um conjunto de controles que permitem que os usuários incluam, removam ou visualizem arquivos anexados.
Caixa de Opções
Um controle de dois valores que pode ser utilizado para valores Booleanos ou qualquer campo que tenha apenas dois valores. Para especificar os dois valores, clique com o botão direito do mouse no controle no formulário e clique em Propriedades.
Caixa de Combinação
Combina um campo de texto editável com uma caixa de opções.
Lista de Opções Drop-down
Exibe uma lista de valores possíveis para um campo específico.
Caixa de Combinação Drop-down
Combina um campo de texto editável com uma lista de opções drop-down.
Caixa Duplicada
Exibe o ID do registro do qual esse registro é uma duplicata.
Dependente Duplicado
Exibe os IDs de quaisquer registros que sejam duplicatas desse registro.
Caixa de Grupo
Agrupa virtualmente um ou mais controles.
Histórico
Exibe informações sobre as ações aplicadas a um registro.
Lista de Opções
Exibe uma lista de valores possíveis para um campo específico. As listas de opções incluem um controle adicional para selecionar um ou mais itens de uma lista de opções.
Visualização em Lista
Permite exibir os registros associados a um campo do tipo REFERENCE_LIST. Exibe a lista de referências associadas em um formato de coluna múltipla.
Botão de Opção
Os controles de botão de opção são utilizados em grupos para representar um conjunto de opções mutuamente exclusivas Restringe a seleção a uma opção em um grupo.
Pai/filho
Permite configurar um formulário para vincular registros associados. Utilizado com o tipo de campo REFERENCE_LIST. O controle parent/child consiste em um controle de visualização em lista e três botões de comandos. O controle de visualização de lista e os botões de comandos são associados utilizando um ID de visualização de lista exclusivo. Se você alterar o ID da visualização em lista, também deverá atualizar os botões de comandos.
Imagem
Permite incluir uma imagem estática em seu formulário.
Botão de Comando
Inicia tarefas específicas relacionadas ao registro. Você pode associar botões de comandos a ganchos de registros ou a visualizações em lista.
Texto Estático
Exibe uma cadeia de texto editável.
Caixa de Texto
Exibe um valor de campo como uma cadeia de texto editável.

Para obter descrições detalhadas das propriedades de cada tipo de controle, consulte Controles de Formulários.

Incluindo Controles em um Formulário

Antes que você possa incluir um campo em um formulário, deve incluir o campo na grade Campos de Registro. Para obter mais informações, consulte Para Incluir um Novo Campo na Grade Campos de Registro.

Você pode incluir controles em um formulário utilizando a Paleta de controle, a Lista de Campos ou o menu Controles de Formulários.

Você pode incluir um campo em um formulário mais de uma vez, mas todas as instâncias do campo devem ter o mesmo valor.

Incluindo um Controle com a Lista de Campos

A vantagem de utilização da Lista de Campos para inclusão de um controle em um formulário é que ao selecionar um campo na lista e arrastá-lo para o formulário, o controle apropriado para esse tipo de campo é incluído no campo. Não é necessário editar as propriedades do controle para associar o campo ao controle.

A tabela a seguir lista o controle padrão que o Designer cria para cada tipo de campo.

Tipo de Campo
Controle Padrão
Lista de Anexos
Anexo
Lista de Opções de Lista de Constantes
Caixa de opções drop-down
Data-Hora
Caixa de texto
Inteiro
Caixa de texto
Cadeia de Várias Linhas
Caixa de texto
Lista de Referências
Pai/filho
Constante de Lista de Referências
Visualização em lista
Lista de Opções de Referência=Padrão
Caixa de opções drop-down
Lista de Constantes de Cadeias Curtas
Caixa de opções drop-down
Cadeia Curta
Caixa de Texto

Editando Propriedades do Controle

Se você usar a Paleta de controle para incluir um novo controle em um formulário, deve editar as propriedades de controle para associar esse controle a um campo existente.

Depois de incluir um controle em um formulário, você pode editar as propriedades do controle, inclusive selecionar o campo para associar ao controle e especificar atributos de exibição para o controle. Você também pode designar ganchos de registros a alguns controles para permitir que os usuários desempenhem tarefas específicas utilizando esse controle.

Se desejar que os campos dependentes sejam ativados no Rational ClearQuest Web, você deve especificar o campo no qual a dependência é baseada. Para isso, use a seção Campos Dependentes da Web da página de propriedades de controle.

Para obter as descrições das propriedades de cada tipo de controle, consulte Controles de Formulários.

Excluindo um Controle de um Formulário

Se um controle não for mais necessário, ele poderá ser excluído do formulário.

Excluir um controle o remove, juntamente com sua etiqueta no formulário, mas não remove o campo associado a partir do esquema. Para remover o campo do esquema, você deve excluir o campo da grade Campos. Para obter informações adicionais, consulte Excluindo um Campo.

Alterando o Tamanho e o Local de Controles

Para alterar o tamanho e o local de um controle, você pode selecionar o controle e arrastá-lo para um novo local no formulário ou pode especificar as coordenadas exatas do local para um controle na página de propriedades de controle. Para mover um controle usando as teclas de seta no teclado, selecione o controle e pressione a tecla de ponto (.) até ver o ícone de "movimentação":

Agora você pode usar as teclas de seta para posicionar o controle no formulário.

O menu Layout do Formulário fornece as mesmas ferramentas que a barra de ferramentas Formulário, além de algumas ferramentas adicionais. A tabela a seguir lista cada ferramenta e sua função.

As ferramentas de alinhamento e de tamanho idêntico utilizam o primeiro controle selecionado como a base para modificar os outros controles.

Ferramenta de Layout
Descrição
Align left
Alinha a borda esquerda de cada controle com a borda esquerda do controle que foi selecionado primeiramente.
Align right
Alinha a borda direita de cada controle com a borda direita do controle que foi selecionado primeiramente.
Align top
Alinha a borda superior de cada controle com a borda superior do controle que foi selecionado primeiramente.
Align bottom
Alinha a borda inferior de cada controle com a borda inferior do controle que foi selecionado primeiramente.
Align vertical centers
Alinha o centro vertical de cada controle com o centro vertical do controle que foi selecionado primeiramente.
Align horizontal centers
Alinha o centro horizontal de cada controle com o centro horizontal do controle que foi selecionado primeiramente.
Space evenly across
Organiza os controles selecionados horizontalmente para alocar uma quantidade igual de espaço entre todos os controles. Os controles nos extremos esquerdo ou direito não são movidos.
Space evenly down
Organiza os controles selecionados verticalmente para alocar uma quantidade igual de espaço entre todos os controles. Os controles nos extremos superior e inferior não são movidos.
Center vertically in dialog
Alinha o centro vertical de cada controle com o centro vertical da guia.
Center horizontally in dialog
Alinha o centro horizontal de cada controle com o centro horizontal da guia.
Make same width
Torna a largura de cada controle igual à largura do controle selecionado primeiramente.
Make same height
Torna a altura de cada controle igual à altura do controle selecionado primeiramente.
Make same width and height
Torna a largura e a altura de cada controle iguais às do controle selecionado primeiramente.
Size to content
Ajusta o tamanho de cada controle selecionado para que seu conteúdo inteiro possa ser visualizado. Isso é útil para minimizar o tamanho de um controle de Texto Estático ao mesmo tempo que mantém a legibilidade da cadeia.

Alterando a Ordem de Tabulação de Controles

A ordem de tabulação de controles determina qual controle recebe foco quando um usuário pressiona a tecla Tab. Toda vez que o usuário pressiona Tab, o foco muda para o próximo controle na ordem de tabulação.

Por padrão, a ordem de tabulação dos controles é a ordem na qual você incluiu os controles no formulário. Você pode alterar a ordem das guias para que ela reflita a ordem na qual você espera que os usuários utilizem os controles.


Feedback