AROS/Zune: различия между версиями

Попробуем запросить данные объекта MUI String:

 

void f(Object *string)

{

printf("String содержит: %s\n", (STRPTR)result);

}

 

* <code>Object *</code> — тип объектов BOOPSI.

В интерфейсах Zune чаще используются макросы <code>get()</code> и <code>XGET()</code>. Например:

 

get(string, MUIA_String_Contents, &result);

 

result = XGET(string, MUIA_String_Contents);

 

 

Рассмотрим изменение данных полученной строки:

 

SetAttrs(string, MUIA_String_Contents, (IPTR)"превед", TAG_DONE);

 

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

Вы можете решить, что вам полезен макрос <code>set()</code>:

 

set(string, MUIA_String_Contents, (IPTR)"превед");

 

Однако, только вызовом <code>SetAttrs()</code> вы сможете установить несколько атрибутов за один раз:

 

SetAttrs(string,

MUIA_Disabled, TRUE,

MUIA_String_Contents, (IPTR)"Гммм...",

TAG_DONE);

 

=== Вызов метода ===

Методы в интерфейсах Zune, как правило, вызываются из тела цикла приложения, при обработке событий:

 

result = DoMethod(obj, MUIM_Application_NewInput, (IPTR)&sigs);

 

* Эти параметры не являются taglist, и следовательно не заканчиваются тегом <code>TAG_DONE</code>.

Рассмотрим наш первый реальный пример :

 

// gcc hello.c -lmui

#include <exec/types.h>

return 0;

}

 

=== Комментарии ===

Для облегчения программирования интерфейса используются макросы. Интерфейс Zune всегда имеет 1 (и только 1) объект Приложения:

 

app = ApplicationObject,

</sorce>

Приложение может иметь 0, 1 или больше объектов Окна. Чаще всего окно одно единственное:

 

SubWindow, wnd = WindowObject,

 

Будет хорошо, если заголовок окна будет содержать название приложения:

 

MUIA_Window_Title, "Hello world!",

 

Окно может иметь 1 (и только 1) дочерний объект (Child), обычно это группа. Наша группа будет "вертикальной" (<code>VGroup</code>), это означает что все входящие в неё дочерние объекты будут группироваться по вертикали:

 

WindowContents, VGroup,

 

Группа должна иметь, как минимум 1 дочерний объект. В нашем случае, это будет обыкновенный текст (TextObject):

 

Child, TextObject,

 

Zune поддерживаются различные escape-коды (ниже, через \33c производится центрование текста) и перевод каретки ( \n ):

 

MUIA_Text_Contents, "\33cHello world!\nHow are you?",

 

Макрос <code>End</code> должен завершать описание любого макроса вида xxxObject (в нашем случае, </code>TextObject</code>):

 

End,

 

Теперь добавим в нашу группу второй дочерний объект, кнопку! Помимо мыши, она будет откликаться на комбинацию клавиш RAmiga + o (укажем на это символом подчёркивания до буквы "O")

 

Child, but = SimpleButton("_Ok"),

 

Завершаем описание группы:

 

End,

 

Завершаем описание окна:

 

End,

 

Завершаем описание интерфейса:

 

End;

 

И что, вы всё ещё нуждаете в графических построителях интерфейсов? :-)

Если любой из объектов в структуре описанной нами выше, не сможет быть создан, Zune уничтожит все объекты (включая те, которые удалось создать) и возвратит код ошибки. В противном случае, вы получите полностью рабочий интерфейс приложения:

 

if (app != NULL)

{

...

 

Когда мы завершаем работу приложения, необходимо вызвать метод <code>MUI_DisposeObject()</code>, передав ему указатель на созданную структуру приложения. Это необходимо для уничтожения всех созданных объектов и освобождения всех использованных ресурсов:

 

...

MUI_DisposeObject(app);

}

 

==== Обработка сообщений ====

Обработка сообщений является простым путём создания реакций интерфейса на возникающие события (такие как, нажатие кнопки). Принцип: мы получаем сообщение, когда определённый атрибут, определённого объекта, будет установлен в определённое значение:

 

DoMethod(wnd, MUIM_Notify, MUIA_Window_CloseRequest, TRUE,

 

Здесь, мы ожидаем когда атрибут MUIA_Window_CloseRequest нашего объекта Окна (wnd) будет установлен в <code>TRUE</code> (значит, пользователь нажал кнопку). Когда сообщение будет получено, мы предписываем нашему объекту приложения вернуть код <code>MUIV_Application_ReturnID_Quit</code> на следующей итерации цикла приложения:

 

(IPTR)app, 2,

MUIM_Application_ReturnID, MUIV_Application_ReturnID_Quit);

 

Поскольку требуется определить, что же именно произошло, необходимо указать число параметров передаваемых MUIM_Notify: 2 параметра.

В случае кнопки «Ok», мы ожидаем когда атрибут <code>MUIA_Pressed</code> окажется установленным в <code>FALSE</code>, что будет означать нажатую и ''отпущенную'' пользователем кнопку «Ok» (реакция на простое нажатие кнопки является плохой практикой, т.к. вы можете захотеть отпустить кнопку мыши вне кнопки интерфейса, и таким образом отказаться от действия. К тому же, мы можем просто захотеть увидеть, как она выглядит в нажатом состоянии). В остальном, всё полностью аналогично предыдущему примеру:

 

DoMethod(but, MUIM_Notify, MUIA_Pressed, FALSE,

(IPTR)app, 2,

MUIM_Application_ReturnID, MUIV_Application_ReturnID_Quit);

 

==== Открытие окна ====

Окно не будет открыто, пока вы не «попросите» Zune об этом:

 

set(wnd, MUIA_Window_Open, TRUE);

 

Если объекты согласно структуре описанной нами выше были созданы удачно, вы увидете окно. Но эта операция может завершиться с ошибкой! Таким образом, мы никогда не должны забывать проверять атрибут объекта окна, который должен быть установлен в TRUE:

 

if (XGET(wnd, MUIA_Window_Open))

 

==== Цикл приложения ====

Дорогие друзья, позвольте представить вам идеальный цикл интерфейса Zune:

 

ULONG sigs = 0;

 

Никогда не забывайте обнулять сигналы (<code>sigs</code>) ... Тестовый цикл приложения с использованием метода <code>MUIM_Application_NewInput</code> :

 

...

while((LONG) DoMethod(app, MUIM_Application_NewInput, (IPTR)&sigs)

!= MUIV_Application_ReturnID_Quit)

 

Обнуление <code>sigs</code> необходимо, т.к. первые же сигналы обрабатываемых событий (возвращающие <code>Wait()</code>, или 0), должны будут изменить <code>sigs</code>, поместив туда ожидаемые Zune сигналы (до следующего <code>Wait()</code>), и вернув полученное значение. Описанный здесь механизм возврата значений, исторически был единственным способом реакции на события. Но, поскольку, он «неудобоварим» в программировании, впоследствии от него стали отказываться в пользу создания собственных классов и объектно-ориентированной структуры приложения.

Тело цикла приложения. Ожидание сигналов и обработка нажатия Ctrl + С, для принудительного выхода из цикла:

 

{

if (sigs)

}

}

 

==== Резюме ====