Be Book Komunikaty Indeks komunikatów

Wprowadzenie do systemu komunikatów

Ten rozdział opisuje komunikaty, które są zdefiniowane przez Be. Zawiera on komunikaty które sa wysyłane z systemu do Twojej aplikacji, komunikaty które Twoja aplikacja może tworzyć i wysyłać do innych aplikacji (i serwerów) i komunikaty które są zdefiniowane dla ich formatów ale których Ty dosłownie nie wyślesz nigdzie (takie jak format komunikatu schowka).

Większość komunikatow jest wymieniona przez ich stałe poleceń (B_ABOUT_REQUESTED, B_QUIT_REQUESTED, itd.). Tam gdzie stała polecenia nie jest wystarczająco określona, komunikat jest wymieniony przez jakieś inne pole. Dla przykladu, każdy komunikat Node Monitor (monitora węzła) ma stałą polecenia B_NODE_MONITOR i jest dalej wyróżniony i wymieniony poniżej przez jego wartość pola "opcode" (kod operacji) (B_ENTRY_REMOVED, B_STAT_CHANGED, itd.). Jeśli komunikat nie ma zdefiniowanej stałej polecenia lub innego pola opisowego, jest on identyfikowany poprzez opis (przykładowo: "Clipboard Data").


Czytanie opisu komunikatu

Każda pozycja komunikatu stosuje taki format:

Zamiar: Tells you whether the message is meant to be delivered ("Deliverable"), or if it's defined simply for its format ("Format"). A message can be both: It can be used as a deliverable by one part of the system, and used just for its format in another.

If the message is deliverable, it will describe the following:

Źródło: Nadawca komunikatu. Ważnym punktem jest tutajto, czy komunikat jest wysłany przez systemczy przez Twoją aplikację, albo przez oba. Jeśli linia "Source:" (źródła) nie wspomina że twoja aplikacja może wysłać komunikat, wtedy go nie wysyłasz. Często źródło jest wymienione, Often the source is listed, ogólnikowo, jako "system." skazuje To, że komunikat jest wysłany do jednego z podstawowych serwerów ( głównieApp Server lub Input Server,). Inne źródła ( Node Monitor, Roster Monitor, Monitor MIME) jest zindentyfikowany dokładniej. W każdym razie tożsamość źródła jest dostarczona głównie po to, żebyś wiedział, na którym boisku do gry jesteś - dokładna tożsamość nie powinna mieć znaczenia dla Twojego kodu.
Target: Adresat komunikatu. Jest to obiekt BHandler, który odbiera komunikat i jeśli jest odpowiedni konwertuje go do funkcji przechwytującej. Przykładowo, adresat komunikatu B_VIEW_MOVED jest widokiem obiektu BWindow, nie samym obiektem BView (ponieważ BView właciwie nigdy nie widzi komunikatu B_VIEW_MOVED - on widzi tylko funkcję przechwytującą ViewMoved()).Adresat jest też często be_app (aplikacją, dostępną pod tą globalną zmienną - przyp. tłum.) lub obiektem BWindow ale dla samych komunikatów adresat jest zadeklarowany przez Twoją aplikację (na przykład adresat komunikatu wywołania obiektu BControl).
Hak: Funkcja przechwytująca (określana czasem także jako funkcja haka - przyp. tłum.) Funkcja przechwytująca, która wywołuje adresata gdy komunikat jest odbierany. Jeśli ta linia jest nieobecna, komunikat nie jest mapowany do funkcji przechwytującej (czyli nie jest przekształcany na argumenty "strawne" dla funkcji przechwytującej - przyp. tłum.).

Jest to zastosowane przez zwięzły opis, który mówi Ci o warunkach w jakich komunikat jest wysłany i jakie jest oczekiwane zachowanie Twojej aplikacji kiedy odbiera ona komunikat. Jeśli opis nie mówi co założono, że powinna zrobić Twoja aplikacja, wtedy nie musi ona nic robić ale nie powinna ona przeszkadzać w domyślnym mechanizmie.

Po opisie jest tabela, która wymienia pola komunikatu zdefiniowanego przez Be. Jeżeli nie ma on żadnego pola, tabela jest wyłączona. Jeśli pole przechowuje tablicę danych, maksymalny rozmiar tablicy, jeśli jest znany, jest dany w nawiasach po nazwie pola:

"byte" [3]

W pewnych przypadkach, rozmiar tablicy jest wartością jakiegoś innego pola. Tutaj, rozmiar tablicy w polu "argv" jest dany przez wartość pola "argc":

"argv" ["argc"]


Be Book Komunikaty Indeks komunikatów

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

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