Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Constantes do TSD Script

Retornar a Página Principal


Estilos de Janelas

Os sinalizadores de estilo a seguir são utilizados com as instruções WinCreate, WinCreateScrollWindow e WinEditField, a menos que observado de outra maneira. Eles determinam os elementos que devem ser incluídos na janela criada. Os elementos podem ser combinados utilizando-se o operador BitOr.

Dica: Para obter maiores informações consulte a página Mensagens do TSD Script.

Elementos de Tamanho e Posição

Sinalizador de Estilo Descrição
$WinAutoPos O sistema operacional determina a melhor posição para a janela, ignorando os parâmetros xLoc e yLoc nas instruções WinCreate ou WinCreateScroll Window.
$WinAutoSize O sistema operacional determina o melhor tamanho para a janela, ignorando os parâmetros xLen e yLen nas instruções WinCreate ou WinCreateScroll Window.
$WinMinimized Permite que as janelas sejam criadas no estado de ícone (minimizado).

Estilos de Moldura

Sinalizador de Estilo Descrição
$WinBorder A janela é criada com uma moldura semelhante a uma caixa de diálogo. Vários estilos requerem uma moldura. Este estilo é mutuamente exclusivo com $WinField.
$WinField A janela é criada com uma moldura de 1 pixel (como caixas de texto em caixas de diálogos). Este estilo é mutuamente exclusivo com $WinBorder.
$WinResize A janela é criada com uma moldura redimensionada. Este estilo requer que o estilo $WinBorder seja atual. Se $WinTitle for atual, um botão maximizado é automaticamente incluído na janela.

Elementos da Janela

Sinalizador de Estilo Descrição
$WinHScroll A janela é criada com uma barra de deslocamento horizontal. A janela deve ser capaz de processar as mensagens da barra de deslocamento para a barra de deslocamento funcionar. Isso não pode ser utilizado com o WinEditField.
$WinIconBar A janela é criada com uma barra de ferramentas. A barra de ferramentas é incluída abaixo da barra de título e da barra de menus (se atual) e não é exibida quando vazia. Esta não pode ser utilizada com o WinEditField.

A barra de ferramentas pode ser carregada com a instrução WinSetIconBar. $WinBorder é requerido.

$WinMenu A janela é criada com uma barra de menus. Esta não pode ser utilizada com o WinEditField. Uma barra de menus vazia não é exibida. As seleções de menus podem ser definidas utilizando-se a instrução $WinSetMenuBar. $WinBorder deve ser atual.
$WinMinMax Os botões Minimizar e maximizar são incluídos no canto superior direito da janela. Um ícone minimizado padrão é criado para a janela. O ícone pode ser alterado com a mensagem $MsgSetIcon. $WinBorder é requerido. Este não pode ser utilizado com o WinEditField.

No Windows, se você não especificar $WinMinMax, sua barra de título não possui um botão Minimizar ou Maximizar.

No OS/2 se você não especificar $WinMinMax, sua barra de título conterá uma zona em tom de cinza onde esses botões deveriam estar diferentemente.

$WinStatus A janela é criada com uma barra de status. O aplicativo adiciona o conteúdo da barra de status em resposta à mensagem $MsgPaintStatus. Esta não pode ser utilizada com o WinEditField.
$WinSysMenu A janela é criada com um menu do sistema.$WinBorder deve ser atual. Isso não pode ser utilizado com o WinEditField.
$WinTitle A janela é criada com uma barra de título. Se este estilo estiver ausente, nenhum título aparecerá, mesmo se um título for especificado como um dos parâmetros. Uma barra de título permite que a janela se mova.
$WinVScroll A janela é criada com uma barra de deslocamento vertical. A janela deve ser capaz de processar as mensagens da barra de deslocamento para a barra de deslocamento funcionar. Esta não pode ser utilizada com o WinEditField.

Outros Elementos da Janela

Sinalizador de Estilo Descrição
$WinAutoScroll Desloca a janela verticalmente, para manter a última linha visível na janela. Se você utilizar este sinalizador para criar uma janela de deslocamento e se chamar repetidamente WinWriteLN para registrar informações na janela, a janela é automaticamente deslocada para manter os dados que foram gravados abaixo da área do cliente visível como a última linha na tela.

Nota: Este sinalizador pode ser utilizado com o $WinCreateScrollWindow, mas não com o $WinCreate.

$WinDefaultStyle A janela é criada com o estilo de janela padrão. Esta é a combinação de $WinBorder, $WinResize, $WinTitle e $WinSysMenu.
$WinInvisible A janela é criada para ser ocultada. $MsgShow deve ser enviado para tornar a janela visível.
$WinModal A janela criada pela instrução WinEditField é ativada quando criada. Entretanto, a janela principal e todas as outras janelas secundárias dessa janela principal são desativadas.

Este estilo é utilizado somente com a instrução WinEditField.

$WinNone A janela é criada com nenhum dos atributos listados.
$WinTaskList O título da janela é listado na lista de tarefas do sistema. O usuário pode ativar a janela a partir da lista de tarefas. Geralmente, este estilo deve ser utilizado para a janela principal do aplicativo.

No Windows, este estilo é ignorado e quaisquer janelas apresentadas pelo ambiente de trabalho aparece na lista de alteração do sistema.

Cores de Texto e Opaco versus Transparente

Estas constantes são utilizadas com a instrução WinSetColor para definir o texto da janela para a cor especificada.
As constantes $WinOpaque e $WinTransparent cada uma pode ser combinada com uma das outras constantes de cores, utilizando o operador BitOr.

Dica: As constantes $WinDefaultColor e $WinDefaultStyle serão utilizadas, se você não especificar quaisquer outras cores e estilos.

Opaco versus Texto Transparente

Sinalizador de Estilo Descrição
$WinOpaque O texto é opaco. Este não está disponível no OS/2.
$WinTransparent O texto é transparente.

Cores do Texto

Sinalizador de Estilo Descrição
$WinDefaultColor O texto é a cor padrão, conforme determinado pelo sistema operacional.
Se você especificar a cor de primeiro plano como $WinDefaultColor, a cor especificada no $SysClrWindowText será utilizada.

Se você especificar a cor de plano de fundo como $WinDefaultColor, a cor especificada no $SysClrWindow será utilizada.

$WinBlack Texto preto
$WinBlue Texto azul
$WinBrown Texto marrom
$WinCyan Texto ciano
$WinDarkGray Texto cinza escuro
$WinGreen Texto verde
$WinLightBlue Texto azul claro
$WinLightCyan Texto ciano claro
$WinLightGray Texto cinza claro
$WinLightGreen Texto verde claro
$WinLightMagenta Texto magenta claro
$WinLightRed Texto vermelho claro
$WinMagenta Texto magenta
$WinRed Texto vermelho
$WinWhite Texto branco
$WinYellow Texto amarelo

Cores da Janela Definidas pelo Sistema

Essas constantes representam os usuários de cores definidos como preferências para o sistema operacional no qual elas funcionam. Essas constantes não podem ser combinadas. (Se elas forem combinadas, um valor inválido será gerado).

Sinalizador de Estilo Descrição
$SysClrActiveBorder A cor da moldura da janela ativa
$SysClrActiveTitle A cor da barra de título da janela ativa
$SysClrActiveTitleText A cor do texto da barra de título da janela ativa
$SysClrActiveTitleTextBgnd A cor de plano de fundo da barra de título da janela ativa
$SysClrAppWorkspace A cor da área do cliente
$SysClrBackground A cor de plano de fundo da janela
$SysClrButtonDark O destaque escuro do botão tridimensional
$SysClrButtonDefault A cor do botão padrão conforme determinado pelo sistema operacional
$SysClrButtonLight O destaque claro do botão tridimensional
$SysClrButtonMiddle A cor de plano de fundo do botão conforme determinado pelo sistema operacional
$SysClrDialogBackground A cor de plano de fundo da caixa de diálogo
$SysClrEntryField A cor da caixa de texto
$SysClrFieldBackground A cor de plano de fundo da caixa de texto
$SysClrHelpBackground A cor de plano de fundo do texto de auxílio
$SysClrHelpHilite A cor dos destaques de auxílio (hot spots ou ligações)
$SysClrHelpText A cor do texto de auxílio
$SysClrHiliteBackground A cor do plano de fundo dos destaques de auxílio (hot spots ou ligações)
$SysClrHiliteForeground A cor de primeiro plano dos destaques de auxílio (hot spots ou ligações)
$SysClrIconText A cor do texto de ícone
$SysClrInactiveBorder A cor da moldura da janela inativa
$SysClrInactiveTitle A cor da barra de título da janela inativa
$SysClrInactiveTitleText A cor do texto de título da janela inativa
$SysClrInactiveTitleTextBgnd A cor de background do texto do título da janela inativa
$SysClrMenu A cor da barra de menus
$SysClrMenuDisabledText A cor do texto desativado
$SysClrMenuHilite A cor do item de menu selecionado
$SysClrMenuHiliteBgnd A cor de background do item de menu selecionado
$SysClrMenuText A cor do texto de menu
$SysClrOutputText A cor do texto de saída
$SysClrPageBackground A cor de plano de fundo da página
$SysClrScrollBar A cor da barra de deslocamento
$SysClrShadow A cor de sombra. Não está disponível no Windows.
$SysClrShadowHiliteBgnd A cor de plano de fundo de sombra tridimensional. Não está disponível no Windows.
$SysClrShadowHiliteFgnd A cor de primeiro plano de sombra tridimensional. Não está disponível no Windows.
$SysClrShadowText A cor do texto sombra
$SysClrTitleBottom A cor do botão de menu do sistema
$SysClrTitleText A cor do texto da barra de título
$SysClrWindow A cor de plano de fundo da janela
$SysClrWindowFrame A cor da estrutura da janela
$SysClrWindowStaticText A cor do texto estático da janela
$SysClrWindowText A cor do texto da janela

Item Fechar do Menu do Sistema

Você pode ativar ou desativar o item Fechar em um menu do sistema da janela. Utilize a constante $SysMenuCloseItem com a instrução WinMenuEnableItem como segue:

(*Isso ativa o item Fechar *)
WinMenuEnableItem(myWindow,
$SysMenuCloseItem, TRUE);
(*Isso desativa o item Fechar: *)
WinMenuEnableItem(myWindow,
$SysMenuCloseItem, FALSE);

Códigos de Teclas

Estas constantes representam os valores que são transmitidos ao sistema, quando um usuário pressiona a tecla indicada na tabela abaixo. Essas constantes não podem ser combinadas. Se elas forem combinadas, um valor inválido será gerado.

A tabela a seguir mostra os parâmetros $MsgChar e Alt + teclas de letras correspondentes pressionadas pelo usuário.

Alt + Códigos de Teclas de Letras

A tabela a seguir mostra os parâmetros $MsgChar e Alt + teclas de letras correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a tecla ALT e a...
$KeyAltA Tecla A
$KeyAltB Tecla B
$KeyAltBS Tecla Backspace
$KeyAltC Tecla C
$KeyAltD Tecla D
$KeyAltE Tecla E
$KeyAltF Tecla F
$KeyAltG Tecla G
$KeyAltH Tecla H
$KeyAltI Tecla I
$KeyAltJ Tecla J
$KeyAltK Tecla K
$KeyAltL Tecla L
$KeyAltM Tecla M
$KeyAltN Tecla N
$KeyAltO Tecla O
$KeyAltP Tecla P
$KeyAltQ Tecla Q
$KeyAltR Tecla R
$KeyAltS Tecla S
$KeyAltT Tecla T
$KeyAltU Tecla U
$KeyAltV Tecla V
$KeyAltW Tecla W
$KeyAltX Tecla X
$KeyAltY Tecla Y
$KeyAltZ Tecla Z

Alt + Códigos da Tecla de Função

(A tabela a seguir mostra os parâmetros $MsgChar e Alt + teclas de função correspondentes pressionadas pelo usuário. )

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a tecla Alt e a...
$KeyAltFn1 Tecla F1
$KeyAltFn2 Tecla F2
$KeyAltFn3 Tecla F3
$KeyAltFn4 Tecla F4
$KeyAltFn5 Tecla F5
$KeyAltFn6 Tecla F6
$KeyAltFn7 Tecla F7
$KeyAltFn8 Tecla F8
$KeyAltFn9 Tecla F9
$KeyAltFn10 Tecla F10

Alt+Códigos de Tecla de Seta

A tabela a seguir mostra os parâmetros $MsgChar e Alt + teclas de seta correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a tecla Alt e a...
$KeyAltLeftArrow Tecla Seta para a Esquerda
$KeyAltRightArrow Tecla Seta para a Direita

Control + Códigos de Teclas

A tabela a seguir mostra os parâmetros $MsgChar e Ctrl+ teclas especiais correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é passado a uma rotina de tratamento de eventos... ele indica que o usuário pressionou a tecla Ctrl e...
$KeyControlDelete Tecla Delete
$KeyControlDownArrow Tecla Seta para Baixo
$KeyControlEnd Tecla End
$KeyControlFn1 Tecla F1
$KeyControlFn2 Tecla F2
$KeyControlFn3 Tecla F3
$KeyControlFn4 Tecla F4
$KeyControlFn5 Tecla F5
$KeyControlFn6 Tecla F6
$KeyControlFn7 Tecla F7
$KeyControlFn8 Tecla F8
$KeyControlFn9 Tecla F9
$KeyControlFn10 Tecla F10
$KeyControlFn11 Tecla F11
$KeyControlFn12 Tecla F12
$KeyControlHome Tecla Home
$KeyControlInsert Tecla Insert
$KeyControlPageDown Tecla Page Down
$KeyControlPageUp Tecla Page Up
$KeyControlRightArrow Tecla Seta para a Direita
$KeyControlLeftArrow Tecla Seta para a Esquerda
$KeyControlUpArrow Tecla Seta para Cima

Códigos de Teclas de Função

A tabela a seguir mostra os parâmetros $MsgChar e as teclas de função correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a...
$KeyFn1 Tecla F1
$KeyFn2 Tecla F2
$KeyFn3 Tecla F3
$KeyFn4 Tecla F4
$KeyFn5 Tecla F5
$KeyFn6 Tecla F6
$KeyFn7 Tecla F7
$KeyFn8 Tecla F8
$KeyFn9 Tecla F9
$KeyFn10 Tecla F10
$KeyFn11 Tecla F11
$KeyFn12 Tecla F12

Shift + Códigos de Teclas

A tabela a seguir mostra os parâmetros $MsgChar e Shift+ teclas correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é passado a uma rotina de tratamento de eventos... ele indica que o usuário pressionou a tecla Shift e a...
$KeyShiftDelete Tecla Delete
$KeyShiftDownArrow Tecla Seta para Baixo
$KeyShiftEnd Tecla End
$KeyShiftHome Tecla Home
$KeyShiftInsert Tecla Insert
$KeyShiftLeftArrow Tecla Seta para a Esquerda
$KeyShiftPageDown Tecla Page Down
$KeyShiftPageUp Tecla Page Up
$KeyShiftTab Tecla Tab
$KeyShiftRightArrow Tecla Seta para a Direita
$KeyShiftUpArrow Tecla Seta para Cima

Shift e os Códigos de Teclas de Função

A tabela a seguir mostra os parâmetros $MsgChar e Shift + teclas de função correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a tecla Shift e a...
$KeyShiftFn1 Tecla F1
$KeyShiftFn2 Tecla F2
$KeyShiftFn3 Tecla F3
$KeyShiftFn4 Tecla F4
$KeyShiftFn5 Tecla F5
$KeyShiftFn6 Tecla F6
$KeyShiftFn7 Tecla F7
$KeyShiftFn8 Tecla F8
$KeyShiftFn9 Tecla F9
$KeyShiftFn10 Tecla F10
$KeyShiftFn11 Tecla F11
$KeyShiftFn12 Tecla F12

Códigos de Teclas para Barras de Deslocamento

A tabela a seguir mostra os parâmetros $MsgChar e a localização correspondente na barra de deslocamento, onde o usuário dê um clique sobre o mouse.

Quando este parâmetro $MsgChar é passado a uma rotina de tratamento de eventos... ele indica que o usuário deu um clique com o mouse...
$KeyScrollPageUp na área vazia de uma barra de deslocamento vertical acima da área de deslocamento.
$KeyScrollPageDown na área vazia de uma barra de deslocamento vertical abaixo da área de deslocamento.
$KeyScrollPageLeft na área vazia de uma barra de deslocamento vertical à esquerda da área de deslocamento.
$KeyScrollPageRight na área vazia de uma barra de deslocamento vertical à direita da área de deslocamento.
$KeyScrollLineUp na seta para cima de uma barra de deslocamento vertical.
$KeyScrollLineDown na seta para baixo de uma barra de deslocamento vertical.
$KeyScrollLineLeft na seta à esquerda de uma barra de deslocamento horizontal.
$KeyScrollLineRight na seta à direita de uma barra de deslocamento horizontal.

Códigos de Teclas Diversos

A tabela a seguir mostra os parâmetros $MsgChar e teclas diversas correspondentes pressionadas pelo usuário.

Quando este parâmetro $MsgChar é transmitido a um identificador de eventos... ele indica que o usuário pressionou a...
$KeyBackSpace Tecla Backspace
$KeyHome Tecla Home
$KeyInsert Tecla Insert
$KeyLeftArrow Tecla Seta para a Esquerda
$KeyPageDown Tecla Page Down
$KeyPageUp Tecla Page Up
$KeyReturn Tecla Retornar
$KeyRightArrow Tecla Seta para a Direita
$KeyUpArrow Tecla Seta para Cima
$KeyDownArrow Tecla Seta para Baixo
$KeyCRCarriage Tecla Retornar
$KeyDelete Tecla Delete
$KeyEndkey Tecla End
$KeyEscape Tecla ESC

Estilos de Imagens

As constantes definem estilos de imagens. Vários estilos podem ser combinados utilizando a instrução BitOr. Um exemplo de estilos de imagens combinados é a combinação de uma barra de título, uma barra de deslocamento e uma imagem de limite. Os estilos de imagens são utilizados com a instrução WinCreateImage. O padrão Windows é $ImgScale. O padrão OS/2 é $ImgBorder.

A tabela a seguir lista as constantes e os estilos de imagens resultantes.

Constante Estilo de Imagem
$ImgBorder Coloca uma moldura ao redor da imagem
$ImgClip Limita a imagem ao retângulo da janela. Não escala a imagem
$ImgScale Escala a imagem para que caiba na janela
$ImgScroll Desloca a imagem. Não escala a imagem para que caiba na janela
$ImgTitle Coloca uma barra de título na janela que contém a imagem

Indicadores do Mouse

A tabela a seguir mostra indicadores do mouse disponíveis. Eles são enviados com a instrução WinSetPointer . A constante do indicador padrão é $MouseDefaultPtr. As instruções BitOr não podem ser utilizadas com indicadores do mouse.

Este indicador do mouse... exibe o...
$MouseMaxPointer indicador de maximização.
$MouseCrossPtr indicador reticular.
$MouseDefaultPtr indicador padrão.
$MouseDLArrowPtr indicador de seta à esquerda com ângulo para baixo.
$MouseDLResizePtr indicador de redimensionamento à esquerda com ângulo para baixo.
$MouseDnResizePtr indicador de redimensionamento com ângulo para baixo.
$MouseDRArrowPtr indicador de seta à direita com ângulo para baixo.
$MouseDRResizePtr indicador de redimensionamento à direita com ângulo para baixo.
$MouseHandPtr indicador manual.
$MouseHourglassPtr indicador de ampulheta.
$MouseIBeamPtr indicador I.
$MouseLTResizePtr indicador de redimensionamento à esquerda.
$MouseRTResizePtr indicador de redimensionamento à direita.
$MouseULArrowPtr indicador de seta à esquerda com ângulo para cima.
$MouseULResizePtr indicador de redimensionamento à esquerda com ângulo para cima.
$MouseUPResizePtr indicador de redimensionamento com ângulo para cima.
$MouseURArrowPtr indicador de seta à direita com ângulo para cima.
$MouseURResizePtr indicador de redimensionamento com ângulo para cima.

Mensagens do Mouse

Estas mensagens podem ser enviadas em resposta a e com uma mensagem $MsgMouse. Essas mensagens não podem ser combinadas.

Esta mensagem... indica que o usuário...
$MouseLeftClick deu um clique com o botão esquerdo do mouse.
$MouseLeftDouble deu um clique duplo com o botão esquerdo do mouse.
$MouseLeftEndDrag pressionou o botão esquerdo do mouse, arrastou o mouse e liberou o botão esquerdo do mouse.
$MouseLeftStartDrag deu um clique com o botão esquerdo do mouse e o arrastou.
$MouseNone não moveu o mouse.
$MouseRightClick deu um clique com o botão direito do mouse.
$MouseRightDouble deu um clique duplo com o botão direito do mouse.

Constantes da Caixa de Diálogo

As constantes da caixa de diálogo definem o estilo de uma caixa de diálogo. Elas são utilizadas com a instrução WinFileDialog. A constante padrão é $FileDlgOpen. A constante $FileDlgCenter pode ser combinada com a constante $FileDlgOpen ou com a constante $FileDlgSaveAs.
A tabela a seguir mostra as constantes da caixa de diálogo e seus efeitos no estilo de uma caixa de diálogo.

Constante da caixa de diálogo Efeito
$FileDlgCenter Centraliza a caixa de diálogo no meio da janela.
$FileDlgOpen Cria uma caixa de diálogo aberta.
$FileDlgSaveAs Cria uma caixa de diálogo Salvar Como.

Estilos de Janelas do Visualizador de Hipertexto

A tabela a seguir mostra as constantes e mensagens de eventos associadas aos estilos resultantes que elas estabelecem para janelas do visualizador de hipertexto.

Esta constante... utilizada com esta mensagem de eventos... possui este efeito na janela do visualizador de hipertexto...
$HyperNoWordWrap $MsgOpenFile texto não possui quebra de linha no visualizador de hipertexto. Uma barra de deslocamento horizontal é atual.
$HyperScaleImage $MsgDisplayImage a imagem é escalada para se ajustar no visualizador de hipertexto.
$HyperScrollImage $MsgDisplayImage a imagem não é escala para se ajustar. Entretanto, ele pode ser deslocada.

Estilos de Relógio

Os estilos de relógio são utilizados com a instrução WinCreateClock. Esses estilos podem ser combinados utilizando-se a instrução BitOr.

Para o Windows, os padrões são $ClkBorderIn e $Clk12Hour.

Para o OS/2, os padrões são $ClkBorder e $Clk12Hour. A tabela a seguir mostra as constantes que podem ser utilizadas com a instrução WinCreateClock e os estilos de relógio resultantes.

Com esta constante... o relógio...
$Clk12Hour é um relógio de 12 horas.
$Clk24Hour é um relógio de 24 horas.
$ClkBorder
(padrão OS/2)
possui uma moldura.
$ClkBorderIn
(padrão Windows)
aparece alinhado (3D).
$ClkBorderNone não possui moldura.
$ClkBorderOut aparece elevado (3D).
$ClkHidden está oculto.

Estilos da Caixa de Mensagens

As constantes a seguir são utilizadas com as caixas de mensagens da instrução WinMessageBox. As constantes padrão são $MBOK e $MBAPPMODAL. Esses estilos resultantes podem ser combinados utilizando-se a instrução BitOr. Por exemplo, você pode criar uma caixa de diálogo modal do aplicativo com um ícone Erro e um botão OK.

Estilos de Botão

A tabela a seguir mostra as constantes que podem ser utilizadas com a instrução WinMessageBox e os estilos de botão resultantes.

Com esta constante... a caixa de mensagens...
$MBAbortRetryIgnore possui três botões: Abortar, Repetir e Ignorar.
$MBCancel no OS/2, possui um botão Cancelar.
no Windows, possui um botão, que é rotulado Cancelar (igual a $MBOK).
$MBDefButton1 possui um botão definido pelo usuário (#1).
$MBDefButton2 possui um botão definido pelo usuário (#2).
$MBDefButton3 A caixa de mensagens possui um botão definido pelo usuário (#3).
$MBEnter no OS/2, possui um botão Enter.
no Windows, possui somente um botão, que é rotulado OK (igual a $MBOK).
$MBEnterCancel no OS/2, possui dois botões: Enter e Cancelar.
no Windows, possui dois botões, que são rotulados OK e Cancelar (mesmo que $MBOKCancel).
$MBOK possui um botão OK.
$MBOKCancel possui dois botões: OK e Cancelar.
$MBRetryCancel possui dois botões: Repetir e Cancelar.
$MBYesNo possui dois botões: Sim e Não.
$MBYesNoCancel possui três botões: Sim, Não e Cancelar.

Estilos de Ícones

A tabela a seguir mostra as constantes que pdoem ser utilizadas com a instrução WinMessageBox e os estilos de ícone resultantes.

Com esta constante... a caixa de mensagens possui...
$MBIconError um ícone Erro.
$MBIconInformation um ícone Informações.
$MBIconQuery um ícone Consultar.
$MBIconWarning um ícone Aviso.
$MBNoIcon nenhum ícone.

Estilos Diversos

A tabela a seguir mostra as constantes que podem ser utilizadas com a instrução WinMessageBox e os estilos diversos resultantes.

Com esta constante... a caixa de mensagens é...
$MBAppModal modalidade do aplicativo.
$MBSysModal modalidade do sistema.
$MBMoveable movível. Com esta constante, você pode definir caixas de mensagens para que possam ser movidas em volta da tela.

Estilos de Resultado (Códigos)

A tabela a seguir mostra o formato de retorno de número inteiro de WinMessageBox, que é igual a uma dessas constantes.

Este código de retorno... indica que o usuário pressionou ...
$MBResultAbort Abortar
$MBResultCancel Cancelar
$MBResultEnter Enter
$MBResultError Erro
$MBResultIgnore Ignorar
$MBResultNo Não
$MBResultOK OK
$MBResultRetry Repetir
$MBResultYes Sim

Sinalizadores de Criação de Sessão

A tabela a seguir mostra os sinalizadores de criação que podem ser utilizados com a SysCreateSession. Estes estilos não podem ser combinados e não existe nenhum estilo de sessão.

Sinalizador de Criação Efeito
$SessionAutoPosition O sistema operacional determina a localização da janela da sessão
$SessionBackground Este cria uma sessão que é executada no plano de fundo
$SessionInvisible Este cria uma sessão com uma janela invisível

Sinalizadores de Formato do Tipo de Dados

As constantes são utilizadas para formatar dados de tipos diferentes e pode ser utilizada com os operadores de formatação de cadeia. Cada uma das instruções a seguir é utilizada para acessar uma variável:

Se você transmitir um valor para uma dessas instruções, alterará o valor da variável. A constante $FmtDefault pode ser utilizada para escolher o formato padrão para os tipos de dados listados acima. (O formato escolhido depende do tipo de dados que você está utilizando.)

Dica: Para cada uma das categorias a seguir de estilos de formato, o estilo padrão está em negrito. Nas ocorrências onde múltiplos estilos podem ser utilizados em conjunto (em outras palavras, eles não são mutuamente exclusivos), existe mais de um padrão.

Sinalizadores de Formato Booleano

As constantes a seguir convertem um valor Booleano para uma cadeia em um dos formatos mostrados. O padrão é $FmtBoolTrueFalse.

Esta constante... converte o valor Booleano para uma cadeia neste formato...
$FmtBoolTrueFalse verdadeiro ou falso.
$FmtBoolBinary 0 ou 1.
$FmtBoolYesNo sim ou não.

Sinalizadores de Formato de Data

As constantes a seguir convertem um valor de data em uma cadeia em um dos formatos mostrados. Estes formatos de data podem ser combinados. Por exemplo, você pode selecionar casos misturados, formato Europeu e nomes abreviados.

Dica: Para cada uma das categorias a seguir de sinalizadores de formato, o sinalizador padrão dos Estados Unidos está em itálico.

Maiúsculas e Minúsculas de Formato de Mês, Dia e Ano

Maiúsculas de Minúsculas Descrição
$FmtDateMixedCaseNames Exibe nomes de meses em maiúsculas e minúsculas misturadas (por exemplo, Fevereiro).
Nota: Este é o padrão para todos os locales.
$FmtDateISOFormat Exibe o formato de data internacional ISO (aaaammdd). Este é intencionado para uso quando um aplicativo ou banco de dados simples é compartilhado pelos usuários a partir de múltiplos locales internacionais.
$FmtDateAllCapsNames Exibe nomes de meses tudo em letras maiúsculas (por exemplo, FEBRUARY).

Ordem do Formato de Mês, Dia e Ano

Constante Descrição
$FmtDateDayMonthYear Ordena subcampos na data primeiro com o dia, seguido de mês ano (por exemplo, 31/1/1999).
$FmtDateMonthDayYear Ordena subcampos na data primeiro com o mês, seguido de dia e ano (por exemplo 1/31/1999).
$FmtDateYearMonthDay Ordena subcampos na data primeiro com o ano, seguido de mês dia (por exemplo, 1999/1/31).

Formato de Centena

Constante Descrição
$FmtDateFullYear Exibe o ano todo incluindo a parte de centena de uma data (por exemplo, 1999/1/31).
$FmtDateTruncateCentury Suprime a exibição da parte de centena de uma data (por exemplo 4/22/99).


Nota: Nenhum padrão é indicado para o formato de centena, porque o padrão de centena depende do locale da estação de trabalho atual. O locale descreve o contexto cultural da estação de trabalho, que é mais do que o país; por exemplo, Canadense versus Canadense da França é um contexto cultural. O contexto cultural também é mais do que o idioma; por exemplo, Francês como falado no Canadá versus Francês como falado na Suíça.

No OS/2, as datas não incluem as centenas. Para incluir a centena em uma data no OS/2, utilize um comando DateFormat.

Formato do Mês

Constante Descrição
$FmtDateNumericMonth Exibe os meses como números (por exemplo 2/14/1999).
$FmtDateNamedMonth Exibe os nomes de meses no idioma do país selecionado atualmente (por exemplo, 11 de Fevereiro de 1999 ).

Formato do Comprimento do Nome

Constante Descrição
$FmtDateLongNames Exibe a forma longa de nomes de meses (por exemplo, Fevereiro).
$FmtDateShortNames Exibe a forma curta (abreviada) de nomes de meses (por exemplo, Fev).

Formato Separador

Constante Descrição
$FmtDateDotSeparators Separa meses, dias e anos em datas com pontos (por exemplo, 13.2.1999).
$FmtDateSlashSeparators Separa meses, dias e anos em datas com barras (por exemplo, 13/2/1999).
$FmtDateDashSeparators Separa meses, dias e anos em datas com traços (por exemplo, 13-2-1999).

Preenchimento

Constante Descrição
$FmtZeroPad Força alinhamento exibindo dois dígitos por posições de dia e mês (por exemplo, 07/02/1999).

Dica: O sinalizador de formato especial $FmtDateNLSDefault pode ser utilizado para indicar o formato de data padrão para o locale selecionado atualmente.

Sinalizadores de Formato de Número Inteiro

As constantes a seguir convertem um valor de número inteiro para uma cadeia em um dos formatos a seguir.
Dica: Para cada uma das categorias de formato a seguir, o sinalizador dos Estados Unidos padrão está em itálico.

Formato de Número Inteiro

Constante Descrição
$FmtIntDecimal Exibe números inteiros na forma decimal (base 10).
$FmtIntHexadecimal Exibe números inteiros na forma hexadecimal (base 16).

Formato de Agrupamento de Número Inteiro

Constante Descrição
$FmtIntUngrouped Exibe números inteiros sem delimitadores entre milhares de grupos (por exemplo, 1234567).
$FmtIntGroupedWithBlank Exibe números inteiros com milhares de grupos delimitados em bracos (por exemplo, 1 234 567).
$FmtIntGroupedWithComma Exibe números inteiros com milhares de grupos delimitados por vírgulas (por exemplo, 1,234,567).
$FmtIntGroupedWithDot Exibe números inteiros com milhares de grupos delimitados por pontos (por exemplo, 1.234.567).

Formato Assinado

Constante Descrição
$FmtIntSignNegOnly Faz com que os valores de número inteiro negativo sejam antecedidos por um sinal de menos. Entretanto, um sinal de menos é suprimido no caso de valores positivos.
$FmtIntSigned Exibe um sinal de mais ou de menos para todos os valores de números inteiros.

Preenchimento

Constante Descrição
$FmtZeroPad Exibe zeros à esquerda para os valores de número inteiro de um dígito (por exemplo, 09) e preenche todos os dígitos vazios em uma cadeia

Sinalizadores de Formato de Cadeia

As constantes a seguir convertem um valor de cadeia para um dos formatos a seguir.
Dica: Os sinalizadores de estilo padrão dos Estados Unidos estão em itálico.

Esta constante... converte o valor da cadeia para este formato...
$FmtLeftJustify para a posição justificada à esquerda dentro do campo de saída.
$FmtRightJustify para a posição justificada à direita dentro do campo de saída.
$FmtBlankPad para uma posição preenchida com espaços dentro do campo de saída. (Este é o mesmo que $FmtNoPad.)
$FmtNoPad para uma posição preenchida com espaços dentro do campo de saída. (Este é o mesmo que $FmtBlankPad.)
$FmtZeroPad para a posição preenchida com zeros dentro do campo de saída.

Número Para Formatos Reais

As constantes a seguir convertem um valor de número real para uma cadeia em um dos formatos a seguir.
Dica: Os sinalizadores de estilo padrão dos Estados Unidos estão em itálico.

Formato Assinado

Constante Descrição
$FmtRealSignNegOnly Suprime a exibição de um sinal de mais para números reais que não sejam negativos. (Somente números reais negativos são assinados.)
$FmtRealSigned Exibe um sinal de mais ou de menos para todos os valores reais. (Todos os números reais são assinados.)

Formato Decimal

Constante Descrição
$FmtRealDecimalDot Exibe o ponto decimal em números reais, utilizando um ponto (por exemplo, 3.14159).
$FmtRealDecimalComma Exibe o ponto decimal em números reais utilizando uma vírgula (por exemplo, 3,14159).

Formato de Agrupamento

Constante Descrição
$FmtRealGroupedWithBlank Exibe números reais com milhares de grupos delimitados em branco (por exemplo, 1 234 567.00).
$FmtRealGroupedWithComma Exibe números reais com milhares de grupos delimitados por vírgulas (por exemplo, 1,234,567,000).
$FmtRealGroupedWithDot Exibe números reais com milhares de grupos delimitados por pontos (por exemplo, 1.234.567.000).
$FmtRealUngrouped Exibe números reais sem separadores entre milhares de grupos (por exemplo, 1234567.00).

Preenchimento

Constante Descrição
$FmtZeroPad Exibe zeros à esquerda para os valores de número inteiro de um dígito (por exemplo, 09) e preenche todos os dígitos vazios em uma cadeia


Dica: O especificador de formato para números reais também pode codificar o número de dígitos exibidos à direita da colocação decimal. Por exemplo

 WinWrite ($Handle, r:10: BitOr (2,$FmtLeftJustify));

esquerda justifica a saída e exibe dois dígitos à direita do decimal. Por padrão, os números reais exibem seis dígitos à direita do ponto decimal.

Dica: Você pode combinar uma constante $FmtRealGroupedWithDot com um $FmtRealDecimalComma para atingir o resultado 1.234,567.

Sinalizadores de Formato de Hora

As constantes a seguir convertem um valor de hora para uma cadeia em um dos formatos a seguir.
Dica: Os sinalizadores padrão dos Estados Unidos estão em itálico.

Esta constante... converte um valor de hora em uma cadeia que...
$FmtTimeAMPM exibe a forma de 12 horas AM ou PM (por exemplo, 6:45 PM).
$FmtTimeColonSeparators delimita horas, minutos e segundos com dois pontos. Este é o formato padrão utilizado para converter uma hora para ma cadeia (por exemplo, 12:35:06).
$FmtTimeDotSeparators delimita horas, minutos e segundos com pontos (por exemplo, 12.15.34).
$FmtTimeMilitary exibe a hora na forma militar em 24 horas (por exemplo, 18:35:17).
$FmtTimeWithoutSeconds exclui segundos ao exibir valores de hora.
$FmtTimeWithSeconds inclui segundos ao exibir valores de hora.
$FmtZeroPad força o alinhamento exibindo dois dígitos para cada parte da hora (por exemplo, 02:09:37).

Sinalizadores de Estilo de Fonte

Estes sinalizadores de estilo são utilizados com WinCreateScrollWindow e WinSetFont. Os estilos podem ser combinados.

Este sinalizador de estilo... torna o estilo de fonte...
$FontBold negrito.
$FontItalic itálico.
$FontPlain simples (normal).
$FontStrikeout riscado.
$FontUnderscore sublinhado.

Sinalizadores de Status do DDE

Um sinalizador de status do DDE comunica os resultados de ações solicitadas pelo cliente para um servidor. A seguir encontram-se os sinalizadores de status do DDE para o OS/2, alguns dos quais não possuem equivalente exato no Windows.

Este sinalizador de status... possui este efeito no OS/2...
DDEAck O pedido é aceito.
Nota: Este sinalizador é o mesmo no Windows.
DDEAcknowledgeReq Uma confirmação é solicitada.
DDEAppStatus Esta é uma máscara de bits que, ao utilizar (o operador Booleano) AND com a palavra de status, revela a parte de aplicativo do status.
DDEBusy O aplicativo está ocupado.
DDENoData Não existem dados para o tópico solicitado.
DDENotProcessed A mensagem não é entendida.
DDEResponse Os dados são enviados em resposta a um DDERequest.

Pesquisa de Arquivo Utilizando SAIPATH

Quando o TSD Script procura objetos como arquivos .kbc (analisador), arquivos .dfc (sistema da caixa de diálogo) ou arquivos .ico (controles de hipermídia), ele utiliza a seguinte estratégia de pesquisa e seqüência para encontrá-los:

  1. Se o arquivo tiver um diretório explícito especificado, este diretório é a única colocação pesquisada.
  2. Pesquisa os diretórios explicitamente especificados na linha de comandos.
  3. Pesquisa o diretório de trabalho atual.
  4. Pesquisa o diretório onde o kml.exe está localizado, onde xx representa os dois últimos dígitos do número da versão do release do Developer's Toolkit.
  5. Pesquisa os diretórios especificados na variável de ambiente SAIPATH.
  6. (Somente OS/2) Pesquisa os diretórios especificados na variável de ambiente DPATH.
  7. Pesquisa os diretórios especificados na variável de ambiente PATH.

Se o arquivo não puder ser encontrado utilizando esta estratégia, a ferramenta retornará uma mensagem de erro que indicará que o arquivo não foi encontrado.


Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Retornar à Página Principal

Copyright