Controles de Formulários

Utilize controles para exibir campos em um formulário ClearQuest.

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 ALM, o formulário no tipo de registro ALMTask inclui um botão CreateActivity que chama um Script de Registro para criar as Atividades definidas nos registros WorkConfiguration do projeto.

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

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.
Nota: O uso de controles ActiveX aplica-se somente ao cliente Rational ClearQuest para Windows. A partir do ClearQuest 8.0.1, o suporte do ActiveX foi descontinuado.
Attachment
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.
Caixa de Listagem Suspensa
Exibe uma lista de valores possíveis para um campo específico.
Caixa de Combinação Suspensa
Combina um campo de texto editável com uma caixa de listagem suspensa.
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.
History
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 ou a Lista de Campos.

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.

Lista de Anexos
Attachment
Lista de Opções de Lista de Constantes
Caixa de listagem suspensa
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 listagem suspensa
Lista de Constantes de Cadeias Curtas
Caixa de listagem suspensa
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":

[images/move_icon.gif]

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 usam o último controle selecionado como base para modificar os outros controles.

Align left
Alinha a borda esquerda de cada controle com a borda esquerda do controle que foi selecionado anteriormente.
Align right
Alinha a borda direita de cada controle com a borda direita do controle que foi selecionado anteriormente.
Align top
Alinha a borda superior de cada controle com a borda superior do controle que foi selecionado anteriormente.
Align bottom
Alinha a borda inferior de cada controle com a borda inferior do controle que foi selecionado anteriormente.
Align vertical centers
Alinha o centro vertical de cada controle com o centro vertical do controle que foi selecionado anteriormente.
Align horizontal centers
Alinha o centro horizontal de cada controle com o centro horizontal do controle que foi selecionado anteriormente.
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