Você utiliza 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.
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.
- 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.
- Lista de Opções 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 lista de opções 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.
- A paleta de controle fornece uma dica visual quanto ao tipo de
controle que está sendo incluído.
- Selecionar um campo na Lista de Campos e arrastá-la para o formulário
inclui o controle apropriado no formulário.
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
- Attachment
- Lista de Opções de Lista de Constantes
- Lista de opções 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
- Lista de opções suspensa
- Lista de Constantes de Cadeias Curtas
- Lista de opções 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":
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.