SysFn48/ru

Функция 48 - стили отображения окон

---

Подфункция 0 - применить настройки экрана.

Параметры:

• eax = 48 - номер функции
• ebx = 0 - номер подфункции
• ecx = 0 - зарезервировано

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

• функция не возвращает значения

Замечания:

• Функция перерисовывает экран после изменения параметров подфункциями 1 и 2.
• Вызов функции без предшествующих вызовов указанных подфункций игнорируется.
• Вызов функции с ненулевым ecx игнорируется.

Подфункция 1 - установить стиль кнопок.

Параметры:

• eax = 48 - номер функции
• ebx = 1 - номер подфункции
• ecx = тип кнопок:

• 0 = плоские
• 1 = объёмные

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

• функция не возвращает значения

Замечания:

• После вызова описываемой функции следует перерисовать экран подфункцией 0.
• Тип кнопок влияет только на их прорисовку функцией 8.

Подфункция 2 - установить стандартные цвета окон.

Параметры:

• eax = 48 - номер функции
• ebx = 2 - номер подфункции
• ecx = указатель на таблицу цветов
• edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

Формат таблицы цветов указан в описании подфункции 3. Возвращаемое значение:

• функция не возвращает значения

Замечания:

• После вызова описываемой функции следует перерисовать экран подфункцией 0.
• Таблица стандартных цветов влияет только на приложения, которые эту таблицу явным образом получают (подфункцией 3) и используют (указывая цвета из неё при вызовах функций рисования).
• Таблица стандартных цветов входит в скин и устанавливается заново при установке скина (подфункции 8).
• Таблицу цветов можно просматривать/изменять интерактивно с помощью приложения desktop.

Подфункция 3 - получить стандартные цвета окон.

Параметры:

• eax = 48 - номер функции
• ebx = 3 - номер подфункции
• ecx = указатель на буфер размером edx байт, куда будет записана таблица
• edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

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

• функция не возвращает значения

Формат таблицы цветов: каждый элемент - dword-значение цвета 0x00RRGGBB

• +0: dword: dd menu_body - цвет фона системного меню
• +4: dword: dd 3d_face - цвет фона для придания 3D эффекта
• +8: dword: dd 3d_dark - цвет темной обводки для придания 3D эффекта
• +12: dword: dd 3d_light - цвет светлой обводки для придания 3D эффекта
• +16: dword: dd win_title - цвет текста в заголовке окна приложения
• +20: dword: dd win_body - цвет фона окна
• +24: dword: dd btn_face - цвет активной кнопки
• +28: dword: dd btn_text - цвет текста активной кнопки
• +32: dword: dd win_text - цвет текста в рабочей области окна
• +36: dword: dd panel_frame - цвет рамки области панели
• +40: dword: dd win_face - цвет бордюра окна между внешней и внутренней рамкой
• +44: dword: dd win_inface - цвет бордюра "неактивного" окна между внешней и внутренней рамкой
• +48: dword: dd win_frame - цвет внешней рамки окна
• +52: dword: dd win_inframe - цвет внешней рамки "неактивного" окна
• +56: dword: dd win_border - цвет внутренней рамки окна
• +60: dword: dd win_inborder - цвет внутренней рамки "неактивного" окна
• +64: dword: dd win_graytext - цвет в оттенках серого в рабочей области окна.
• +68: dword: dd menu_frame - цвет рамки системного меню
• +72: dword: dd menu_text - цвет текста системного меню
• +76: dword: dd panel_body - цвет фона области панели
• +80: dword: dd panel_text - цвет текста области панели
• +84: dword: dd hint_frame - цвет рамки всплывающей подсказки
• +88: dword: dd hint_body - цвет фона всплывающей подсказки
• +92: dword: dd hint_text - цвет текста всплывающей подсказки
• +96: dword: dd btn_inface - цвет фона "неактивной" кнопки
• +100: dword: dd btn_fcface - цвет фона кнопки при наведении курсора (focus)
• +104: dword: dd btn_frame - цвет рамки кнопки
• +108: dword: dd btn_inframe - цвет рамки "неактивной" кнопки
• +112: dword: dd btn_fcframe - цвет рамки кнопки при наведении курсора (focus)
• +116: dword: dd btn_intext - цвет текста "неактивной" кнопки
• +120: dword: dd btn_fctext - цвет текста кнопки при наведении курсора (focus)
• +124: dword: dd gui_shadow - цвет тени от любого текста
• +128: dword: dd gui_face - цвет фона элемента (edit,listbox,checkbox...)
• +132: dword: dd gui_inface - цвет фона "неактивного" элемента
• +136: dword: dd gui_fcface - цвет фона элемента при наведении курсора
• +140: dword: dd gui_frame - цвет рамки элемента
• +144: dword: dd gui_inframe - цвет рамки "неактивного" элемента
• +148: dword: dd gui_fcframe - цвет рамки элемента при наведении курсора
• +152: dword: dd gui_text - цвет текста элемента
• +156: dword: dd gui_intext - цвет текста "неактивного" элемента
• +160: dword: dd gui_fctext - цвет текста элемента при наведении курсора
• +164: dword: dd gui_select - цвет выделения текста
• +168: dword: res_var_a - зарезервированно
• +172: dword: res_var_b - зарезервированно
• +176: dword: res_var_c - зарезервированно
• +180: dword: res_var_d - зарезервированно
• +184: dword: res_var_e - зарезервированно
• +188: dword: res_var_f - зарезервированно

Замечания:

• До ревизии #4788 скины использовали только первые 40 байт (причина разрозненности структуры таблицы - совместимость).
• Структура таблицы цветов описана в стандартном включаемом файле macros.inc под названием system_colors; например, можно писать:

   	sc	new_system_colors	; объявление переменной
   	...				; где-то надо вызвать
   					; описываемую функцию с ecx=sc
   	mov	ecx, [sc.win_text]	; читаем цвет текста
   					; в рабочей области окна

• Использование/неиспользование этих цветов - дело исключительно самой программы. Для использования нужно просто при вызове функций рисования указывать цвет, взятый из этой таблицы.
• При изменении таблицы стандартных цветов (подфункцией 2 с последующим применением изменений подфункцией 0 или при установке скина подфункцией 8) всем окнам посылается сообщение о необходимости перерисовки (событие с кодом 1).
• Стандартные цвета можно просматривать/изменять интерактивно с помощью приложения desktop.

Подфункция 4 - получить высоту скина.

Параметры:

• eax = 48 - номер функции
• ebx = 4 - номер подфункции

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

• eax = высота скина

Замечания:

• Высотой скина по определению считается высота заголовка окон, использующих скин.
• Смотри также общую структуру окна в описании функции 0.

Подфункция 5 - получить рабочую область экрана.

Параметры:

• eax = 48 - номер функции
• ebx = 5 - номер подфункции

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

• eax = [left]*65536 + [right]
• ebx = [top]*65536 + [bottom]

Замечания:

• Рабочая область экрана определяет положение и координаты максимизированного окна.
• Рабочая область экрана при нормальной работе есть весь экран за вычетом панели (@panel).
• (left,top) - координаты левого верхнего угла,

(right,bottom) - координаты правого нижнего.

Таким образом, размер рабочей области по оси x определяется формулой right-left+1, по оси y - формулой bottom-right+1.

• Смотри также функцию 14, позволяющую определить размеры всего экрана.
• Есть парная функция установки рабочей области - подфункция 6.

Подфункция 6 - установить рабочую область экрана.

Параметры:

• eax = 48 - номер функции
• ebx = 6 - номер подфункции
• ecx = [left]*65536 + [right]
• edx = [top]*65536 + [bottom]

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

• функция не возвращает значения

Замечания:

• Рабочая область экрана определяет положение и координаты максимизированного окна.
• Эта функция используется только приложением @panel, устанавливающим рабочей областью весь экран за вычетом панели.
• (left,top) - координаты левого верхнего угла,

(right,bottom) - координаты правого нижнего.

Таким образом, размер рабочей области по оси x определяется формулой right-left+1, по оси y - формулой bottom-right+1.

• Если left>=right, то x-координаты рабочей области не изменяются.

Если left<0, то left не устанавливается. Если right больше или равно ширины экрана, то right не устанавливается.

Аналогично по оси y.

• Смотри также функцию 14, позволяющую определить размеры всего экрана.
• Есть парная функция получения рабочей области - подфункция 5.
• Эта функция автоматически перерисовывает экран, по ходу дела обновляет координаты и размеры максимизированных окон.

Все окна извещаются о необходимости перерисовки (событие 1).

Подфункция 7 - получить область скина для текста заголовка.

Возвращает область заголовка окна со скином, предназначенную для вывода текста заголовка. Параметры:

• eax = 48 - номер функции
• ebx = 7 - номер подфункции

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

• eax = [left]*65536 + [right]
• ebx = [top]*65536 + [bottom]

Замечания:

• Использование/неиспользование этой функции - личное дело приложения.
• Рекомендуется учитывать значения, возвращаемые этой функцией, при выборе места для рисования текста заголовка (функцией 4) или какого-нибудь заменителя текста заголовка (по усмотрению приложения).

Подфункция 8 - установить используемый скин окон.

Параметры:

• eax = 48 - номер функции
• ebx = 8 - номер подфункции
• ecx = указатель на имя файла скина

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

• eax = 0 - успешно
• eax = 1 - не удалось загрузить файл
• eax = 2 - файл не является файлом скина

Замечания:

• При успешной загрузке скина все окна извещаются о необходимости перерисовки (событие 1).
• При загрузке система считывает скин из файла default.skn на рамдиске.
• Пользователь может изменять скин статически, создав свой default.skn, или динамически с помощью приложения desktop.