Elementy

• 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