Be Book

BDeskbar

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.


Konstruktor and destruktor


BDeskbar() , ~Deskbar()

BDeskbar(void)
~BDeskbar()

Konstruktor tworzy i zwraca nowy obiekt BDeskbar. Destruktor usuwa go.


Funkcje członkowskie


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) const
status_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


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ą...


RemoveItem()  patrz AddItem()
Set  patrz Location()


Stałe Deskbar'a


Deskbar Location
Stała enum deskbar_location Znaczenie
B_DESKBAR_TOP Rozwinięty (tylko) wzdłuż górnej krawędzi.
B_DESKBAR_BOTTOM Rozwinięty (tylko) wzdłuż dolnej krawędzi.
B_DESKBAR_LEFT_BOTTOM Zwinięty (tylko) w dolnym lewym rogu.
B_DESKBAR_RIGHT_BOTTOM Zwinięty (tylko) w dolnym prawym rogu.
B_DESKBAR_LEFT_TOP W lewym górnym rogu (rozwinięty lub zwinięty).
B_DESKBAR_RIGHT_TOP W prawym górnym rogu (rozwinięty lub zwinięty).

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:


Be Book

Be Book,
...w ślicznym HTML...
dla BeOS wydanie 5

Copyright © 2000 Be, Inc. Wszelkie prawa zastrzeżone.