Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface
Retornar ao Índice
Adicionar avanços, tais como menus, barras de ferramentas, padrões
e auxílio online pode tornar seu aplicativo mais útil. Primeiro você deve definir estilos de menu e da barra de ferramentas antes
de adicionar esses avanços. Em seguida, renomeie o menu e a barra de ferramentas com o mesmo nome do formulário
e eles serão "anexados" automaticamente ao formulário.
Padrões são gabaritos para caixas de texto e são utilizados para fornecer dicas visuais
aos usuários, com relação ao formato das informações digitadas. Os padrões são especificados
como parte da descrição do controle em um arquivo de recurso.
Existem seis possíveis tipos de padrões:
- Data e Hora fornece máscaras de entrada ativadas pelo locale
para a digitação de datas e horas.
- Inteiro fornece máscaras de entrada para a digitação de inteiros.
- Real fornece máscaras de entrada para valores reais.
- Senha substitui todos os caracteres digitados por * .
- Personalizado permite descrições personalizadas para digitar texto em caixas de texto.
- Nenhum indica nenhum tipo de padrão.
Cada padrão consiste em uma máscara de entrada e de exibição. As máscaras de entrada
consistem em espaços em branco e espaços de preenchimento e não aparecem aos usuários, mas limitam
o que pode ser digitado. Por exemplo, você pode limitar os usuários para digitarem somente números
em um campo de previdência social e somente caracteres alfabéticos para um campo de nomes. As duas máscaras de exibição são definidas
através de sinalizadores de caracteres.
As máscaras de entrada são dicas visuais para os usuários sobre o que deve ser digitado em uma caixa de texto,
embora um usuário possa digitar qualquer coisa. Por exemplo, uma máscara de entrada para um número de
previdência social têm o seguinte aspecto:
nnn-nn-nnn
e uma máscara de entrada para um número de telefone tem o seguinte aspecto:
nnn-nnn-nnnn
Ao contrário das máscaras de exibição, as máscaras de entrada aparecem para os usuários.
As máscaras de entrada são compostas de sinalizadores de caracteres e definem o que um usuário pode digitar
em um padrão. Os sinalizadores de caracteres podem ser um dos seguintes:
- Alfa = limita as entradas em uma caixa de texto para somente caracteres alfabéticos
- Numérico = limita as entradas em uma caixa de texto para somente caracteres numéricos
- Qualquer um = as entradas podem ser alfanuméricas e também incluem símbolos
Os sinalizadores de caracteres podem ser personalizados através de caracteres válidos. Por exemplo,
se você criar um controle em que seja digitado o número da licença do controlador e o número começar
com letra maiúscula, será possível selecionar o sinalizador de caractere numérico e personalizá-lo
com o caractere válido "A,". Isto permite que o usuário digite uma letra alfa maiúscula
na primeira posição, enquanto o resto do campo permanece numérico.
A seguir são apresentados tipos de caracteres válidos:
- a = alfa maiúsculo ou minúsculo
- l = alfa minúsculo
- A = alfa maiúsculo
- # = numérico
- V = lista de caracteres válidos
- 0 = alfanumérico
- espaço = não são permitidos caracteres (somente leitura para os usuários)
Sinalizadores de preenchimento
Os sinalizadores de preenchimento consistem em:
- Reverso - preenche um padrão da direita para a esquerda
- Preencher tudo - torna um padrão inválido até que seja digitado um caractere válido para cada
posição de preenchimento na máscara de entrada
Os padrões predefinidos no Criador de Interface abrangem a maioria dos tipos de controles
que serão adicionados a um formulário. No entanto, utilize o seguinte procedimento se preferir criar
seus próprios padrões.
Para criar um padrão:
- Abra o Criador de Interface.
- Abra um arquivo de recurso que contenha um formulário para o qual você deseja definir padrões.
- Escolha o separador Padrões.
- Escolha Incluir.
Resultado: Aparece a caixa de diálogo Artista Padrão.
- Utilize a tabela a seguir para digitar informações conforme apropriado para seu aplicativo.
Campo |
Descrição |
ID do Padrão |
O nome do novo padrão. |
Descrição |
A descrição do padrão. |
Máscara de Exibição |
O formato que controla o que o usuário pode digitar. Por exemplo, se você tiver uma máscara de
número de telefone somente com caracteres numéricos, os usuários não conseguirão
digitar um outro tipo de caractere que não seja numérico. |
Máscara de Entrada |
A máscara de entrada aparece no campo, mas não tem controle
sobre o que o usuário pode digitar. Por exemplo, uma máscara de entrada para um número de telefone pode aparecer como nnn-nnn-nnnn;
no entanto, isto não impediria o usuário de digitar caracteres alfabéticos no campo se
a máscara de exibição não estivesse configurada somente para numérico. |
Caracteres Válidos |
A lista de caracteres válidos é mostrada aqui. |
Caractere de Preenchimento |
Um caractere que é inserido em uma caixa de texto quando uma entrada
de controle está incompleta. |
Padrão de Teste |
O padrão de teste. |
Caracteres |
Coloca uma restrição no tipo de dados que os usuários podem digitar no padrão:
caracteres AlphabeticNumericAny |
Preenchimento |
Especifica como os caracteres de preenchimento podem ser inseridos:
- Reverso insere caracteres da direita para a esquerda.
- Preencher tudo insere caracteres em todos os espaços de preenchimento.
|
- Escolha Aplicar ou OK.
- Associar o padrão a uma caixa de texto no formulário. Para obter mais informações sobre como
especificar padrões com controle da caixa de texto, consulte "Como Criar Controles."
Você pode aplicar padrões predefinidos e definidos pelo usuário a caixas de texto.
Para aplicar padrões a uma caixa de texto:
- Abra o Criador de Interface.
- Abra um arquivo de recurso que contenha pelo menos um formulário.
- Abra o formulário que deseja utilizar.
- Dê um clique duplo sobre a caixa de texto à qual deseja aplicar um padrão.
- Escolha o separador Caixa de Texto.
- A partir da lista Tipo de Padrão, selecione o padrão que deseja utilizar.
- Escolha Aplicar ou OK.
Os padrões podem ser desassociados de qualquer caixa de texto, incluindo os que estão nos aplicativos
de tempo de execução. Se um padrão for desassociado de uma caixa de texto, qualquer caractere poderá
ser digitado na caixa de texto.
Para desassociar um padrão de uma caixa de texto:
- Abra o Criador de Interface.
- Abra um arquivo de recurso que contenha o formulário.
- Abra o formulário que deseja utilizar.
- Dê um clique duplo no controle do qual deseja desassociar o padrão.
- Escolha o separador Caixa de Texto.
- A partir da lista Tipo de Padrão, selecione Nenhum.
Geralmente, os menus são utilizados para acessar comandos sem utilizar um prompt de comandos. Esta seção
discute como criar menus para formulários que se transformam em janelas.
Nota: O Criador de Interface permite criar menus com submenus,
mas primeiro é necessário definir estilos do menu e da barra de ferramentas. Em seguida, renomeie o menu e a barra de ferramentas com o mesmo nome do formulário
e eles serão "anexados" automaticamente ao formulário.
Você pode criar um menu quando cria um novo formulário para uma
janela, ou quando trabalha com um formulário existente. Neste caso, as instruções são para um formulário existente.
Nota: Não é necessário associar menus a formulários. Se o separador Menu
não aparecer na janela Criador de Interface TDT, selecione Preferências, no menu
Opções, clique na caixa de opções Mostrar Página do Menu e clique no botão OK para salvar as
alterações.
Para criar um menu:
- Abra o Criador de Interface.
- Abra um arquivo de recurso que contenha pelo menos um formulário.
- Escolha o separador Menu.
- Escolha Incluir.
Resultado: Aparece a caixa de diálogo Criador de Menu.
- Dê um clique no nome do menu.
Resultado: O nome associado ao menu aparece na caixa Nome do Menu.
- Escolha o botão de procura Nome do Menu.
- Digite um nome de menu exclusivo na caixa de diálogo ID Exclusivo e escolha OK.
Resultado: A caixa de diálogo ID Exclusivo se fecha e o nome do menu digitado
aparece na caixa de texto Nome do Menu na caixa de diálogo Criador de Menu. O nome do menu destina-se apenas
ao desenvolvimento e não aparece para os usuários.
- Na caixa Texto do Menu, digite o texto que deseja que apareça no menu.
- Na caixa do grupo Estilo, selecione a partir dos seguintes estilos:
- Separador permite um separador entre os comandos do menu
- Desativado determina se uma seleção de menu está ou não disponível
- Selecionável permite que um comando de menu seja ativado ou desativado quando um usuário o
escolhe
- Selecionado determina o estado padrão de um comando de menu selecionável
Nota: Se você selecionar Separador, aparecerá uma linha de separação em branco no
menu. Isto faz com que qualquer texto associado anteriormente ao comando de menu desapareça.
- Escolha Atualizar.
- Escolha OK.
Você pode adicionar outro menu no mesmo nível de menu dando um clique em Adicionar Depois.
Os submenus aparecem nos menus. Você pode criar submenus para um menu e também
aninhar um submenu em um submenu.
Para adicionar um submenu:
- Abra um arquivo de recurso que contenha pelo menos um formulário.
- Escolha o separador Menu.
- Escolha o menu ao qual deseja adicionar um submenu e dê um clique em Atualizar.
Resultado: Aparece a caixa de diálogo Criador de Menu.
- Dê um clique no menu na lista de menus à qual deseja adicionar um submenu.
- Escolha Adicionar Abaixo.
Resultado: Um novo submenu com o nome padrão NEW_ITEM1 aparece abaixo
do menu selecionado.
- Dê um clique no nome do novo submenu.
Resultado: As caixas Nome do Menu e Texto do Menu são ocupadas com
informações padrão.
- Especifique um nome de menu exclusivo, um texto de menu e auxílio (se necessário).
- Escolha Atualizar.
Resultado: O submenu padrão é substituído pelo novo texto do menu, bem como as
outras informações especificadas.
- Escolha OK.
Você pode adicionar um submenu a um submenu repetindo este procedimento. Para isto, selecione o
submenu em vez de um menu antes de dar um clique em Adicionar Abaixo. (Você pode adicionar outro submenu no mesmo nível de
submenu dando um clique em Adicionar Depois.)
Para testar um menu:
- Selecione um menu na estrutura da árvore.
- Escolha Testar.
Resultado: Aparece um menu popup com a estrutura do menu e o texto
criado.
- Dê um clique em qualquer lugar para fechar o menu popup.
- Escolha OK.
Para excluir um menu:
- Dê um clique em um menu ou submenu na estrutura da árvore.
- Dê um clique em Excluir.
Resultado: Se você selecionou um menu ou submenu que seja um "pai" para outros submenus,
aparecerá um prompt perguntando se você deseja atualizar as modificações no menu. Caso contrário,
o menu selecionado será excluído e removido da lista de menus.
- Escolha OK.
As barras de ferramentas permitem que os programas se comportem de uma maneira que seja mais "amigável"
do que seriam habitualmente. Os botões em uma barra de ferramentas agem como mnemônicos visuais, ou seja,
um botão representa um comando de menu do qual o usuário não precisa se lembrar. Os botões
também tornam mais acessíveis os comandos freqüentemente utilizados.
Esta seção descreve como adicionar uma barra de ferramentas a um formulário que se torna uma janela.
Nota: Para criar uma barra de ferramentas, selecione Preferências, no menu Opções,
clique na caixa de opções Mostrar Página da Barra de Ferramentas e no botão OK para salvar as
alterações.
Uma barra de ferramentas pode ser adicionada a um formulário a qualquer momento.
Para criar uma barra de ferramentas:
- Abra o Criador de Interface.
- Escolha o separador Barras de Ferramentas.
- Dê um clique em Adicionar.
Resultado: Aparece a caixa de diálogo Propriedades da Barra de Ferramentas. O nome de uma barra de ferramentas padrão,
NEW_TOOLBAR1, aparece na caixa de texto Nome da Barra de Ferramentas.
Nota: Se você selecionou a preferência pelo formulário Folhas de Propriedades Automáticas,
a folha de propriedades Propriedades da Barra de Ferramentas aparecerá automaticamente quando for criada uma nova barra de ferramentas.
- Escolha o botão de procura Nome da Barra de Ferramentas.
- Na caixa de diálogo ID Exclusivo, digite um nome exclusivo para substituir o nome da barra de ferramentas padrão
e escolha OK.
Resultado: A caixa de diálogo ID Exclusivo se fecha e o nome da barra de ferramentas digitado
aparece na caixa de texto Nome da Barra de Ferramentas na caixa de diálogo Propriedades da Barra de Ferramentas.
Para adicionar um botão na barra de ferramentas:
- Escolha o separador Barras de Ferramentas.
- Dê um clique na barra de ferramentas à qual deseja adicionar um botão.
- Dê um clique em Atualizar.
- A partir da caixa de diálogo Propriedades da Barra de Ferramentas, digite um ID da cadeia na caixa de texto ID do Item
para representar o botão para fins de desenvolvimento.
- Dê um clique no botão de procura Arquivo do Ícone.
- Selecione o arquivo do ícone que você deseja que apareça no botão.
- Para criar um texto da descrição de ferramenta, digite o texto na caixa Texto do Auxílio.
- Escolha Incluir.
Resultado: O botão aparece na lista representada pelas informações digitadas sobre o ID do Item,
o arquivo do ícone e o texto do auxílio.
- Para adicionar mais botões à barra de ferramentas, repita as etapas de 5 a 9 conforme necessário.
- Se desejar que os botões fiquem em uma ordem diferente daquela em que os adicionou, utilize
os botões Mover para Cima e Mover para Baixo para reorganizar a ordem.
Nota: O botão na parte superior da lista aparecerá na parte superior da barra de
ferramentas, se ela aparecer verticalmente, e o primeiro botão no lado esquerdo, se a barra de
ferramentas aparecer horizontalmente.
- Escolha Atualizar.
- Escolha OK.
Os separadores melhoram a aparência de uma barra de ferramentas porque permitem espaço entre os
botões, o que facilita a utilização visual da barra de ferramentas.
Para adicionar um separador a uma barra de ferramentas:
- Abra um arquivo de recurso que contenha o formulário com o qual você deseja trabalhar.
- Escolha o separador Barras de Ferramentas.
- Dê um clique duplo no nome da barra de ferramentas que deseja utilizar.
- A partir da caixa de diálogo Propriedades da Barra de Ferramentas, dê um clique no nome do formulário da barra de ferramentas
que deseja utilizar.
- Escolha Separador.
Resultado: O separador aparece na parte inferior da lista de barras de ferramentas.
- Escolha Mover para Cima ou Mover para Baixo para mover o Separador entre os botões da barra de ferramentas.
- Repita as etapas 6 e 7 para adicionar mais separadores.
- Se desejar que os botões fiquem em uma ordem diferente daquela em que os adicionou, utilize
os botões Mover para Cima e Mover para Baixo para reorganizar a ordem.
- Escolha Atualizar.
- Escolha OK.
Os controles de hipertexto fornecem informações online para usuários finais e podem incluir texto, som
e imagens. Eles também podem ser ligados a programas externos. Os controles de hipertexto não substituem
o auxílio online, mas são um método alternativo de exibir informações.
Os controles de hipertexto ficam visíveis se houver um formulário aberto. Eles aparecem como uma caixa de entrada
multilinha com texto. O texto pode ser representado como texto colorido ou como um botão.
Os botões aparecem com uma cor diferente do texto regular no momento da execução. Quando é dado um clique
no botão, aparece o Visualizador de Hipertexto do TSD Developer's Toolkit, contendo o item ligado.
A seguir são apresentados os tipos de botões que podem ser criados:
- Numérico
- Alfabético
- Imagem
- Arquivo externo
- Cadeia de pesquisa
- Programa externo
- Marcação do marcador
Os botões são criados através das marcações da cadeia de hipertexto.
Para criar um botão de hipertexto:
- Abra um arquivo de recurso que contenha o formulário que deseja utilizar.
- Abra o formulário que deseja utilizar.
- A partir da Paleta de Controles, dê um clique no botão Hipertexto.
- No formulário, dê um clique com o indicador do mouse onde deseja que o botão apareça e arraste
o indicador do mouse até que o contorno do botão esteja com o tamanho desejado.
Nota: Se você selecionou a preferência pelo formulário Folhas de Propriedades Automáticas,
a folha de propriedades Propriedades do Controle aparecerá automaticamente quando for criado um novo controle.
- Dê um clique com o botão direito do mouse no controle de hipertexto.
- Escolha Propriedades.
- Define as propriedades do separador Base ou Auxílio conforme necessário.
- Escolha o separador Hipertexto.
- Selecione um estilo a ser aplicado ao botão de hipertexto.
- Sem Quebra de Linha significa que o usuário deve utilizar retornos de carro fixos
para quebrar o texto manualmente para a próxima linha.
- Sem Formatação provoca a quebra de linha automática
- Nenhum não provoca a formatação da linha
- Utilize a tabela a seguir para digitar a marcação de hipertexto apropriada na caixa Texto Inicial.
Nota: Em cada exemplo de marcação de hipertexto, Nome do Botão representa o que o usuário
verá.
Marcação |
Objetivo |
Sintaxe |
Opções de Estilo |
Botão Alfabético |
Transmite um ID alfabético para um programa Developer's Toolkit |
[[Nome do Botão|RÓTULO texto do rótulo]] |
N/A |
Arquivo externo |
Cria um link para um arquivo externo |
[[Nome do Botão|ARQUIVO ATRIBUTOS de nome do arquivo]] |
- 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 provoca a quebra de linha automática.
- Nenhum não possui formatação da linha.
|
Programa externo |
Cria links para programas externos. O arquivo executável do programa deve
ter uma extensão .exe. Os argumentos especificados são transmitidos como argumentos do
prompt de comandos para o programa. |
[[Nome do Botão|EXECUTAR ARGUMENTOS de nome do programa]] |
N/A |
Link de hipertexto |
Cria um link de hipertexto para uma URL. O link inicia o navegador da Internet
especificado na variável de ambiente WebBrowser. O nome da URL pode ser http, ftp e news. |
[[texto | nome da URL]] |
O texto aparece como um bloco azul. |
Imagem |
Cria um botão da imagem |
[[Nome do Botão|ATRIBUTOS do nome do arquivo de IMAGEM]] |
- Rolar cria barras de rolagem na janela do hipertexto.
- Limite corta a imagem para que caiba na moldura.
- Escala faz com que a imagem caiba totalmente na janela de hipertexto.
|
Marcação Saltar |
Pesquisa a lista de marcações em busca de um marcador que corresponda ao texto
depois do salto. Se for encontrada uma correspondência, a linha que contém o marcador será posicionada na parte superior
do visualizador. Além disso, a exibição de hipertexto processa EventJump para manter uma lista de marcadores utilizados
em um arquivo. |
[[texto | Nome do marcador de salto]] |
N/A |
Marcação do marcador |
Coloca um marcador invisível no texto |
[[texto | Marcador nome do marcador]] |
N/A |
Botão Numérico |
Transmite um botão numérico para um programa TSD Script |
[[Nome do Botão|ID id_number]] em que Nome do Botão
o texto é exibido para o usuário |
N/A |
Cadeia de pesquisa |
Procura o texto especificado em um visualizador de hipertexto |
[[Nome do Botão|PESQUISA texto de pesquisa]] |
N/A |
Arquivo de som |
Cria links para arquivos de som |
[[Nome do botão|REPRODUZIR nome do arquivo]] |
N/A |
- Quando terminar de definir as propriedades, escolha Aplicar ou OK.
Nota: Dando um clique no link exibe o Visualizador do TSD Developer's Toolkit.
Você pode criar auxílio online dependente de contexto para controles e formulários de duas formas:
- Adicionando o texto de auxílio diretamente no Criador de Interface
- Ligando um arquivo de auxílio ao controle ou formulário
Os arquivos de auxílio ligados ao seu formulário devem residir em uma das seguintes áreas:
- Diretório de trabalho
- Caminho
- Saipath
Para adicionar o auxílio online:
- Dê um clique duplo no controle ou formulário para exibir suas propriedades.
- Escolha o separador Auxílio.
- Execute uma das seguintes ações:
- Se desejar adicionar texto do auxílio diretamente do Criador de Interface, selecione o botão de opção
Texto do Auxílio e digite o texto do auxílio na caixa abaixo do botão de opção Texto do Auxílio.
- Se desejar se ligar a um arquivo de auxílio, selecione o botão de opção Arquivo de Auxílio e digite o caminho
do arquivo na caixa de texto. Se não souber onde o arquivo está localizado, utilize o botão Procurar
para encontrar o arquivo e escolha o nome do arquivo.
- Escolha Aplicar ou OK.
Nota: Você só pode utilizar as marcações de texto do auxílio do Developer's Toolkit em seu formulário.
Tivoli Service Desk 6.0 Developer's Toolkit - Guia do Criador de Interface
Retornar ao Índice
Copyright