DI_CHECKBOX

Programming Far Manager plugins

previous page next page

DI_CHECKBOX

главная | элементы диалога | Dialog API
Элемент диалога DI_CHECKBOX описывает контрольный переключатель (Check Box). также он называется кнопкой с независимой фиксацией (переключатель вкл./выкл., который может переключаться пользователем). Переключатель "включён", если у элемента поле Selected отлично от нуля. 
struct FarDialogItem
{
  enum FARDIALOGITEMTYPES Type = DI_CHECKBOX
  intptr_t X1                  = X
  intptr_t Y1                  = Y
  intptr_t X2                  = 0
  intptr_t Y2                  = Y (равен значению Y1)
  intptr_t Selected            = Selected
  FARDIALOGITEMFLAGS Flags     = Flags
  const wchar_t *Data          = надпись переключателя
};

Внимание! Внимание!

  • Приведено схематичное изображение структуры; полное описание структуры см. здесь.

Selected

Определяет состояние элемента - отмечен или нет.

Флаги

Для элемента DI_CHECKBOX имеют значения следующие флаги:
ФлагОписание
DIF_DEFAULTBUTTON флаг, означающий, что данный элемент диалога является "элементом по умолчанию"
DIF_FOCUS определяет, что при показе диалога установить клавиатурный фокус ввода на данный элемент
DIF_CENTERGROUP центрирование идущих подряд переключателей с одинаковой вертикальной позицией (параметр X игнорируется)
DIF_DISABLE элемент является недоступным
DIF_NOFOCUS управляющий элемент не получает клавиатурный фокус ввода
DIF_3STATE контрольный переключатель будет иметь 3 состояния: "выключен", "включён", "неопределено"
DIF_SHOWAMPERSAND показывать в заголовке рамки амперсанд не используя его для определения горячей клавиши

События

СобытиеОписание
DN_DRAWDLGITEM начало отрисовки текстовой строки
DN_CTLCOLORDLGITEM запрос цветовых атрибутов для отрисовки; Param2: 
Colors[0] - текст кнопки
                (COL_WARNDIALOGBUTTON или COL_DIALOGTEXT)
Colors[1] - выделенный текст (highlighting text)
                (COL_WARNDIALOGHIGHLIGHTTEXT или COL_DIALOGHIGHLIGHTTEXT)
Colors[2] - 0 (не используется)
Colors[3] - 0 (не используется)
DN_CONTROLINPUT нажали клавиатурную клавишу или кликнули клавишей мыши
DN_HOTKEY горячая клавиша (Alt+Символ)
DN_BTNCLICK изменение состояния переключателя
DN_KILLFOCUS элемент потерял фокус (при условии, что не используется флаг DIF_NOFOCUS)
DN_GOTFOCUS элемент получил фокус (при условии, что не используется флаг DIF_NOFOCUS)

Замечания

Хотя координаты X2 и Y2 в Dialog API не используется, но для нормальной работы в будущих версиях Far Manager желательно корректно заполнить значения этих полей.
Смотрите также:
DI_RADIOBUTTON, DI_BUTTON, FarDialogItem
previous page start next page