Be Book Application Kit Application Kit Indeks

BMessageRunner

Pochodzi od: żaden
Zadeklarowany w:  be/app/MessageRunner.h
Biblioteka: libbe.so
Alokacja: tylko konstruktor
Podsumowanie:  więcej...

Klasa BMessageRunner dostarcza klasa dostarcza poręcznego mechanizmu do automatycznego wysyłania pomocniczego komunikatu do BMessenger w określonych odstępach czasu. Aplikacja, która tworzy BMessageRunner może określić komunikat BMessenger do wysyłania komunikatu, jak często wysłać komunikat i jak wiele razy powinien on zostać wysłany.

Lista systemowa (roster) obsługuje aktualnie wysyłane komunikaty do właściwych obiektów BMessengers w wymaganych przedziałach czasu; ta klasa po prostu działa jako pośrednik, dzięki któremu twoja aplikacja pyta listę, aby mogła zaplanować wysyłanie komunikatów.


Konstruktor i Destruktor


BMessageRunner()

BMessageRunner(BMessenger target, const BMessage *message,
      bigtime_t interval, int32 count = -1)
BMessageRunner(BMessenger target, const BMessage *message,
      bigtime_t interval, int32 count, BMessenger replyTo)

Każe liście systemowej (roster), wysłać określony komunikat message do docelowego target BMessenger'a co kązdy okres interval czasu podany w mikrosekundach. KOmunikat będzie wysłany count razy (jeśli count jest równe -1, komunikat będzie wysyłany zawsze lub dopóki BMessageRunner nie zodstanie skonfigurowany ponownie lub usunięty).

Drugi z konstruktorów pozwala aplikacji określić, w argumencie replyTo, obiekt BMessenger do którego będą wysyłane odpowiedzi na komunikat.

BMessageRunner może być rekonfigurowany (przez zmianę interval lub count) przez wywołanie SetInterval() i SetCount().

Po skonstruowaniu BMessageRunner'a, powinieneś wywołać InitCheck() aby upewnić się, że obiekt został utworzony właściwie.


~BMessageRunner()

virtual ~BMessageRunner()

Prosi listę systemową (roster) aby zatrzymała wysyłanie komunikatu.


Funkcje Członkowskie


GetInfo()

status_t GetInfo(bigtime_t *interval, int32 *count) const

GetInfo() zwraca w argumencie interval , czas podany w mikrosekundach który minie pomiędzy wysyłanymi komunikatami oraz krotność wysyłania komuniatu w argumencie count.

ZWRACANE KODY


InitCheck()

status_t InitCheck(void) const

InitCheck() zwraca kod wyniku wskazujący B_OK jeśli konstruktor BMessageRunner'a wykonał się z sukcesem lub jakąś inna wartość, jeśli wystąpił błąd konfigurowania obiektu. Powinieneś wywołać ją natychmiast po utworzeniu BMessageRunner i nie powinien używać obiektu, jeśli ta funkcja zwróci cokolwiek innego oprócz B_OK.


SetCount() , SetInterval()

status_t SetCount(int32 count)
status_t SetInterval(bigtime_t interval)

SetCount() ustawia krotność z jaką BMessageRunner będzie wysyłał komunikat. Jeśli chcesz wysyłać komunikat zawsze (dopóki obiekt nie zostanie zniszczony lub funkcja SetCount() nie zostanie wywołana ponownie), określ -1.

SetInterval() ustawia liczbę mikrosekund które będą upływać pomiędzy rozpoczęciem wysyłania komunikatów.


Be Book Application Kit Application Kit Indeks

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

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