Be Book Wygaszacz Ekranu Indeks Wygaszacza Ekranu

Wtyczki wygaszacza ekranu

Zadeklarowany w:  be/add-ons/screen_saver/ScreenSaver.h
Biblioteka: aplikacja preferencji ScreenSaver
więcej...

 

Wtyczka wygaszacza ekranu ucieleśnia pojedynczy moduł wygaszacza ekranu. Każdy moduł jest reprezentowany przez obiekt BScreenSaver. W celu utworzenia tego obiektu wtyczka implementuje i eksportuje funkcję instantiate_screen_saver(). System wygaszacza ekranu wywołuje funkcję instantiate_screen_saver() gdy jest czas na utworzenie i uruchomienie modułu wtyczki wygaszacza ekranu.


Budowanie i instalowanie Twojej wtyczki

Kiedy budujesz swoją wtyczkę (add-on) potrzebujesz, połaczyć się z aplikacją preferencji ScreenSaver (wygaszacz ekranu). To co zrobisz...

Instalujesz swoje wtyczki wygaszacza w katalogu wygaszaczy ekranu w B_USER_ADDONS_DIRECTORY; być może najpierw będziesz potrzebował utworzyć katalog wygaszaczy ekranu. (Patrz do find_directory() w Storage Kit, jeśli nie jesteś zaznajomiony ze stałą B_USER_ADDONS_DIRECTORY.)

Katalog wygaszaczy ekranu jest również w B_BEOS_ADDONS_DIRECTORY. Jest on zarezerwowany dla wygaszaczy ekranu które są dostarczane razem z BeOS'em. Nie umieszczaj swoich wygaszaczy ekranu w tym katalogu.


Funkcje globalne


instantiate_screen_saver()


BScreenSaver *instantiate_screen_saver(BMessage *msg, image_id image)

instantiate_screen_saver() musi być zaimplementowana do tworzenia egzemplarza Twojej klasy pochodnej od BScreenSaver i zwracania wartości jako wskaźnika do obiektu BScreenSaver. msg zawiera stan przekazany przez poprzedni działający wygaszacz (poprzez funkcję SaveState()). image jest identyfikatorem image_id wtyczki (add-on). Zwykle przekazuje sz te argumenty bezpośrednio do konstruktora Twojej podklasy BScreenSaver, jak tutaj:

#include <add-ons/screen_saver/ScreenSaver.h>

class SpiffySaver : public BScreenSaver
{
public:
   SpiffySaver( BMessage *msg, image_id image );
...
};

BScreenSaver *instantiate_screen_saver(BMessage *msg, image_id image)
{
   return new SpiffySaver(msg, id);
}

System wygaszacza ekranu obsługuje za Ciebie złe alokacje obiektu. To znaczy, że nie musisz przechwytywac wyjątków bad_alloc w swoim własnym kodzie. (Jeśli system ma mało zasobów, użytkownik ma inne zmartwienia.)


Be Book Wygaszacz Ekranu Indeks Wygaszacza Ekranu

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

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