|
Pochodzi od: (brak)
Zadeklarowany w: be/be_apps/Deskbar/Deskbar.h
Biblioteka: libbe.so
Alokowanie: Konstruktor na stosie
Podsumowanie: więcej...
BDeskbar pozwala Ci zapytać o położenie Deskbar'a, orientację (rozwinięty lub zwinięty) i ramkę i pozwala Ci dodawać i usuwać elementy z półki. Ta klasa pozwala Ci zwijać/rozwijać Deskbar i przesuwać go do wcześniej zdefiniowanego położenia, ale nie pozwala Ci usuwać lub ukrywać Deskbar'a, nie pozwala Ci także zamieniać go na swoje własne obiekty UI.
![]()
Nie potrzebujesz obiektu be_app do utworzenia i używania BDeskbar'a.
![]() | BDeskbar() , ~Deskbar() |
BDeskbar(void) ~BDeskbar() Konstruktor tworzy i zwraca nowy obiekt BDeskbar. Destruktor usuwa go.
![]() | AddItem() , RemoveItem() , CountItems() , HasItem() , GetItemInfo() |
status_t AddItem(BView *view, int32 *id=NULL)
status_t AddItem(entry_ref *addon, int32 *id=NULL)status_t RemoveItem(int32 id)
status_t RemoveItem(const char *name)int32 CountItems(void) const bool HasItem(int32 id) const
bool HasItem(const char *name) conststatus_t GetItemInfo(int32 for_id, const char **found_name)
status_t GetItemInfo(const char *for_name, int32 *found_id)
![]()
Widok który jest umieszczony na półce Deskbar'a nie może wywołać żadnej z tych funkcji. Deskbar zawiera półkę która zawiera replikanty (archiwizowalne obiekty BView). Zwykle, te replikanty monitorują lub sterują niektórymi usługami. Dla przykładu, BeOS dostarcza elementy półki które monitorują i sterują mechanizmem metody wejścia (np. klawiatura - przyp. aut.), PPP i demonem poczty (widok czas/data nie jest replikantem półki):
![]()
AddItem() wstawia nowy element na półce Deskbar'a. view, to BView który będzie wyświetlany na półce, musi być archiwizowalny (patrz BArchivable). Element na półce jest rozpoznawany przez nazwę i całkowity id (identyfikator jako liczba całkowita - przyp. tłum.). Nazwa jest taka sama jak jego widok (t.j., jak przypisana w konstruktorze BView); id jest generowany przez Deskbar i jest zagwarantowana jego unikalność. id, jeśli dostarczono jest ustawiany jako unikalny numer id dodanego elementu.
Możesz również dodać element do Deskbar'a przez przesłanie entry_ref, addon, do wtyczki Deskbar 'a aby został tam umieszczony.
RemoveItem() usuwa element półkowy rozpoznawany przez name lub id.
CountItems() zwraca liczbę elementów obecnych na półce (pamiętaj że nie może on zliczyć widoku daty/czasu).
HasItem() zwraca true jeśli półka Deskbar'a zawiera element rozpoznawany przez name lub id.
GetItemInfo() wskazuje na *found_name nazwę elementu rozpoznawanego przez for_id, lub ustawionego przez found_id elementu rozpoznawanego przez for_name.
![]()
Wywołujący jest odpowiedzialny za zwolnienie found_name. ZWRACANE KODY
- B_OK. Żądanie dodania, usunięcia lub uzyskania informacji o elemencie zostało z sukcesem zakomunikowane Deskbar'owi. Zauważ, że nie znaczy to, że funkcja w rzeczywistości zrobiła to co przypuszczalnie miała wykonać.
- B_BAD_VALUE. (GetItemInfo()) *found_name jest NULL.
- Ujemne wartości. Wystąpił błąd wysłania komunikatu.
![]() | CountItems() patrz AddItem() |
![]() | Expand() patrz Location() |
![]() | Frame() |
BRect Frame(void) const Zwraca ramkę Deskbar'a we współrzędnych ekranu.
![]() | GetItemInfo() patrz AddItem() |
![]() | HasItem() patrz AddItem() |
![]() | IsExpanded() patrz Location() |
![]() | Location() , IsExpanded() , SetLocation() , Expand() |
deskbar_location Location(bool *isExpanded=NULL) const bool IsExpanded(void) const status_t SetLocation(deskbar_location location, bool expanded=false) status_t Expand(bool expand) Location() zwraca symboliczny opis bieżącego położenia Deskbar'a; patrz deskbar_location aby zobaczyć listę zdefiniowanych położeń. isExpanded (jeśli dostarczono) jest ustawiany na true jeśli Deskbar jest rozwinięty i false jeśli jest zwinięty; IsExpanded() zwraca bezpośrednią wartość rozwinięcia. Rozwinięcie i zwinięcie jest zmienne tylko wtedy jeśli położenie Deskbar'a jest w lewym-górnym lub prawym-górnym rogu ekranu; dla wszystkich innych położeń stan rozwinięcia jest nie do zmienienia. Patrz na ilustracje deskbar_location.
SetLocation() ustawia położenie Deskbar'a i rozwija/zwija Deskbar; dla niektórych położeń rozwiniecie/zwinięcie jest niemożliwe do zmiany. Expand() rozwija/zwija Deskbar (jeśli jeśli ustawienie jest możliwe do zmienienia) bez ustawiania jego położenia. Powinieneś mieć bardzo rzadko potrzebę wywoływania tych funkcji. Przemieszczanie i rozwijanie Deskbar'a jest domeną użytkownika..
ZWRACANE KODY
SetLocation() i Expand() zwracają...
- B_OK. Nowe położenie lub żądanie rozwinięcia zostało z sukcesem przesłane do Deskbar'a. Nie jest syganlizowane, czy parametry zostały rzeczywiście wymuszone.
- Ujemne wartości. Deskbar nie jest uruchomiony lub wystąpiło kilka innych błędów przesyłania komunikatów.
![]() | RemoveItem() patrz AddItem() |
![]() | Set patrz Location() |
![]() | Deskbar Location |
Stałe deskbar_location są używane do ustawiania i zwracania położenia Deskbar'a (patrz Location()). Sześć położeń jest pokazanych na dwóch ilustracjach poniżej:
![]()
![]()
Wartości deskbar_location dotyczą stanu rozwinięcia Deskbar'a: Deskbar może być rozwinięty lub zwinięty w tylko położeniach B_DESKBAR_LEFT_TOP i B_DESKBAR_RIGHT_TOP. W innych położeniach, rozwinięcie/zwinięcie jest niemożliwe do zmiany. Ilustracje poniżej pokazują położenie Deskbar'a w prawym górnym rogu w jego rozwiniętym i zwiniętym stanie:
![]()
|
Copyright © 2000 Be, Inc. Wszelkie prawa zastrzeżone.