- ITEM *new_item(char *name, char *description)
Tworzy nowy element o podanej nazwie i opisie. Zwraca wskaźnik na nowy
element. ( Uwaga: element musi mieć nazwę!. )
Zwraca:
wskaźnik lub NULL.
- int free_item(ITEM *item)
Zwalnia zallokowaną pamięć dla danego elementu.
( Uwaga: element podłączony nie może zostać usunięty. )
Zwraca:
E_OK - sukces
E_BAD_ARGUMENT - nieprawidłowy argument
E_CONNECTED - element jest połączony z menu
- int set_menu_items(MENU *menu, ITEM **items)
Ustawia wskaźnik na elementy połączone z menu.
Zwraca:
E_OK - sukces
E_POSTED - menu jest wyświetlane
E_CONNECTED - jeden lub więcej elementów jest
połączonych z innym menu
E_BAD_ARGUMENT - nieprawidłowe menu lub tablica elementów
zostały podane
- ITEM **menu_items(const MENU *menu)
Zwraca wskaźnik do wskaźnika elementów menu.
Zwraca:
NULL na błąd
- int item_count(const MENU *menu)
Pobiera liczbę elementów połączonych z menu. Jeżeli wkaźnik menu jest
NULL zwracamy -1.
Zwraca:
liczbę elementów lub -1.
- int set_menu_mark( MENU *menu, const char *mark )
Ustaw znak służący do oznaczania aktualnego elementu ( lub wybranych dla
menu wielowartościowego ). Argument może być NULL. Może to być
nieco nieprawidłowe - może zmienić rozmiar menu co jest niemożliwe
gdy jest ono już wyświetlane.
Zwraca:
E_OK - sukces
E_BAD_ARGUMENT - nieprawidłowy argument
E_SYSTEM_ERROR - brak pamięci aby zachować znak
- char *menu_mark(const MENU *menu)
Podaje znacznik ustawiony przez set_menu_mark.
Zwraca:
znacznik lub NULL
- int set_current_item(MENU *menu, const ITEM *item)
Czyni element aktywnym.
Zwraca:
E_OK - sukces
- ITEM *current_item(const MENU *menu)
Podaje aktualny element menu.
Zwraca:
Wskaźnik na element lub NULL
- int item_index(const ITEM *)
Zwraca logiczny index tego elementu.
Zwraca:
index lub ERR jeżeli wskaźnik nie jest prawidłowy
- char *item_name(const ITEM *item)
Zwraca nazwę elementu menu.
Zwraca:
wskaźnik do nazwy lub NULL
- char *item_description(const ITEM *item)
Podaje opis elementu.
Zwraca:
zobacz powyżej
- bool item_visible(const ITEM *item)
Element jest widoczny jeżeli aktualnie pojawią się w podoknie wyświetlanego
menu.
Zwraca:
TRUE - widzialny
FALSE - amba fatima