Tivoli Service Desk 6.0 Developer's Tookit - Guia do Criador de Interface

Capítulo 3: Como Criar Controles

Retornar ao Índice


Introdução

Visão Geral

O número de controles que você adiciona a um formulário é limitado somente pelo tamanho do formulário. Você pode redimensionar um formulário para criar espaço adicional para os controles.

Atenção: Se você redimensionar um formulário durante o desenvolvimento, será necessário salvá-lo com esse mesmo tamanho. Caso contrário, o formulário não aparecerá corretamente para os usuários finais.

O processo de adicionar controles a um formulário é o mesmo para qualquer controle adicionado ao formulário.

Visão Geral de Propriedades de Controles

Visão Geral

Cada controle possui uma folha de propriedades com os seguintes separadores:

As propriedades dos separadores Base e Auxílio são discutidas nas seções a seguir.

Propriedades de Controles Comuns

Propriedades do separador Base

A tabela a seguir descreve as propriedades do separador Base que são comuns a todos os controles.

Propriedade Descrição
ID do Controle Um ID que facilita a definição da ordem dos separadores. É assim também que o controle é referido em um programa TSD Script.
Anexos Os anexos mantêm a posição dos controles em um formulário quando ele é redimensionado. Os anexos podem ser fixos, onde um controle permanece em um local específico em um formulário, independentemente do tamanho desse formulário, ou de porcentagem, onde o local de um controle se move na proporção do tamanho do formulário. Para obter mais informações sobre como definir anexos de controles, consulte "Gerenciamento de Geometria."
Tamanho Coordenadas utilizadas para ajustar a altura e largura do controle
Deslocamentos Coordenadas utilizadas com anexos de porcentagem que definem a quantidade de "espaço em buffer" entre o controle e as bordas do formulário. Para obter informações sobre como definir deslocamentos, consulte "Gerenciamento de Geometria."
Oculto Define o controle como oculto ou visível. Selecione esta caixa de opções se desejar definir determinados controles com permissões. Por exemplo, você pode selecionar esta opção se desejar que determinados controles fiquem visíveis somente para os gerenciadores ou supervisores.
Desativado Define o controle como ativo ou inativo
Sincronizar Coordenadas Define um local fixo para o controle em várias plataformas
Descrição Uma definição da função do controle

Propriedades do separador Auxílio

A partir do separador Auxílio, você pode definir propriedades para:

Para obter mais informações sobre como adicionar o auxílio ao seu aplicativo, consulte "Como Criar Recursos Adicionais."

Propriedades de Controles Específicas

Visão Geral

Cada controle possui propriedades específicas, em contraste com as propriedades comuns a todos os controles. Esta seção descreve as propriedades específicas de cada controle.

Propriedades do botão

A tabela a seguir descreve as propriedades específicas de um controle do botão.

Propriedade Descrição
Botão Rótulo Um texto que aparece no botão.
Arquivo de Imagem O caminho e o nome do arquivo que contém a imagem que aparece no botão.

Nota: Se você especificar que apareça uma imagem no botão, o texto do botão que for especificado se transformará em uma descrição da ferramenta.

Ação A ação que o botão deve executar. A seguir são apresentadas as ações válidas:
  • Aceitar aceita todos os valores digitados no formulário.
  • Cancelar fecha a caixa de diálogo sem alterações implementadas.
  • Auxílio exibe o tópico do auxílio para o formulário.
  • Nenhum é um botão cuja função é determinada por você. Por exemplo, você pode associar qualquer tipo de função a este botão porque sua finalidade está aberta para você.
Seleção de Imagem na Tela Selecione esta caixa para especificar um arquivo de imagem.
Botão Padrão Determina se o botão já está selecionado quando o formulário é aberto.

Propriedades da caixa de opções

A tabela a seguir descreve as propriedades específicas de cada controle da caixa de opções.

Propriedade Descrição
Rótulo da Caixa de Opções O texto que aparece junto à caixa de opções.
Valor Inicial Determina se a caixa de opções está selecionada inicialmente ou não. Escolher verdadeiro seleciona a caixa de opções.
Estilo Determina se a caixa de opções selecionada é circular ou quadrada. Quadrada é o padrão se a caixa estiver desmarcada.

Propriedades do relógio

A tabela a seguir descreve as propriedades específicas de um controle do relógio.

Propriedade Descrição
Tipo de Relógio Determina se o relógio possui um visor convencional de doze horas ou um de vinte e quatro horas.
Moldura Determina a aparência da moldura em torno do relógio. A seguir são apresentadas as molduras válidas:
  • Elevada determina se as linhas aparecem elevadas acima do relógio.
  • Abaixadas determina se as linhas aparecem abaixadas acima do relógio.
  • Moldura do Campo determina se as linhas aparecem estáticas, não elevadas ou abaixadas, contornando o relógio.
  • Nenhum é onde nenhuma linha contorna o relógio.

Propriedades da caixa de combinação

A tabela a seguir descreve as propriedades específicas de um controle da caixa de combinação.

Propriedade Descrição
Classificação Determina a ordem de classificação dos itens da lista. A seguir são apresentados os métodos de classificação válidos:
  • Crescente lista itens na ordem crescente no início.
  • Nenhum é onde não se aplica a classificação aos itens.
Tipo Determina o tipo de seleção que pode ser feita por um usuário. A seguir são apresentados os tipos válidos:
  • Padrão significa que um usuário pode selecionar um item no quadro de listagem.
  • Somente Leitura significa que um usuário pode exibir itens no quadro de listagem, mas não pode selecionar.
IME Determina se o Input Method Editor (IME) é utilizado para refletir caracteres do idioma local em vez do inglês.
Conteúdo Inicial Determina se é exibido um valor inicial na caixa de combinação.
ID de Início Se você selecionou um item padrão para aparecer na caixa de combinação, deverá digitar o ID neste campo.
Comprimento Máximo O número máximo de caracteres que podem ser digitados pelos usuários na caixa de combinação.

Propriedades da caixa de texto

A tabela a seguir descreve as propriedades específicas de um controle da caixa de texto.

Nota: Os usuários podem digitar somente uma linha de texto em uma caixa de combinação. Utilize o controle Edição Multilinha para obter mais linhas.

Propriedade Descrição
Valor Inicial O valor padrão. Se você não digitar um valor, a caixa de texto aparecerá vazia quando a caixa de diálogo for exibida.
Tipo de Padrão A seguir são apresentados os tipos de padrões válidos, predefinidos, exceto para a opção Personalizar, em que você projeta a sua própria opção (para obter mais informações sobre padrões, consulte "Como Criar Recursos Adicionais"):
  • Nenhum indica nenhum tipo de padrão.
  • Inteiro indica números inteiros apenas.
  • Real representa somente números reais.
  • Hora representa o formato de hora, como por exemplo hh:mm:ss.
  • Data representa o formato de data, como por exemplo dd/mm/aaaa.
  • Senha representa um padrão de formato de senha.
  • Personalizar representa um padrão que você projeta. (Os campos Padrão e Comprimento Máximo ficam ativos dependendo do Tipo de Padrão selecionado.)
ID do Padrão O nome do padrão. (Disponível apenas para padrões personalizados.)
Comprimento Máximo A quantidade máxima de caracteres que os usuários podem digitar
Somente Leitura Determina se o campo de entrada é somente leitura
Somente Maiúsculas Determina se as entradas aparecem com todas as letras maiúsculas, independentemente do tipo de letra utilizado pelo usuário
IME Local Determina se o Input Method Editor (IME) é utilizado para refletir os caracteres do idioma local em vez do inglês.
GMT Hora Média de Greenwich. A seleção desta caixa de opções converterá automaticamente uma data ou hora em GMT.

Você deve proceder da seguinte forma para utilizar este recurso.

  1. Crie dois campos de entrada, um com um padrão de hora e outro com um padrão de data, no mesmo formato.
  2. Nomeie os campos de entrada da seguinte forma: NAME_TIME para o campo de hora e NAME_DATE para o campo de data.
    Nota: O "NOME" deve ser igual para os dois.
  3. Selecione a caixa de opções "Conversão em GMT" na folha de propriedades dos dois campos.

Propriedades da caixa do grupo

A tabela a seguir descreve as propriedades específicas de um controle da caixa do grupo.

Propriedade Descrição
Título da Caixa de Grupo O nome da caixa do grupo
Estilo Determina como o título deve ser alinhado

Propriedades de hipertexto

A tabela a seguir descreve as propriedades específicas de um controle de hipertexto.

Propriedade Descrição
Estilo O estilo do formato na caixa de hipertexto. A seguir são apresentados os estilos válidos:
  • Sem quebra de linha significa que o usuário deve utilizar os retornos de carro fixos para quebrar texto manualmente para a próxima linha.
  • Sem Formatação significa quebra de linha automática.
  • Nenhum significa que não há formatação da linha.
Texto Inicial Determina se deve aparecer um texto inicial no controle de hipertexto.

Propriedades da imagem

A tabela a seguir descreve as propriedades específicas de um controle de imagem.

Propriedade Descrição
Arquivo de Imagem O caminho do arquivo que contém a imagem
Estilo da Moldura Determina a aparência da moldura em torno da imagem. A seguir são apresentadas as molduras válidas:
  • Elevada determina se as linhas aparecem elevadas acima da imagem.
  • Abaixada determina se as linhas aparecem abaixadas sob a imagem.
  • Moldura do Campo determina se as linhas aparecem estáticas, não elevadas ou abaixadas, contornando a imagem.
  • Nenhum indica que não existem linha contornando a imagem.
Estilo Determina a aparência da imagem no formulário. A seguir são apresentados os estilos válidos:
  • Barras de Rolagem serve para o usuário rolar pelo tamanho da imagem.
  • Limite corta a imagem para que caiba na moldura.
  • Escala dimensiona a imagem para que caiba na moldura.

Propriedades do quadro de listagem

A tabela a seguir descreve as propriedades específicas de um controle do quadro de listagem.

Propriedade Descrição
Classificação Determina a ordem de classificação dos itens da lista. A seguir são apresentados os métodos de classificação válidos:
  • Crescente lista itens na ordem crescente no início.
  • Nenhum não aplica classificação aos itens.
Rolagem Horizontal Determina se deve aparecer uma barra de rolagem horizontal.
Conteúdo Inicial Os itens da lista padrão. Você deve renomeá-los; caso contrário, os nomes padrão aparecerão no quadro de listagem.
ID de Início Esta caixa é somente leitura e reflete o conteúdo da caixa Conteúdo Inicial.
Multiseleção Permite ao usuário selecionar qualquer número de múltiplos itens no quadro de listagem e em qualquer ordem.

Propriedades da caixa edição multilinha

A tabela a seguir descreve as propriedades específicas de um controle MLE.

Propriedade Descrição
Rolagem Horizontal Determina se deve aparecer uma barra de rolagem horizontal no MLE.
Rolagem Vertical Determina se deve aparecer uma barra de rolagem vertical no MLE.
Somente Maiúsculas Determina se as entradas aparecem com todas as letras maiúsculas, independentemente do tipo de letra utilizado pelo usuário.
IME Local Determina se o Input Method Editor (IME) é utilizado para refletir caracteres do idioma local em vez do inglês.
Sem Quebra de Linha Determina se o usuário deve utilizar retornos de carro fixos para quebrar o texto manualmente para a próxima linha.
Somente Leitura Determina se o MLE deve ser somente leitura.
Obrigatória Determina se os usuários devem executar digitação no MLE.
Comprimento Máximo Determina quantos caracteres os usuários podem digitar no MLE.

Propriedades do quadro de listagem de multiseleção

A tabela a seguir descreve as propriedades específicas de um controle MSLB.

Propriedade Descrição
Ordem Crescente Classifica automaticamente novos dados digitados em uma tabela na ordem crescente.
Nenhum Permite a utilização do controle MSLB sem nenhuma definição de propriedade. A definição de propriedade padrão.
Rolagem Horizontal Permite o deslocamento horizontal para exibir dados fora da área visível da tela.
Multiseleção Permite a seleção aleatória de várias entradas.
Conteúdo Inicial Permite a seleção de valores exibidos na primeira vez em que o quadro de listagem é aberto.
ID de Início Uma variável que serve como o identificador de um item. Esta variável é usada para identificar valores do conteúdo inicial.

Propriedades do Conjunto de botões de rádio

A tabela a seguir descreve as propriedades específicas de um controle de conjunto de botões de rádio.

Propriedade Descrição
Título do Conjunto de Botões de Rádio O título da caixa do grupo que fica ao redor dos botões de rádio.
Seleção Inicial Determina (por número) se um botão deve ser selecionado inicialmente. Você deve digitar um valor para indicar qual botão de rádio será selecionado (por exemplo, 1 para o primeiro botão, 2 para o segundo, etc.).
Rótulos do Botão Os rótulos dos botões de rádio padrão. Você deve renomeá-los, caso contrário, os nomes padrão aparecerão no conjunto de botões de opção.
Posição do Título O alinhamento do título da caixa do grupo.
Estilo Determina se os botões de rádio possuem uma orientação vertical ou horizontal.

Propriedades da régua de controle

A tabela a seguir descreve as propriedades específicas de um controle da régua de controle.

Propriedade Descrição
Escala A seguir são apresentadas opções de escala válidas:
  • Número de Marcas representa o número de marcas ou rótulos da escala. No Windows, aparecem somente as marcas. No UNIX, somente os rótulos aparecem. Nota: No OS/2, aparecem marcas e rótulos.
  • Distância indica o número de unidades que cada marca representa. Se o número de marcas for 10, a distância for 1, a escala aparecerá como 0, 1, 2... até 10. No entanto, se o número de marcas for 10, a distância for 2, a escala aparecerá como 0, 2, 4... até 20.
Orientação Determina se a régua de controle possui uma orientação vertical ou horizontal. Horizontal possui valores que aparecem da esquerda para a direita, enquanto o vertical possui valores que aparecem de baixo para cima.
Encaixe Determina se o controle deslizante se move para a marca de escala mais próxima.
Rótulos Títulos de marcas de escala somente para UNIX. O número de rótulos deve ser idêntico ao número de marcas.

Propriedades do subformulário

Esta seção descreve as propriedades específicas de um controle do subformulário. Você pode utilizar subformulários em vez dos controles freqüentemente utilizados nos formulários. Por exemplo, se tiver três botões que aparecem como um grupo em vários formulários, em vez de adicionar os três botões a cada formulário onde eles devem aparecer, você pode criar um controle de subformulário que contém os três botões e consultar o controle do subformulário em cada formulário. Em outras palavras, você pode criar os botões uma vez para utilizar em vários formulários.

Os subformulários também podem ser utilizados para agrupar seções de um formulário para ajudar no gerenciamento de geometria. Para obter mais informações, consulte "Gerenciamento de Geometria."

A tabela a seguir descreve as propriedades específicas do separador Subformulário.

Propriedade Descrição
Título do Subformulário O título do subformulário que aparece na moldura.
ID do Formulário A localização do arquivo que contém o subformulário.
Estilo da Moldura Determina a aparência da moldura em torno do subformulário. A seguir são apresentadas as molduras válidas:
  • Elevada determina se as linhas aparecem elevadas acima do formulário.
  • Abaixada determina se as linhas aparecem abaixadas sob o subformulário.
  • Moldura do Campo determina se as linhas aparecem estáticas, não elevadas ou abaixadas, contornando o subformulário.
  • Nenhum significa que não existem linhas contornando o subformulário.

Propriedades da tabela

Esta seção descreve os três separadores específicos de um controle da tabela: Tabela, Colunas e SQL.

A tabela a seguir descreve as propriedades específicas do separador Tabela.

Propriedade Descrição
Classificação Determina a ordem de classificação dos itens da tabela. A seguir são apresentados os métodos de classificação válidos:
  • Classificar em Ordem Crescente lista itens na ordem crescente, do início.
  • Classificar em Ordem Decrescente lista itens começando pela ordem decrescente.
  • Nenhum não aplica classificação aos itens.
Barras de Rolagem Horizontal Determina se deve aparecer uma barra de rolagem horizontal na tabela
Seleção Múltipla Determina se os usuários podem selecionar mais de um item de cada vez na tabela

A partir do separador Colunas, você pode definir as seguintes propriedades de título e tamanho da coluna para a sua tabela.

A tabela a seguir descreve as propriedades específicas do separador Colunas.

Propriedade Descrição
Nome Nome da coluna no banco de dados
Título Nome da coluna exibida pelo usuário na tela
Largura Quantas unidades de diálogos, a coluna deve ter horizontalmente.
Nota: Até 32 unidades de diálogos (4 horizontalmente e 8 verticalmente) podem compor uma célula do caractere. Uma célula de caractere é composta de um único caractere, alfanumérico ou símbolo.
GMT Hora Média de Greenwich. A seleção desta caixa de opções converterá automaticamente uma data ou hora em GMT.

Você deve proceder da seguinte forma para utilizar este recurso.

  1. Crie dois campos de entrada, um com um padrão de hora e outro com um padrão de data, no mesmo formato.
  2. Nomeie os campos de entrada da seguinte forma: NAME_TIME para o campo de hora e NAME_DATE para o campo de data.
    Nota: O "NOME" deve ser igual para os dois.
  3. Selecione a caixa de opções "Converter em/de GMT " na folha de propriedades de ambos os campos.

A partir do separador SQL, você pode definir as seguintes propriedades do limite do registro e da instrução SQL para a sua tabela.

A tabela a seguir descreve as propriedades específicas do separador SQL.

Propriedade Descrição
Limite do Registro A quantidade máxima de registros que sua tabela deve conter.
Instrução SQL Qualquer instrução SQL pode ser digitada nesta caixa.

Propriedades do texto

A tabela a seguir descreve as propriedades específicas de um controle de texto.

Propriedade Descrição
Texto do Rótulo O título da caixa de texto.
Posição Horizontal O alinhamento horizontal do texto dentro da caixa de texto.

Controles de árvore

Os controles de árvore permitem a criação de uma estrutura hierárquica que pode ser expandida ou reduzida. Para obter mais informações sobre os vários controles de árvores disponíveis no Tivoli Service Dest 6.0 Developer's Toolkit, consulte o arquivo lrtree.htm.

Como definir propriedades de controles

Para definir propriedades de controles:

  1. Dê um clique com o botão direito do mouse no controle para o qual deseja definir propriedades.
  2. Escolha Propriedades.
    Nota: Se você selecionou as Folhas de Propriedades Automáticas em Preferências, a folha de propriedades Controle aparecerá automaticamente quando você criar um novo formulário ou controle.
  3. Defina as propriedades.
  4. Escolha Aplicar ou OK.

Propriedades do Controle de Árvores

Como Trabalhar com Controles

Como adicionar controles

Para adicionar um controle:

  1. Abra um arquivo de recurso.
  2. Dê um clique duplo no formulário ao qual deseja adicionar um controle.
  3. Dê um clique em um botão do controle na paleta de controles.
  4. Dê um clique no formulário onde deseja que o controle apareça e dimensione o controle com o indicador do mouse.
    Resultado: O controle aparece no formulário com anexos. Depois de adicionar todos os controles, é necessário configurar os anexos.

Nota: Você pode aplicar o dimensionamento exato aos controles utilizando o separador da propriedade Base.

Como definir anexos

Quando você adiciona um controle, ele possui dois anexos padrão. Os dois anexos são fixados como o padrão, significando que o controle está em uma posição definida no formulário e não se moverá, independentemente de como o formulário foi redimensionado. Você pode alterar os anexos para que um controle se mova proporcionalmente quando o formulário for redimensionado, definindo-os como anexos de porcentagem.

Os anexos são definidos no editor de anexos, mostrado abaixo da paleta de controles. Os anexos fixos são representados por linhas sólidas, enquanto os anexos de porcentagem são representados por linhas tracejadas. Para obter mais informações sobre anexos, consulte "Gerenciamento de Geometria."

Para definir anexos:

  1. Adicione um controle a um formulário.
    Resultado: O controle aparece no formulário com dois anexos fixos. Um aspecto do controle também aparece no editor de anexos.
  2. Para adicionar um terceiro anexo, dê um clique na lateral do controle sem anexos.
  3. Para definir um anexo fixo como um anexo de porcentagem, dê um clique em um anexo fixo.
    Resultado: A linha do anexo sólida e fixa muda para uma linha de anexo tracejada e de porcentagem.

Nota: Você pode adicionar linhas de anexos a todos os quatro lados do controle pressionando shift conforme adiciona o controle ao formulário.

Como mover controles

Nota: Antes de mover um controle, certifique-se de que nenhum controle esteja selecionado na paleta de controles.

Para mover um controle:

  1. Dê um clique sobre o controle a ser movido.
  2. Arraste o controle para sua nova localização.

Nota: Você pode mover vários controles pressionando a tecla shift e dando um clique em cada controle a ser movido e arrastando-o para sua nova localização.

Como copiar controles

Para copiar um controle:

  1. Dê um clique no controle a ser copiado.
  2. Dê um clique com o botão direito do mouse no controle.
  3. A partir do menu popup, escolha Editar.
  4. A partir do menu Editar, escolha Copiar.
  5. A partir do menu Editar, escolha Colar.
    Resultado: O novo controle aparece como o controle selecionado na parte superior do controle original.
  6. Mova o controle selecionado para o local desejado e desmarque-o.

Como redimensionar controles

Para redimensionar um controle:

  1. Selecione o controle que deseja redimensionar.
  2. Dimensione o controle com o indicador do mouse ou dê um clique duplo no controle para abrir suas propriedades. (O dimensionamento será completo se você utilizar o indicador do mouse.
  3. Em Anexos, altere as medidas.
  4. Escolha Aplicar ou OK.

Como redimensionar controles para o controle ativo

Além de dimensionar controles manualmente, você pode utilizar o menu popup para dimensioná-los para o controle ativo. O controle ativo é o "padrão" ou o controle que define o alinhamento para outros controles selecionados. O controle ativo é identificado por uma cor diferente dos controles selecionados.

Para dimensionar um controle:

  1. Pressione a tecla SHIFT e dê um clique em cada controle que deseja dimensionar. Selecione o controle ativo no final.
    Resultado: Cada controle selecionado é destacado. O controle ativo aparece em uma cor diferente.
  2. Dê um clique com o botão direito do mouse no controle ativo.
  3. A partir do menu popup, aponte para Mesmo Tamanho e escolha os comandos de dimensionamento apropriados.

Como alinhar controles para o controle ativo

Para alinhar controles:

  1. Pressione a tecla SHIFT e dê um clique em cada controle que deseja alinhar. Selecione o controle ativo no final.
    Resultado: Cada controle selecionado é destacado. O controle ativo aparece em uma cor diferente.
  2. Dê um clique com o botão direito do mouse no controle ativo.
  3. A partir do menu popup, aponte para Alinhar e escolha os comandos de alinhamento apropriados.

Como procurar controles que estão faltando ou são obscurecidos

Conforme você adiciona controles a um formulário, poderá descobrir que o posicionamento de alguns controles pode obscurecer ou ocultar completamente outros controles, especialmente quando o formulário tem o seu tamanho reduzido. Você pode procurar controles utilizando o menu popup.

Para procurar controles:

  1. Dê um clique com o botão direito do mouse em qualquer parte do formulário, exceto na barra de título.
  2. A partir do menu popup, escolha Editar e Procurar Controles.
    Resultado: Aparece a caixa Selecionar um Controle.
  3. Utilize uma das seguintes opções da caixa de opções para procurar o(s) controle(s):
  4. Obscurecidos exibe somente os controles na lista que estão obscurecidos por outro controle
  5. Escolha Selecionar para determinar quais controles serão modificados.
  6. Escolha uma das seguintes opções:

Como trazer um controle para a frente

Conforme você adiciona controles a um formulário, poderá descobrir que o posicionamento de alguns controles pode obscurecer ou ocultar completamente outros controles. Você pode trazer os controles menores para a frente dos controles maiores, utilizando o menu popup.

Para trazer controles para a frente:

  1. Dê um clique com o botão direito do mouse no controle da caixa do grupo.
  2. A partir do menu popup, escolha Trazer para Frente.

Como enviar um controle para trás

Utilize o comando de menu Enviar para Trás somente com o controle da caixa do grupo. A caixa do grupo é um dispositivo virtual que contém um conjunto de opções e controles relacionados. A caixa do grupo deve aparecer atrás dos controles; caso contrário, ela os ocultará.

Para enviar um controle da caixa do grupo para trás:

  1. Dê um clique com o botão direito do mouse no controle da caixa do grupo.
  2. A partir do menu popup, escolha Enviar para Trás.

Nota: Você também pode trazer um controle parcialmente oculto para a frente novamente escolhendo "Trazer para Frente" a partir do menu popup.

Como excluir controles

Para excluir um controle:

  1. Selecione o controle a ser excluído.
  2. Pressione a tecla Excluir.

Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface

Retornar ao Índice

Copyright