Gráfico

Este objecto permite produzir um gráfico. Está disponível nos Ecrãs Personalizados e nos Painéis de Informação mas só se possuir as gamas Advanced e Enterprise.
Quando se introduz um objecto destes numa página de utilizador ou num painel de informação o mesmo deve ser formatado através das seguintes propriedades:

Acesso
Esta propriedade permite definir acessos de consulta, alteração e introdução para os utilizadores, relativamente ao objecto em questão. Os acessos disponíveis são:

Sem controlo de acessos

Acesso privado para um utilizador

Acesso X à tabela Y

Acesso por tipo de perfil

Expressão TSQL
Esta propriedade só está disponível nos Painéis de Informação se possuir a gama Advanced ou Enterprise.
Esta propriedade permite definir uma expressão tsql de modo a criar um cursor para ser utilizado como base para a produção do gráfico ou para ser transformado na propriedade "Expressão XBASE".
Exemplo: Select st.ref,st.Stock,(st.stock+st.qttfor-st.qttcli) as 'Stock_Previsto' from st (nolock) where st.ref >= 'art0001' and st.ref <='art0009' order by st.ref

Expressão XBASE
Esta propriedade permite definir uma expressão xbase de modo a transformar ainda mais o cursor criado na propriedade descrita acima, ou para criar ela o cursor que irá servir de base para a produção do gráfico, podendo assim deixar-se a propriedade "Expressão TSQL" em branco.

Estes últimos dois campos de programação têm uma funcionalidade que permite a procura rápida e introdução directa de nomes de campos.
Para tal, é necessário, com um clique direito sobre o campo, seleccionar a opção Introduzir Campos de Tabelas.

Nota: Esta funcionalidade está disponível nas três gamas: PHC Corporate CS, PHC Advanced CS e PHC Enterprise CS, caso o número de instalação já exista.
Se for uma instalação nova, a partir da versão 17, esta funcionalidade existe nas gamas PHC Advanced CS, apenas com o PHC On ativo, e na gama PHC Enterprise CS, com ou sem PHC On ativo.

Ordenadas (Y)
Nesta propriedade definem-se quais as colunas do cursor que irão servir de base para construir os dados correspondentes ao eixo das ordenadas do gráfico.
Exemplo: Stock;Stock_Previsto

Ordenadas (Y) (Títulos)
Esta propriedade define os títulos a usar no eixo das ordenadas.
Exemplo: Stock Real;Stock Previsto

Abcissas (X)
Esta propriedade define qual a coluna do cursor que irá servir para o eixo das abcissas do gráfico.
Exemplo: ref

Tipo Gráfico
Nesta propriedade define-se qual o tipo de gráfico que se deseja visualizar, podendo ser de barras, de linhas, etc.

Título
Nesta propriedade define-se qual o nome do gráfico.

Nome do Cursor
Caso o cursor que se cria para servir de base à construção do gráfico, seja criado na propriedade "Expressão XBASE" e não na propriedade "Expressão TSQL", então deve-se escrever o nome desse cursor nesta propriedade.

Barra de Controlo
Permite ao utilizador definir se a barra de controlo do objecto está visível, ou seja, se os botões que aparecem por debaixo do gráfico, inverter séries e reset estão visíveis ao utilizador. Se definir o valor "0 - Não", torna-se possivel redefinir a dimensão do objecto para valores inferiores ao tamanho pré-definido pela aplicação.

Previsão Gráfico
Permite ao utilizador definir a configuração de visualização genérica deste objecto para todos os utilizadores. Podendo assim à medida que for fazendo alterações ao gráfico poder de imediato, sem sair do desenho do ecrã, visualizar como vai ficar o gráfico ao utilizador final.

Evento Duplo Clique (Só Enterprise)
Este evento ocorre quando se faz duplo clique no gráfico. A partir daqui é executado o código que estiver definido no evento. Este evento disponibiliza as seguintes variáveis:
1 - Coordenada (X) do canto superior esquerdo do gráfico
2 - Coordenada (Y) do canto superior esquerdo do gráfico
3 - Série seleccionada ( Numérico: 0 = 1ª série ; -1 = Nenhuma série )
4 - Dados da série seleccionada ( Numérico: -1 = Nenhuns dados )
5 - Resultado do processamento ( Numérico: 0 = Continuar ; 1 = Parar )

Para consultar estas variáveis deve clicar no botão de referências.

NOTA: Para o objecto não executar após o código do utilizador o seu código por default, a variável: 5 (resultado do processamento) deve ser igualada a 1.

As restantes propriedades deste objecto são (atenção que os eventos só existem em Enterprise):
Altera a Sua Altura
Altera o Seu Comprimento
Altera a sua Esquerda
Altera o seu Topo
Altura
Comprimento
Esquerda
Estilo do Contorno
Evento Init
Evento MouseEnter
Evento MouseLeave
Evento MouseMove
Evento MouseWheel
Ordem (Z)
Topo
Visível



No ecrã de visualização do gráfico, podem efectuar-se alterações quanto ao seu modo de visualização. Podem por exemplo ser alterados o tipo de gráfico (barras, linhas, circular...), a cor de fundo do gráfico, o título, etc.

No ecrã de visualização do gráfico (quer em Páginas do Utilizador quer em Painéis de Informação), o botão Reset anula todas as alterações efectuadas neste mesmo ecrã (por exemplo: títulos, cores, etc).
Por exemplo:
Se no desenho do gráfico, estiver definido que o gráfico utilizado é do tipo "Bar", então mesmo que se altere o tipo de gráfico no ecrã de visualização, ao clicar em refresh, o gráfico será apresentado de acordo com o tipo de gráfico definido no Desenho.