SysFn48/ru: Difference between revisions

(3 intermediate revisions by 3 users not shown)

Line 6:

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 0 - номер подфункции

:* ebx = 0 - номер подфункции

* ecx = 0 - зарезервировано

:* ecx = 0 - зарезервировано

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

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

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

Замечания:

* Функция перерисовывает экран после изменения параметров подфункциями 1 и 2.

:* Функция перерисовывает экран после изменения параметров подфункциями 1 и 2.

* Вызов функции без предшествующих вызовов указанных подфункций игнорируется.

:* Вызов функции без предшествующих вызовов указанных подфункций игнорируется.

* Вызов функции с ненулевым ecx игнорируется.

:* Вызов функции с ненулевым ecx игнорируется.

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_APPLY (0)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 1 - номер подфункции

:* ebx = 1 - номер подфункции

* ecx = тип кнопок:

:* ecx = тип кнопок:

:* 0 = плоские

::* 0 = плоские

:* 1 = объёмные

::* 1 = объёмные

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

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

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

Замечания:

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

:* После вызова описываемой функции следует перерисовать экран подфункцией 0.

* Тип кнопок влияет только на их прорисовку [[SysFn08/ru|функцией 8]].

:* Тип кнопок влияет только на их прорисовку [[SysFn08/ru|функцией 8]].

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_SET_BUTTON_STYLE (1)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 2 - номер подфункции

:* ebx = 2 - номер подфункции

* ecx = указатель на таблицу цветов

:* ecx = указатель на таблицу цветов

* edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

:* edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

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

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

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

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

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

Замечания:

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

:* После вызова описываемой функции следует перерисовать экран подфункцией 0.

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

:* Таблица стандартных цветов влияет только на приложения, которые эту таблицу явным образом получают (подфункцией 3) и используют (указывая цвета из неё при вызовах функций рисования).

* Таблица стандартных цветов входит в скин и устанавливается заново при установке скина (подфункции 8).

:* Таблица стандартных цветов входит в скин и устанавливается заново при установке скина (подфункции 8).

* Таблицу цветов можно просматривать/изменять интерактивно с помощью приложения [[desktop/ru|desktop]].

:* Таблицу цветов можно просматривать/изменять интерактивно с помощью приложения [[desktop/ru|desktop]].

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_SET_COLORS (2)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 3 - номер подфункции

:* ebx = 3 - номер подфункции

* ecx = указатель на буфер размером edx байт, куда будет записана таблица

:* ecx = указатель на буфер размером edx байт, куда будет записана таблица

* edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

:* edx = размер таблицы цветов (должен быть 192 байта для будущей совместимости)

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

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

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

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

:* +0: dword: menu_body - цвет фона системного меню

Line 108:

Line 120:

* До ревизии #4788 скины использовали только первые 40 байт (причина разрозненности структуры таблицы - совместимость).

* Структура таблицы цветов описана в стандартном включаемом файле macros.inc под названием system_colors; например, можно писать:

sc ~~new_system_colors~~ ; объявление переменной

sc sys_colors ; объявление переменной

... ; где-то надо вызвать

; описываемую функцию с ecx=sc

Line 116:

Line 128:

* При изменении таблицы стандартных цветов (подфункцией 2 с последующим применением изменений подфункцией 0 или при установке скина подфункцией 8) всем окнам посылается сообщение о необходимости перерисовки (событие с кодом 1).

* Стандартные цвета можно просматривать/изменять интерактивно с помощью приложения [[desktop/ru|desktop]].

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_GET_COLORS (3)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

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

:* ebx = 4 - номер подфункции

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

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

:* eax = высота скина

Замечания:

* Высотой скина по определению считается высота заголовка окон, использующих скин.

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

* Смотри также общую структуру окна в описании [[SysFn00/ru|функции 0]].

:* Смотри также общую структуру окна в описании [[SysFn00/ru|функции 0]].

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_GET_SKIN_HEIGHT (4)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

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

:* ebx = 5 - номер подфункции

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

* eax = [left]*65536 + [right]

:* eax = [left]*65536 + [right]

* ebx = [top]*65536 + [bottom]

:* ebx = [top]*65536 + [bottom]

Замечания:

* Рабочая область экрана определяет положение и координаты максимизированного окна.

:* Рабочая область экрана определяет положение и координаты максимизированного окна.

* Рабочая область экрана при нормальной работе есть весь экран за вычетом панели (@~~panel~~).

:* Рабочая область экрана при нормальной работе есть весь экран за вычетом панели (@taskbar).

* (left,top) - координаты левого верхнего угла,

:* (left,top) - координаты левого верхнего угла,

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

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

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

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

* Смотри также функцию 14, позволяющую определить размеры всего экрана.

:* Смотри также [[SysFn14/ru|функцию 14]], позволяющую определить размеры всего экрана.

* Есть парная функция установки рабочей области - подфункция 6.

:* Есть парная функция установки рабочей области - подфункция 6.

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_GET_SCREEN_AREA (5)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 6 - номер подфункции

:* ebx = 6 - номер подфункции

* ecx = [left]*65536 + [right]

:* ecx = [left]*65536 + [right]

* edx = [top]*65536 + [bottom]

:* edx = [top]*65536 + [bottom]

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

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

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

Замечания:

* Рабочая область экрана определяет положение и координаты максимизированного окна.

:* Рабочая область экрана определяет положение и координаты максимизированного окна.

* Эта функция используется только приложением @~~panel~~, устанавливающим рабочей областью весь экран за вычетом панели.

:* Эта функция используется только приложением @taskbar, устанавливающим рабочей областью весь экран за вычетом панели.

* (left,top) - координаты левого верхнего угла,

:* (left,top) - координаты левого верхнего угла,

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

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

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

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

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

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

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

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

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

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

* Смотри также функцию 14, позволяющую определить размеры всего экрана.

:* Смотри также [[SysFn14/ru|функцию 14]], позволяющую определить размеры всего экрана.

* Есть парная функция получения рабочей области - подфункция 5.

:* Есть парная функция получения рабочей области - подфункция 5.

* Эта функция автоматически перерисовывает экран, по ходу дела обновляет координаты и размеры максимизированных окон.

:* Эта функция автоматически перерисовывает экран, по ходу дела обновляет координаты и размеры максимизированных окон.

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

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

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_SET_SCREEN_AREA (6)

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

Line 171:

Line 200:

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

для вывода текста заголовка.

Параметры:

<br>Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

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

:* ebx = 7 - номер подфункции

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

* eax = [left]*65536 + [right]

:* eax = [left]*65536 + [right]

* ebx = [top]*65536 + [bottom]

:* ebx = [top]*65536 + [bottom]

Замечания:

* Использование/неиспользование этой функции - личное дело приложения.

:* Использование/неиспользование этой функции - личное дело приложения.

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

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

'''Константы для регистров:'''

::eax - SF_STYLE_SETTINGS (48)

::ebx - SSF_GET_SKIN_MARGINS (7)

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

Параметры:

* eax = 48 - номер функции

:* eax = 48 - номер функции

* ebx = 8 - номер подфункции

:* ebx = 8 - номер подфункции

* ecx = указатель на имя файла скина

:* ecx = указатель на имя файла скина

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

* eax = 0 - успешно

:* eax = 0 - успешно