DatePicker SET DAYS OFF

4D v18


DatePicker SET DAYS OFF ( nomeObjeto {; tipoDia ; ptrArrayDiasFeri} )

Parâmetro	Tipo	Descrição
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

Descrição

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!)

 APPEND TO ARRAY($arrdUniqueDays;!02/17/2010!)

 DatePicker SET DAYS OFF(1;->$arrdUniqueDays)

Ver também

DatePicker SET DEFAULT DAYS OFF
DatePicker SET WEEK FIRST DAY