4D Widgets Componentes 4D Widgets DatePicker SearchPicker TimePicker Lista alfabética dos comandos - 1 -
Componentes 4D Widgets Os widgets 4D são funcionalidades oferecidas como componentes, acessíveis desde o editor de formulários e a livraria de objetos configurados. Estes widgets são objetos compostos com características predefinidas que facilitam o acesso as funcionalidades padrão e são muito simples de implementar. Três widgets estão disponíveis: SearchPicker: Área de pesquisa de aparência padrão. DatePicker: seletor de data. TimePicker: seletor de hora. Estes widgets podem ser utilizados com ou sem programação. Podem simplesmente integrados em seus formulários e utilizar suas propriedades por padrão. Se quer controlar e configurar eles de uma forma mais personalizada, pode fazer uso dos métodos projeto específicos, chamados "Métodos componente", listados por componente na página Métodos do Explorador: Esta documentação cobre cada widget e descreve a sintaxes dos métodos componente associados a ele. Agregar um widget Há duas formas de inserir uma área de widget em um formulário: Utilizar a livraria de objetos Utilizar um subformulário Via a livraria de objetos Para inserir um widget via a livraria de objetos: 1. Selecione o comando Livraria de objetos no menu Desenho. Aparece a janela da livraria de objetos. 2. Selecione Widgets no menu Categorias. Se listam os widgets disponíveis: - 2 -
3. Insira o widget desejado em seu formulário por arrastar e soltar. Depois pode configurar sob as propriedades do objeto inserido ou sob seu método objeto. Via um subformulário Para criar um widget via um objeto de tipo subformulário: 1. No editor de formulários, agregue um objeto subformulário. Este ponto se descreve no manual de Desenho 4D. 2. Na lista de propriedades, faça clique no menu "Formulário detalhado" com o fim de mostrar a lista de formulários utilizáveis. Esta lista inclui os widgets. 3. Selecione o widget a inserir. Depois pode configurar sob as propriedades do objeto ou o método objeto do subformulário. - 3 -
DatePicker DatePicker e DateEntry DatePicker APPLY DEFAULT VALUES DatePicker Display Dialog DatePicker RESET DEFAULT VALUES DatePicker SET DAYS OFF DatePicker SET DEFAULT 1ST DAY DatePicker SET DEFAULT DAYS OFF DatePicker SET DEFAULT MAX DATE DatePicker SET DEFAULT MIN DATE DatePicker SET MAX DATE DatePicker SET MIN DATE DatePicker SET WEEK FIRST DAY - 4 -
DatePicker e DateEntry O widget DatePicker é um objeto intuitivo e fácil de usar que pode utilizar para tirar o maior proveito dos campos que requerem a entrada de datas ou simplesmente representar uma data. Este widget se apresenta de duas formas: Calendário DatePicker: Este objeto pode ser usado em um subformulário, ou como um calendário abaixo que aparece ao fazer clique em um botão. Área DateEntry: Área de data associada aos botões de controle. Este objeto só pode ser utilizado em um subformulário. Calendário DatePicker Um calendário DatePicker é uma área de visualização de cada mês como uma tabela de dias. Durante a execução, o usuário pode se deslocar pelos meses do calendário para frente e para trás fazendo clique nos botões em forma de flecha. Também pode utilizar as teclas de flecha do teclado. Quando é inserido em um subformulário, um objeto DatePicker pode ser utilizado sem programação graças ao mecanismo previsto pela variável associada: pode ser trabalhado com o valor da variável associada ao objeto subformulário (propriedade "Nome da variável" na Lista de propriedades) com o fim de gerenciar a visualização e a entrada. Quando o formulário se executa, esta variável contém automaticamente a data selecionada pelo usuário. Pelo contrário, se modifica o valor desta variável por programação, será mostrada automaticamente no subformulário. No entanto, se deseja personalizar o funcionamento do DatePicker ou mostrar ele como um menu pop up, deve utilizar o conjunto de métodos componente. Uso em subformulário Pode inserir um calendário DatePicker em um formulário de duas formas: Inserindo um objeto "Date Picker" desde a livraria de objetos pré configurados de 4D Criando uma área de sub formulário e atribuindo o formulário detalhado DatePicker. Pode administrar esta área sem programação através do mecanismo da variável associada (ver acima). Uso em um pop-up Pode usar um calendário DatePicker como janela pop up. Para isso, pode: Inserir um objeto "Pop up date" da livraria de objetos pré configurados, Criar um subformulário e associar ele ao formulário detalhado DateButton, Em ambos casos, pode lidar sua visualização e entrada associando uma variável data ao objeto. Criar um objeto que chame ao método componente DatePicker Display Dialog. Este método devolve a data selecionada pelo usuário. Área DateEntry Uma área de tipo DateEntry facilita introduzir uma data na forma definida nas preferências do sistema (por exemplo, DD/MM/AA). A área se apresenta em forma de uma data associada aos botões: - 5 -
Durante a execução, os botões situados a direita da área de entrada só são mostrados quando o objeto tem o foco. O usuário seleciona cada elemento da data (dia, mês ou ano) de forma individual fazendo clique ou pressionando a tecla Tab e pode ser deslocado utilizando o passo a passo numérico ou as teclas de flecha do teclado. O ícone de calendário localizado a direita pode ser utilizado para selecionar uma data por intermédio de um calendário pop up DatePicker. Um objeto DateEntry pode ser utilizado sem programação graças ao mecanismo oferecido pela variável associada (ver o parágrafo "Calendário DatePicker"). No entanto, se deseja personalizar o funcionamento, pode utilizar o conjunto de métodos componente que se oferece. Estes métodos são os mesmos que os do objeto DatePicker. Uso em um subformulário Pode inserir uma área DateEntry em um formulário de duas formas: Inserindo um objeto "área DateEntry" da livraria de objetos pré configurados de 4D. Criando uma área de subformulário e atribuindo ela ao formulário detalhado DateEntry. - 6 -
DatePicker APPLY DEFAULT VALUES DatePicker APPLY DEFAULT VALUES ( nomobjeto ) Parâmetro Tipo nomobjeto Texto Nome do objeto subformulário O comando DatePicker APPLY DEFAULT VALUES permite restabelecer todos os parâmetros DatePicker a seus valores por padrão para o objeto de subformulário nomobjeto. Estes valores por padrão podem ser a configuração de fábrica, mas também podem ter sido modificados via os comandos SET DEFAULT do componente. A ação deste comando é imediata: os valores por padrão de nomobjeto se modificam imediatamente. Tenha em conta que a variável associada ao objeto poderia ser modificada para ter em conta os novos valores. Por exemplo, se os novos valores por padrão fixam a data mínima em 01/01/2000 e a variável associada a nomobjeto é 05/05/1995, seu valor retorna automaticamente em 01/01/2000. Os parâmetros DatePicker incluem: As datas editável mínima ou máxima O primeiro dia da semana Não figuram "dias livres" ou feriados específicos. Exemplo Este exemplo reinicializa os parâmetros do objeto Data1 a seus parâmetros por padrão: DatePicker APPLY DEFAULT VALUES("Data1") - 7 -
DatePicker Display Dialog DatePicker Display Dialog {( esquerda ; superior {; dataporpadrao})} -> Resultado Parâmetro Tipo esquerda Inteiro longo Localização do lado esquerdo da janela superior Inteiro longo Localização da parte superior da janela dataporpadrao Data Data a pré selecionar no calendário Resultado Data Data selecionada pelo usuário O comando DatePicker Display Dialog abre um calendário DatePicker em uma janela pop-up (uma janela de tipo pop-up se fecha automaticamente quando o usuário faz clique fora da janela ou pressiona a tecla Intro ou Esc). Os dois parâmetros opcionais esquerda e superior permitem definir a localização da esquina superior esquerda da janela a abrir. Estes dois parâmetros se devem passar juntos, se somente passar um, se ignora. Se estes parâmetros se omitem, a janela se abre no lugar do clique. Pode passar uma data no parâmetro dataporpadrao para mostrar o calendário DatePicker com uma data pré selecionada. DatePicker Display Dialog devolve a data selecionada pelo usuário no calendário DatePicker. Se a janela está fechada, sem que uma data tenha sido selecionada, o comando devolve uma data vazia (!00/00/00!), inclusive se passar uma data em dataporpadrao. Exemplo Este exemplo mostra um calendário DatePicker quando é feito clique em um botão: OBJECT GET COORDINATES(*;"MeuBotaoCalendario";$x1;$y1;$x2;$y2) $MinhaDataLocal:=DatePicker Display Dialog($x1;$y1) If($MinhaDataLocal #!00/00/00!) [Event]DateRV:=$MinhaDataLocal End if - 8 -
DatePicker RESET DEFAULT VALUES DatePicker RESET DEFAULT VALUES Este comando não requer parâmetros O comando DatePicker RESET DEFAULT VALUES restabelece os parâmetros do componente DatePicker a seus "ajustes de fábrica". Depois de executar este método componente: As datas editáveis mínimas ou máximas 00/00/00 (ou seja, não há limites) O primeiro dia da semana é 2 (segunda) Os "dias livres" são o sábado e o domingo Não figuram "dias livres" ou feriados específicos. Tenha em consideração que esta configuração só leva em conta os calendários criados posteriormente e não aplica aos calendários existentes. Se deseja aplicá-lo a calendários existentes, deve utilizar o comando DatePicker APPLY DEFAULT VALUES. - 9 -
DatePicker SET DAYS OFF DatePicker SET DAYS OFF ( nomeobjeto {; tipodia ; ptrarraydiasferi} ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário tipodia Inteiro longo Tipos de dias feriados ptrarraydiasferi Ponteiro Ponteiro ao array data ou booleano dos dias de feriados O comando DatePicker SET DAYS OFF permite definir os dias de descanso que aparecerão no calendário DatePicker. Estes dias se mostram em negrito e cursiva e seguem sendo selecionáveis para o usuário. O parâmetro nomobjeto especifica a instância do subformulário a que se aplica o comando. Neste parâmetro, deve passar o nome de um objeto subformulário mostrado no formulário atual. Este comando permite definir dias de descanso recorrentes semanais ou anuais, assim também como ocasionais. Especifique o tipo de dia de descanso definido pelo parâmetro tipodia: 0 = dias de descanso semanais (por padrão, sábado e domingo) 1 = dias de descanso cada ano (por exemplo, 1 de janeiro ou 25 de dezembro) 2 = dias feriados ocasionais, definidos para um só ano Define os dias de descanso criando um array e passando un ponteiro a este array como parâmetro ptrarraydiasferi. O tipo de array depende do valor que se passa em tipodia: Se passar 0 em tipodia (dias de descanso semanal), deve passar em ptrarraydiasferi um ponteiro a um array booleano composto por 7 elementos. Cada elemento True indica um dia de descanso semanal. Se passar 1 ou 2 em tipodia (dias de descanso anuais ou ocasionais), em ptrarraydiasferi deve passar um ponteiro a um array data. Neste array, cada elemento deve conter uma data válida, indicando um dia livre. Nesta matriz, cada elemento deve conter uma data válida, o que indica um dia livre. Se passar 1 em tipodia (dias recorrentes), o ano se ignora, pode passar qualquer valor. Exemplo 1 Designação da sexta como o dia de descanso (no lugar de sábado ou domingo por padrão): ARRAY BOOLEAN($arrbDiasFeri;7) //Por padrão, todos os elementos de um array booleano são False; portanto não é necessário adicionar o código de inicialização $arrbdiasferi{friday}:=true DatePicker SET DAYS OFF("meucalendario";0;->$arrbDiasFeri) Exemplo 2 Designação de dias de feriados pontuais: ARRAY DATE($arrdUniqueDays;0) //Se leva em conta o ano APPEND TO ARRAY($arrdUniqueDays;!02/15/2008!) APPEND TO ARRAY($arrdUniqueDays;!02/12/2009!) - 10 -
APPEND TO ARRAY($arrdUniqueDays;!02/17/2010!) DatePicker SET DAYS OFF(1;->$arrdUniqueDays) - 11 -
DatePicker SET DEFAULT 1ST DAY DatePicker SET DEFAULT 1ST DAY ( numdia ) Parâmetro Tipo numdia Inteiro longo Número do primeiro dia a mostrar O comando DatePicker SET DEFAULT 1ST DAY permite definir o primeiro dia da semana a mostrar por padrão na parte esquerda de todos os calendários DatePicker. No parâmetro numdia, passe uma das seguintes constantes 4D do tema Dias e meses: Constante Tipo Valor Sunday Inteiro longo 1 Monday Inteiro longo 2 Tuesday Inteiro longo 3 Wednesday Inteiro longo 4 Thursday Inteiro longo 5 Friday Inteiro longo 6 Saturday Inteiro longo 7 Note que este parâmetro só é levado em conta para os calendários criados posteriormente e não aplica aos calendários existentes. Se quer aplicá-lo a calendários existentes, deve utilizar o comando DatePicker APPLY DEFAULT VALUES. - 12 -
DatePicker SET DEFAULT DAYS OFF DatePicker SET DEFAULT DAYS OFF ( tipodia ; ptrarraydiasferi ) Parâmetro Tipo tipodia Inteiro longo Tipos de dias de feriados ptrarraydiasferi Ponteiro Ponteiro ao array data ou booleano dos dias de feriados O comando DatePicker SET DEFAULT DAYS OFF permite definir os dias de descanso que aparecerão em todos os calendários do componente DatePicker. Estes dias se mostram em negrito e cursiva e seguem sendo selecionáveis para o usuário. Tenha em consideração que este parâmetro só é levado em conta para os calendários que são criados posteriormente e não aplica aos calendários existentes. Se deseja aplicar aos calendários existentes, terá que utilizar o DatePicker APPLY DEFAULT VALUES. O comando pode ser usado para fixar dias de descanso recorrentes semanais ou anuais, assim também como ocasionais. Especifique o tipo de dia de descanso definido pelo método via o parâmetro tipodia: 0 = dias de descanso semanais (por padrão, sábado e domingo) 1 = dias de descanso cada ano (por exemplo, 1 de janeiro ou 25 de dezembro) 2 = férias ocasionais, definidos para um só ano Define os dias de descanso criando um array e passando un ponteiro a este array como parâmetro ptrarraydiasferi. O tipo de array depende do valor que se passa em tipodia: Se passar 0 em tipodia (dias de descanso semanal), deve passar em ptrarraydiasferi um ponteiro a um array booleano composto por 7 elementos. Cada elemento True indica um dia de descanso semanal. Se passar 1 ou 2 em tipodia (dias de descanso anuais ou ocasionais), em ptrarraydiasferi deve passar um ponteiro a um array data. Neste array, cada elemento deve conter uma data válida, indicando um dia livre. Nesta matriz, cada elemento deve conter uma data válida, o que indica um dia livre. Se passar 1 em tipodia (dias recorrentes), o ano se ignora, pode passar qualquer valor. Exemplo Designação dos dias de feriados recorrentes (exemplo válido para USA): ARRAY DATE($arrdRepeatedDays;0) //O ano é ignorado; utilizamos 2000 APPEND TO ARRAY($arrdRepeatedDays;!01/01/2000!) APPEND TO ARRAY($arrdRepeatedDays;!02/02/2000!) APPEND TO ARRAY($arrdRepeatedDays;!02/14/2000!) APPEND TO ARRAY($arrdRepeatedDays;!03/17/2000!) APPEND TO ARRAY($arrdRepeatedDays;!04/01/2000!) APPEND TO ARRAY($arrdRepeatedDays;!10/31/2000!) APPEND TO ARRAY($arrdRepeatedDays;!11/11/2000!) APPEND TO ARRAY($arrdRepeatedDays;!12/25/2000!) DatePicker SET DEFAULT DAYS OFF(1;->$arrdRepeatedDays) - 13 -
DatePicker SET DEFAULT MAX DATE DatePicker SET DEFAULT MAX DATE ( datamax ) Parâmetro Tipo datamax Data Limite superior de data editável O comando DatePicker SET DEFAULT MAX DATE permite definir a data editável máxima para todos os calendários do componente DatePicker. Note que este parâmetro só é levado em consideração para os calendários criados posteriormente e não se aplica aos calendários existentes. Se deseja aplicar ele a calendários existentes, deve utilizar o comando DatePicker APPLY DEFAULT VALUES. - 14 -
DatePicker SET DEFAULT MIN DATE DatePicker SET DEFAULT MIN DATE ( datamin ) Parâmetro Tipo datamin Data Limite inferior de data editável O comando DatePicker SET DEFAULT MIN DATE permite definir a data editável mínima para todos os calendários do componente DatePicker. Note que este parâmetro só é levado em conta para os calendários criados posteriormente e não se aplica aos calendários existentes. Se deseja aplicar a calendários existentes, deve utilizar o comando DatePicker APPLY DEFAULT VALUES. Exemplo Designação da data mínima ao primeiro de janeiro de 2000: DatePicker SET DEFAULT MIN DATE(!01/01/2000!) - 15 -
DatePicker SET MAX DATE DatePicker SET MAX DATE ( nomeobjeto ; datamax ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário datamax Data Limite superior de data editável O comando DatePicker SET MAX DATE permite definir a data máxima editável no calendário DatePicker (os dias depois desta data máxima aparecem como não disponíveis no calendário). O parâmetro nomeobjeto especifica a instância do subformulário ao que se aplica o comando. Neste parâmetro, deve passar o nome de um objeto subformulário mostrado no formulário atual. A data datamax deve ser expressada no formato de entrada por padrão correspondente ao idioma do sistema. Se passar uma data vazia (!00/00/00!), todas as datas que seguem a data atual são editáveis. Se a data editável máxima é anterior a data editável mínima (ver DatePicker SET MIN DATE), nenhuma data será editável. Exemplo Desativação de todas as datas depois do 31 de dezembro de 2009 no objeto chamado "ReturnDate": DatePicker SET MAX DATE("ReturnDate";!12/31/2009!) - 16 -
DatePicker SET MIN DATE DatePicker SET MIN DATE ( nomeobjeto ; datamin ) Parâmetro Tipo nomeobjeto Texto Nome do objeto subformulário datamin Data Limite inferior de data editável O comando DatePicker SET MIN DATE permite definir a data editável mínima em um calendário DatePicker (os dias anteriores a esta data mínima aparecem como não disponíveis no calendário). O parâmetro nomeobjeto especifica a instância do subformulário ao que se aplica o comando. Neste parâmetro, deve passar o nome de um objeto subformulário mostrado no formulário atual. A data datamin deve ser expressada no formato de entrada por padrão correspondente ao idioma do sistema. Se passar uma data vazia ( 00/00/00!), todas as datas anteriores a data atual serão editáveis. Se a data editável mínima é posterior a data editável máxima (ver DatePicker SET MAX DATE), sem data será editável. Exemplo O formulário atual contém dois calendários DatePicker localizados em dois objetos subformulários chamados "DP1" e "DP2". //Desativação de todas as datas antes de primeiro de janeiro de 2009 no primeiro calendário DatePicker SET MIN DATE("DP1";!01/01/2009!) //Desativação de todas as datas antes do primeiro de março de 2009 no segundo calendário DatePicker SET MIN DATE("DP2";!03/01/2009!) - 17 -
DatePicker SET WEEK FIRST DAY DatePicker SET WEEK FIRST DAY ( nomeobjeto ; numdia ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário numdia Inteiro longo Número do primeiro dia a mostrar O comando DatePicker SET WEEK FIRST DAY permite designar o primeiro dia da semana a mostrar na parte esquerda de um calendário DatePicker. Por padrão, o primeiro dia é segunda. O parâmetro nomeobjeto especifica a instância do subformulário a que se aplica o comando. Neste parâmetro, deve passar o nome de um objeto subformulário mostrado no formulário atual. Passe no parâmetro numdia uma das seguintes constantes 4D do tema Dias e meses: Constante Tipo Valor Sunday Inteiro longo 1 Monday Inteiro longo 2 Tuesday Inteiro longo 3 Wednesday Inteiro longo 4 Thursday Inteiro longo 5 Friday Inteiro longo 6 Saturday Inteiro longo 7 Exemplo 1 Configurando o primeiro dia como o domingo: DatePicker SET WEEK FIRST DAY("meucalendario";Sunday) Exemplo 2 Configurando o primeiro dia como quinta: DatePicker SET WEEK FIRST DAY("meucalendario";Thursday) - 18 -
SearchPicker Apresentação SearchPicker SET HELP TEXT - 19 -
Apresentação O widget SearchPicker, permite criar facilmente as áreas estandarte de pesquisa, similares as encontradas nos navegadores ou barras de ferramentas. A aparência da área depende da plataforma. Windows: Mac OS: O texto que se mostra por padrão na área pode ser controlado por programação, utilizando o método componente SearchPicker SET HELP TEXT. Funcionamento Além de sua aparência, uma área de pesquisa SearchPicker se caracteriza pelos seguintes elementos: texto em cinza, uma área de entrada e um ícone de eliminação. A área de entrada é onde o usuário introduz o valor a buscar. Este valor é atribuído automática e dinamicamente a variável associada a área na lista de propriedades (propriedade "Nome de variável"). Utilize esta variável para proporcionar o valor buscado ao método de pesquisa. O texto cinza é uma ajuda que indica ao usuário ele ou o(s) campo(s) onde se realizaram a pesquisa. Desaparece tão rápido como a área teme o foco. Este texto pode ser definido via o comando SearchPicker SET HELP TEXT. O botão de eliminação permite apagar o conteúdo da área. Seu funcionamento é automático. Durante a execução, pode iniciar seu método de pesquisa fazendo clique no botão ou em um evento formulário. A área gera de forma concreta os eventos On Data Change e On Losing Focus. Pode oferecer uma pesquisa dinâmica que seja reavaliada cada vez que o usuário introduz outro caractere mediante uma chamada ao método de pesquisa no evento On Data Change. Criação Pode inserir uma área SearchPicker de duas formas: Inserindo um objeto "SearchPicker" da livraria de objetos pré configurados de 4D (tema "áreas de entrada"). Criando uma área de subformulário e atribuindo ao formulário detalhado SearchPicker. A continuação, especifique o nome da variável associada ao subformulário (propriedade "Nome da variável" na Lista de propriedades). Quando o formulário se executa, esta variável conterá automaticamente o valor buscado pelo usuário. A continuação, pode passar este valor a seu método de pesquisa personalizado. - 20 -
SearchPicker SET HELP TEXT SearchPicker SET HELP TEXT ( nomeobjeto ; textoajuda ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário textoajuda Texto Texto a mostrar O comando SearchPicker SET HELP TEXT permite mostrar um texto cinza não editável em primeiro plano da área de pesquisa designada por nomeobjeto. Este texto desaparece quando o usuário faz clique na área. Exemplo Mostrar a palavra "Country" na área, indicando que a pesquisa fará referencia a esta variável: SearchPicker SET HELP TEXT("vSearch";"Country") - 21 -
TimePicker TimePicker e TimeEntry TimePicker APPLY DEFAULT VALUES TimePicker DISPLAY SECOND HAND TimePicker LCD DISPLAY AMPM TimePicker LCD DISPLAY SECONDS TimePicker LCD SET COLOR TimePicker LCD SET MODE TimePicker RESET DEFAULT VALUES TimePicker SET DEFAULT LABEL AM TimePicker SET DEFAULT LABEL PM TimePicker SET DEFAULT MAX TIME TimePicker SET DEFAULT MIN TIME TimePicker SET DEFAULT STEP TimePicker SET LABEL AM TimePicker SET LABEL PM TimePicker SET MAX TIME TimePicker SET MIN TIME TimePicker SET STEP - 22 -
TimePicker e TimeEntry O widget TimePicker oferece objetos fáceis de usar que pode utilizar para aproveitar os campos que requerem a entrada ou mostrar horas. Podem ser utilizados das seguintes formas: Pop-up simples ou duplo: Área de entrada de horas em formato "hh:mm:ss" associadas com um passo a passo numérico que pode ser utilizado para aumentar ou diminuir o valor das horas, minutos ou segundos: Relógios (TimeDisplay) ou relógios digitais (TimeDisplayLCD): Além disso, cada tipo de TimePicker pode mostrar a hora em formato de 12 horas (AM-PM) ou 24 horas. Um objeto TimePicker pode ser utilizado sem programação graças ao mecanismo previsto pela variável associada. No entanto, se deseja personalizar o funcionamento dos objetos TimePicker, pode utilizar o conjunto de métodos componente que se oferece. Criação e uso Pode inserir uma área TimePicker em um formulário de duas formas: Mediante a inserção de um objeto "TimePicker" ou "TimeEntry" da livraria de objetos pré configurados de 4D. Com a criação de uma área de subformulário e atribuindo ao formulário detalhado TimePicker, TimeEntry ou TimeDisplayLCD de sua escolha. A continuação, especifique o nome da variável hora associada ao subformulário (propriedade "Nome de variável" na Lista de propriedades). Quando o formulário se executa, esta variável conterá automaticamente a hora definida pelo usuário. Pelo contrário, se modifica o valor desta variável pela programação, automaticamente serão mostrados no subformulário. Também pode optar por não nomear a variável com o propósito de se beneficiar do mecanismo das variáveis dinâmicas. Sobre relógios (novo em v14) Os widgets de relógio se desenham em SVG, e consequentemente tem um patrão em vetores permitindo assim deformações em modo Aplicação (em modo Desenho, seu tamanho se ajusta): Note que: Para um relógio estandarte, a segunda mão pode mostrar ou ocultar usando o método TimePicker DISPLAY SECOND HAND. Um relógio estandarte muda automaticamente a "modo dia" ou "modo noite" dependendo da hora: As faixas horárias são 8:00:00 -> 19:59:59 = Dia, 20:00 -> 07:59:59 = Noite. O widget "relógio digital" é transparente e não tem cor de fundo, assim que pode ser localizado sobre objetos de cor para modificar sua aparência: Há muitas opções para este widget disponíveis através dos métodos de componente os quais estão prefixados por - 23 -
"TimePicker LCD". Nota: Os desenvolvedores podem deslocar este relógio e substituir ele com suas próprias criações, trocando o arquivo "clock.svg" que se encontra no primeiro nível da pasta "Recursos". Mostrar a hora atual ou uma hora estática Os relógios podem mostrar a hora atual dinamicamente ou mostrar uma hora estática. Para mostrar a hora atual, associe a variável Real ao objeto subformulário do widget (operação por padrão). Neste caso, o widget mostra automaticamente a hora atual e funciona como um relógio. Você pode fazer uma compensação da hora: O valor numérico da variável indica a compensação em segundos. Por exemplo, 3600 = atrasar o relógio uma hora, -1800= adiantar o relógio 30 minutos, etc. Para mostrar uma hora estática, associe a variável Time ao objeto sub formulário do widget (usando o comando C_TIME ou a lista de propriedades). Então o relógio mostra o valor desta variável. Por exemplo, queremos que o relógio mostre 10:10:30: C_TIME(myvar) // myvar é o nome da variável do widget</p><p>myvar:=?10:10:30? - 24 -
TimePicker APPLY DEFAULT VALUES TimePicker APPLY DEFAULT VALUES ( nomeobjeto ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário O comando TimePicker APPLY DEFAULT VALUES permite reinicializar todos os parâmetros TimePicker em seus valores por padrão para o objeto de subformulário nomeobjeto. Estes valores por padrão podem ser a configuração de fábrica, mas também podem ter sido modificados via os comandos SET DEFAULT do recipiente. A ação deste comando é imediata: os valores por padrão de nomeobjeto se modificam imediatamente. Tenha em conta que a variável associada ao objeto também pode ser modificada para ter em conta os novos valores. Por exemplo, se os novos valores por padrão fixam a hora mínima em 7:00:00 e o valor da variável associada a nomeobjeto foi 6:00:00, seu valor se devolve automaticamente em 7:00:00. Os parâmetros TimePicker incluem: As horas editáveis mínimas ou máximas, As etiquetas AM e PM, Os intervalos de minutos. - 25 -
TimePicker DISPLAY SECOND HAND TimePicker DISPLAY SECOND HAND ( objectname ; secondhand ) Parâmetro Tipo objectname Texto Name of subform object secondhand Booleano True (default) = second hand shown, False = second hand hidden The TimePicker DISPLAY SECOND HAND command displays or hides the second hand in the objectname subform object (clock widget only). By default, the second hand is displayed. To hide it, call this command and pass False in the secondhand parameter. - 26 -
TimePicker LCD DISPLAY AMPM TimePicker LCD DISPLAY AMPM ( nomobjeto ; ampm ) Parâmetro Tipo nomobjeto Texto Nome do objeto sub formulário ampm Booleano True = mostrar AM/PM, False = não mostrar O comando TimePicker LCD DISPLAY AMPM mostra ou oculta o AM/PM localizado a direita do objeto de sub formulário nomobjeto (relógio digita unicamente). Estas letras se usam para diferenciar entre a manha e a tarde, quando se utiliza o relógio no modo 12 horas (ver TimePicker LCD SET MODE). Por padrão, se mostram estas letras. Pode passar False ampm para ocultar. Exemplo Queremos ocultar o AM/PM: TimePicker LCD DISPLAY AMPM("Subform1";False) - 27 -
TimePicker LCD DISPLAY SECONDS TimePicker LCD DISPLAY SECONDS ( nomobjeto ; segundos ) Parâmetro Tipo nomobjeto Texto Nome do objeto subformulário segundos Booleano True = mostrar os segundos, False = não mostrar eles O comando TimePicker LCD DISPLAY SECONDS permite mostrar ou ocultar o segundo do objeto de subformulário nomobjeto (relógio digital unicamente). Por padrão, são mostrados os segundos. Pode passar False em segundos para ocultar eles. - 28 -
TimePicker LCD SET COLOR TimePicker LCD SET COLOR ( nomobjeto ; cor {; corv ; cora} ) Parâmetro Tipo nomobjeto Texto Nome do objeto subformulário cor Inteiro longo Valor da cor RGB (4 bytes) ou Valor do componente vermelho(0..255) se passarem os outros parâmetros corv Inteiro longo Valor do componente verde (0..255) cora Inteiro longo Valor do componente azul (0..255) O comando TimePicker LCD SET COLOR define as cores dos dígitos do objeto de subformulário nomobjeto (relógio digital). Este comando aceita duas sintaxes: Se passar somente o parâmetro cor, deve passar um inteiro longo de 4 bytes cujo formato (0x00RRGGBB) se descreve a continuação (os bytes se enumeram de 0 a 3, começando da direita para a esquerda: Byte 3 Deve ser zero para uma cor RGB absoluto 2 Componente vermelho da cor (0..255) 1 Componente verde da cor (0..255) 0 Componente azul da cor (0..255) Também pode passar três parâmetros: cor, corv e cora. Neste caso, cada parâmetro deve ser um número entre 0 e 255, que representa um componente de cor RGB. Exemplo Mudar os dígitos do relógio a vermelho: TimePicker LCD SET COLOR("Subform1";0x00FF0000) // can also be written: TimePicker LCD SET COLOR ("Subform1";255;0;0) - 29 -
TimePicker LCD SET MODE TimePicker LCD SET MODE ( nomobjeto ; modo ) Parâmetro Tipo nomobjeto Texto Nome do objeto subformulário modo Inteiro longo 12 = mostrar a hora em 12 horas, 24 = mostrar a hora em modo 24 horas O comando TimePicker LCD SET MODE permite configurar a visualização em modo 12 horas ou 24 horas do objeto de subformulário nomobjeto (relógio digital unicamente). Por padrão, o objeto é mostrado em modo 12 horas. Pode passar o valor 24 no parâmetro modo se quiser passar ao modo 24 horas. Neste caso, geralmente é uma boa ideia ocultar também AM/PM (ver o comando TimePicker LCD DISPLAY AMPM). Exemplo Queremos passar a modo 24 horas e ocultar o AM/PM: TimePicker LCD SET MODE("Subform1";24) TimePicker LCD DISPLAY AMPM("Subform1";False) - 30 -
TimePicker RESET DEFAULT VALUES TimePicker RESET DEFAULT VALUES Este comando não requer parâmetros O comando TimePicker RESET DEFAULT VALUES restabelece os parâmetros do componente TimePicker a seus "ajustes de fábrica". Depois da execução deste comando: a hora editável mínima é 08:00:00 a hora editável máxima é 20:00:00 as etiquetas AM e PM são as do sistema o intervalo de minutos é 00:15:00 Note que este parâmetro só é levado em conta para os objetos TimePicker criados posteriormente e aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 31 -
TimePicker SET DEFAULT LABEL AM TimePicker SET DEFAULT LABEL AM ( etiqueta ) Parâmetro Tipo etiqueta Texto Etiqueta a utilizar para AM O comando TimePicker SET DEFAULT LABEL AM permite modificar a etiqueta "AM" para todos os objetos TimePicker com o formato AM/PM. Este parâmetro só é levado em conta para os objetos criados posteriormente e não aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 32 -
TimePicker SET DEFAULT LABEL PM TimePicker SET DEFAULT LABEL PM ( etiqueta ) Parâmetro Tipo etiqueta Texto Etiqueta a utilizar para PM O comando TimePicker SET LABEL PM permite modificar a etiqueta "PM" por padrão para todos os objetos TimePicker que mostram o formato AM/PM. Este parâmetro só é levado em conta para os objetos criados posteriormente e não aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 33 -
TimePicker SET DEFAULT MAX TIME TimePicker SET DEFAULT MAX TIME ( horamax ) Parâmetro Tipo horamax Hora Limite superior de hora editável O comando TimePicker SET DEFAULT MAX TIME permite definir a hora editável máxima aceitada por padrão para todos os objetos TimePicker. Este parâmetro só é levado em conta para os objetos criados posteriormente e não aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 34 -
TimePicker SET DEFAULT MIN TIME TimePicker SET DEFAULT MIN TIME ( horamin ) Parâmetro Tipo horamin Hora Limite inferior de hora editável O comando TimePicker SET DEFAULT MIN TIME permite definir a hora editável mínima aceitável por padrão para todos os objetos TimePicker. Este parâmetro só é levado em conta para os objetos criados posteriormente e não aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 35 -
TimePicker SET DEFAULT STEP TimePicker SET DEFAULT STEP ( intervalo ) Parâmetro Tipo intervalo Hora Intervalo entre dois valores de horas O comando TimePicker SET DEFAULT STEP permite definir o intervalo entre os valores de horas para todos os objetos TimePicker. Este parâmetro só é levado em conta para os objetos criados posteriormente e não aplica aos objetos existentes. Se deseja aplicar aos objetos existentes, deve utilizar o comando TimePicker APPLY DEFAULT VALUES. - 36 -
TimePicker SET LABEL AM TimePicker SET LABEL AM ( nomeobjeto ; etiqueta ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário etiqueta Texto Etiqueta a utilizar para AM O comando TimePicker SET LABEL AM permite modificar a etiqueta "AM" nos objetos TimePicker que mostram o formato AM/PM. O comando se aplica ao objeto designado por nomeobjeto. Por padrão, se utilizam as etiquetas sistema am/pm. Exemplo Uso por padrão da etiqueta "na manhã" em lugar da etiqueta sistema para AM: TimePicker SET LABEL AM("clock";"na manhã") - 37 -
TimePicker SET LABEL PM TimePicker SET LABEL PM ( nomeobjeto ; etiqueta ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário etiqueta Texto Etiqueta a utilizar para PM O comando TimePicker SET LABEL PM permite modificar a etiqueta "PM" nos objetos TimePicker que mostram o formato AM/PM. O comando se aplica ao objeto designado por nomeobjeto. Por padrão, se utilizam as etiquetas sistema am/pm. Exemplo Uso por padrão da etiqueta "na tarde" em lugar da etiqueta sistema para PM: TimePicker SET LABEL PM("clock";"na tarde") - 38 -
TimePicker SET MAX TIME TimePicker SET MAX TIME ( nomeobjeto ; horamax ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário horamax Hora Limite superior de hora editável O comando TimePicker SET MAX TIME permite definir a hora editável máxima que será aceitada pelo objeto designado por nomeobjeto. Se introduzir um valor de hora superior, será rejeitado. - 39 -
TimePicker SET MIN TIME TimePicker SET MIN TIME ( nomeobjeto ; horamin ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário horamin Hora Limite inferior de hora editável O comando TimePicker SET MIN TIME permite definir a hora editável mínima que será aceitada pelo objeto designado por nomeobjeto. Se introduzir um valor de hora inferior, será rejeitado. - 40 -
TimePicker SET STEP TimePicker SET STEP ( nomeobjeto ; intervalo ) Parâmetro Tipo nomeobjeto Texto Nome de objeto subformulário intervalo Hora Intervalo entre dois valores de horas O comando TimePicker SET STEP permite definir o intervalo entre os valores de horas disponíveis para o objeto designado por nomeobjeto. Este parâmetro só aplica aos TimePickers mostrados como menus pop-up. O valor de intervalo deve estar entre 1 minuto e 1 hora e deve ser mostrado como divisões inteiras de 60 minutos. Na prática, só são possíveis os valores 1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30 e 60 minutos. Qualquer outro valor será arredondado automaticamente com o propósito de corresponder a este princípio. Exemplo Configuração do TimePicker em forma de menu pop-up chamado "time1", limitação das horas editáveis de 8:30 a 16:30 com intervalos de 10 minutos: TimePicker SET MIN TIME("time1";?08:30:00?) TimePicker SET MAX TIME("time1";?16:30:00?) TimePicker SET STEP("time1";?00:10:00?) - 41 -