View source for Talk:SysFn00/ru

__NOTOC__ {{DISPLAYTITLE: Функция 0 &mdash; определить и нарисовать окно}}
== Параметры ==

{|  border="1" width="100%" id="table1" class="wikitable" style="font-size:88%;line-height:1.1em"
|- 
!  style="background:#ccccff;font-size:88%;padding:0" | биты
!  style="background:#ccccff;font-size:88%;padding:0" | тип
!  style="background:#ccccff;font-size:88%;padding:0" | значение
!  style="background:#ccccff;font-size:88%;padding:0" | описание
|- 
!  colspan="4" style="background:#e4e4ff" | eax
|- 
|  align="right" | <tt>&nbsp;0&ndash;31</tt>
|  align="center" | [[DataTypes/ru#UInt32|uint32]]
|  0
|  Номер функции.
|- 
!  colspan="4" style="background:#e4e4ff" | ebx
|- 
|  align="right" | <tt>&nbsp;0&ndash;15</tt>
|  align="center" | [[DataTypes/ru#UInt16|uint16]]
|  ширина окна
|  rowspan="2" | Расположение окна относительно оси X.
|- 
|  align="right" | <tt>16&ndash;31</tt>
|  align="center" | [[DataTypes/ru#Int16|int16]]
|  позиция окна по X
|- 
!  colspan="4" style="background:#e4e4ff" | ecx
|- 
|  align="right" | <tt>&nbsp;0&ndash;15</tt>
|  align="center" | [[DataTypes/ru#UInt16|uint16]]
|  высота окна
|  rowspan="2" | Расположение окна относительно оси Y.
|- 
|  align="right" | <tt>16&ndash;31</tt>
|  align="center" | [[DataTypes/ru#Int16|int16]]
|  позиция окна по Y
|- 
!  colspan="4" style="background:#e4e4ff" | edx
|- 
|  align="right" | <tt>&nbsp;0&ndash;23</tt>
|  align="center" | [[DataTypes/ru#RGB888|rgb888]]
|  цвет клиентской области
|  
|- 
|  align="right" | <tt>24&ndash;27</tt>
|  align="center" | [[DataTypes/ru#UInt4|uint4]]
|  тип окна
|
* 0 &mdash; тип окна I &mdash; окно фиксированных размеров;
* 1 &mdash; только определить область окна, ничего не рисовать;
* 2 &mdash; тип окна II &mdash; окно изменяемых размеров;
* 3 &mdash; тип окна III &mdash; окно со скином;
* 4 &mdash; тип окна IV &mdash; окно со скином фиксированных размеров.
Остальные возможные значения (от 5 до 15) зарезервированы, вызов функции с такими значениями игнорируется.
|- 
|  align="right" | <tt>28</tt>
|  align="center" | [[DataTypes/ru#Bit|bit]]
|  флаг: текст заголовка
|  Тип окна I&ndash;II: игнорируется.

Тип окна III&ndash;IV:
* 0 &mdash; нет заголовка;
* 1 &mdash; адрес строки заголовка задаётся в edi.
|- 
|  align="right" | <tt>29</tt>
|  align="center" | [[DataTypes/ru#Bit|bit]]
|  флаг: начало координат
|  Начало координат совпадает с:
* 0 &mdash; левым верхним углом окна: 0 по X, 0 по Y;
* 1 &mdash; левым верхним углом клиентской области: &lt;ширина рамки&gt; по X, &lt;высота заголовка&gt; по Y.
|- 
|  align="right" | <tt>30</tt>
|  align="center" | [[DataTypes/ru#Bit|bit]]
|  флаг: сплошной фон
|  Клиентская область при отрисовке окна:
* 0 &mdash; заполняется;
* 1 &mdash; не заполняется.
|- 
|  align="right" | <tt>31</tt>
|  align="center" | [[DataTypes/ru#Bit|bit]]
|  флаг: градиентный фон
|  Клиентская область заполняется:
* 0 &mdash; сплошным цветом;
* 1 &mdash; градиентом от указанного цвета к чёрному.
|- 
!  colspan="4" style="background:#e4e4ff" | esi
|- 
|  align="right" | <tt>&nbsp;0&ndash;23</tt>
|  align="center" | [[DataTypes/ru#RGB888|rgb888]]
|  цвет заголовка окна
|  Только для окон типа I&ndash;II.
|- 
|  align="right" | <tt>24</tt>
|  align="center" | [[DataTypes/ru#Bit|bit]]
|  флаг: неперемещаемое окно
|
* 0 &mdash; окно может быть перемещено пользователем;
* 1 &mdash; окно не может быть перемещено пользователем.
|- 
|  align="right" | <tt>25&ndash;27</tt>
|  
|  0
|  Зарезервированы.
|- 
|  align="right" | <tt>28&ndash;31</tt>
|  align="center" | [[DataTypes/ru#UInt4|uint4]]
|  стиль заголовка окна
|  Тип окна I&ndash;II:
* 0 &mdash; нет градиента;
* 4 &mdash; негативный градиент;
* 8 &mdash; обычный градиент.
Другие значения зарезервированы.

Тип окна III&ndash;IV: игнорируется.
|- 
!  colspan="4" style="background:#e4e4ff" | edi
|- 
|  align="right" rowspan="2" | <tt>&nbsp;0&ndash;31</tt>
|  align="center" | [[DataTypes/ru#RGB888|rgb888]]
|  цвет рамки окна
|  Только для окон типа I&ndash;II.
|- 
|  align="center" | [[DataTypes/ru#ASCIIZ_String|asciiz*]]
|  адрес строки заголовка
|  Только для окон типа III&ndash;IV при '''edx'''<sub>28</sub> = 1.
|}

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

Функция не возвращает значения.

== Примеры ==

=== Без макросов ===

<source>
        ;; без макросов

        ; номер функции: 0
        xor     eax, eax
        ; альтернативы: 100 shl 16 + 300, 0x0064012C
        mov     ebx, 100 * 65536 + 300
        mov     eсx, 200 * 65536 + 150
        ; цвет фона: 0x0080ff (красный 0, зелёный 128, синий 255)
        ; тип окна: III (со скином, изменяемых размеров)
        ; флаги: есть текст заголовка, рисование относительно (0, 0), сплошная заливка фона без градиента
        mov     edx, 0x130080ff
        ; адрес строки заголовка
        mov     edi, window_title
        ; вызов функции
        int     0x40

        ;; то же самое с использованием mcall

        mcall   0, <100, 300>, <200, 150>, 0x130080ff, , window_title

; ...
window_title db 'Foobar', 0
; ...
</source>

== Замечания ==

Положение и размеры окна устанавливаются при первом вызове этой функции и игнорируются при последующих; для изменения положения и/или размеров уже созданного окна используйте 67-ю функцию.

Для окон типа III&ndash;IV с заголовком ('''edx'''<sub>28</sub> = 1) строка заголовка устанавливается при первом вызове этой функции и игнорируется при последующих (точнее говоря, игнорируется после вызова [[SysFn12/ru|функции 12.2]] &mdash; конца перерисовки); для изменения строки заголовка уже созданного окна используйте [[SysFn71/ru|функцию 71.1]].

Если использовать окна соответствующих стилей, то положение и/или размеры окна могут меняться пользователем. Текущие положение и размеры могут быть получены вызовом [[SysFn09/ru|функции 9]].

Окно должно умещаться на экране. Если переданные координаты и размеры не удовлетворяют этому условию, то соответствующая координата (или, возможно, обе) считается нулем, а если и это не помогает, то соответствующий размер (или, возможно, оба) устанавливается в размер экрана.

{{note | Далее обозначим '''xpos''', '''ypos''', '''xsize''', '''ysize''' &mdash; значения, передаваемые в '''ebx''' и '''ecx'''. Координаты приводятся относительно левого верхнего угла окна, который, таким образом, задается как (0, 0), координаты правого нижнего угла суть ('''xsize''', '''ysize''').}}

Размеры окна понимаются в смысле координат правого нижнего угла.

{{note | Это же относится и ко всем остальным функциям. Это означает, что реальные размеры на 1 пиксель больше.}}

=== Вид окна типа I ===

* рисуется внешняя рамка цвета, указанного в '''edi''', шириной 1 пиксель
* рисуется заголовок &mdash; прямоугольник с левым верхним углом (1, 1) и правым нижним ('''xsize''' &minus; 1, min(25, '''ysize''')) цвета, указанного в '''esi''' (с учетом градиента)
* если '''ysize''' &ge; 26, то закрашивается рабочая область окна &mdash; прямоугольник с левым верхним углом (1, 21) и правым нижним ('''xsize''' &minus; 1, '''ysize''' &minus; 1) (размерами ('''xsize''' &minus; 1) &times; ('''ysize''' &minus; 21)) &mdash; цветом, указанным в '''edx''' (с учетом градиента)
* если '''edx'''<sub>28</sub> = 1 и строка заголовка установлена [[SysFn71/ru|функцией 71.1]], то она выводится в соответствующем месте заголовка

=== Вид окна типа II ===

* рисуется внешняя рамка шириной 1 пиксель "затенённого" цвета '''edi''' (все составляющие цвета уменьшаются в два раза)
* рисуется промежуточная рамка шириной 3 пикселя цвета '''edi'''
* рисуется внутренняя рамка шириной 1 пиксель "затенённого" цвета '''edi'''
* рисуется заголовок &mdash; прямоугольник с левым верхним углом (4, 4) и правым нижним ('''xsize''' &minus; 4, min(20, '''ysize''')) цвета, указанного в '''esi''' (с учетом градиента)
* если '''ysize''' &ge; 26, то закрашивается рабочая область окна &mdash; прямоугольник с левым верхним углом (5, 20) и правым нижним ('''xsize''' &minus; 5, '''ysize''' &minus; 5) &mdash; цветом, указанным в '''edx''' (с учетом градиента)
* если '''edx'''<sub>28</sub> = 1 и строка заголовка установлена [[SysFn71/ru|функцией 71.1]], то она выводится в соответствующем месте заголовка

=== Вид окна со скином (типа III и IV) ===

* рисуется внешняя рамка шириной 1 пиксель цвета 'outer' из скина
* рисуется промежуточная рамка шириной 3 пикселя цвета 'frame' из скина
* рисуется внутренняя рамка шириной 1 пиксель цвета 'inner' из скина
* рисуется заголовок (по картинкам из скина) в прямоугольнике (0, 0) &ndash; ('''xsize''', _skinh &minus; 1)
* если '''ysize''' &ge; 26, то закрашивается рабочая область окна &mdash; прямоугольник с левым верхним углом (5, _skinh) и правым нижним ('''xsize''' &minus; 5, '''ysize''' &minus; 5) &mdash; цветом, указанным в '''edx''' (с учетом градиента)
* определяются две стандартные кнопки: закрытия и минимизации (смотри [[SysFn08/ru|функцию 8]])
* если '''edx'''<sub>28</sub> = 1 и в '''edi''' (ненулевой) указатель на строку заголовка, то она выводится в заголовке в месте, определяемом скином

Значение переменной _skinh доступно как результат вызова [[SysFn48/ru|функции 48.4]]

{{System functions}}
[[Category: SysCalls]]