PureBasic

CalendarGadget()

Синтаксис

Result = CalendarGadget(#Gadget , x , y , Width , Height [, Date [, Flags]])

Описание


Создаёт Гаджет "Календарь" (Calendar Gadget) в текущем списке Гаджетов (GadgetList). Этот Гаджет отображает календарь на месяц и позволяет пользователю выбрать дату.

Параметры

#Gadget Номер для идентификации нового Гаджета. В качестве этого параметра можно использовать значение #PB_Any, чтобы сгенерировать этот Номер автоматически.
x, y, Width, Height Позиция и размеры нового Гаджета.
Date (дополн.) Значение даты, для установки начальной даты календаря. По умолчанию используется текущая дата.
Flags (дополн.) Этот параметр может быть установлен в #PB_Calendar_Borderless, для создания Гаджета без рамки (не поддерживается в Linux).

Возвращаемое значение

Возвращает не нулевое значение в случае успешного создания Гаджета, в противном случае возвращает ноль. Если в качестве параметра #Gadget использовалось значение #PB_Any, то в случае успеха, возвращаемым значением будет сгенерированный Номер Гаджета.

Комментарии

Даты, используемые для этого Гаджета и связанных с ним функций, должны быть в формате библиотеки PureBasic Date.

Вы можете добавить 'Всплывающую мини-подсказку' к этому Гаджету с помощью функции GadgetToolTip().

Для управления этим Гаджетом можно использовать следующие функции:
- SetGadgetState(): Устанавливает дату, отображаемую в Гаджете в данный момент (в секундах прошедших с 1970-01-01 до указанной даты).
- GetGadgetState(): Возвращает числовое значение даты, отображаемой в Гаджете в данный момент (количество секунд прошедших с 1970-01-01).

- SetGadgetItemState(): Выделяет или отменяет выделение жирным шрифтом для указанной даты (в формате секунд с 1970-01-01), (только для Windows).
- GetGadgetItemState(): Возвращает стиль отображения указанной даты (в формате секунд с 1970-01-01), (только Windows).

- SetGadgetAttribute(): Со следующими атрибутами: 
  #PB_Calendar_Minimum: Устанавливает минимальную доступную для выбора дату.
  #PB_Calendar_Maximum: Устанавливает максимальную доступную для выбора дату этого Гаджета.
                (Примечание. Ограничение выбираемой даты не поддерживается в Linux.)
- GetGadgetAttribute(): Со следующими атрибутами: 
  #PB_Calendar_Minimum: Возвращает минимальную доступную для выбора дату.
  #PB_Calendar_Maximum: Возвращает минимальную доступную для выбора дату.
                (Примечание. Ограничение выбираемой даты не поддерживается в Linux.)

Этот Гаджет поддерживает функции SetGadgetColor() и GetGadgetColor() со следующими значениями для параметра 'ColorType': 
  #PB_Gadget_BackColor      : цвет фона
  #PB_Gadget_FrontColor     : цвет текста для отображения дней (не поддерживается в Windows Vista+)
  #PB_Gadget_TitleBackColor : цвет фона для названия месяца (не поддерживается в Windows Vista+)
  #PB_Gadget_TitleFrontColor: цвет текста для названия месяца (не поддерживается в Windows Vista+)
  #PB_Gadget_GrayTextColor  : цвет текста для дней не текущего месяца (не поддерживается в Windows Vista+)

Пример

If OpenWindow(0, 0, 0, 250, 200, "Гаджет Календарь", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    CalendarGadget(0, 10, 10, 230, 180)
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
EndIf


См. также

SetGadgetState(), GetGadgetState(), SetGadgetItemState(), GetGadgetItemState(), SetGadgetAttribute(), GetGadgetAttribute(), SetGadgetColor(), GetGadgetColor(), DateGadget(), Date(), FormatDate()

Поддерживаемые OS

Все

<- ButtonImageGadget() - Оглавление Gadget - CanvasGadget()->