From ad467109d4bb220e713e902285439295d49b4f34 Mon Sep 17 00:00:00 2001 From: Ingo Weinhold Date: Sun, 21 Jul 2002 22:42:46 +0000 Subject: [PATCH] Uglified the header according to the OT style. git-svn-id: file:///srv/svn/repos/haiku/trunk/current@376 a95241bf-73f2-0310-859d-f6bbb57e9c96 --- headers/os/app/Roster.h | 296 ++++++++++++++++++++-------------------- 1 file changed, 145 insertions(+), 151 deletions(-) diff --git a/headers/os/app/Roster.h b/headers/os/app/Roster.h index c36bb2a549..5f865ffc85 100644 --- a/headers/os/app/Roster.h +++ b/headers/os/app/Roster.h @@ -1,15 +1,31 @@ -/****************************************************************************** -/ -/ File: Roster.h -/ -/ Description: BRoster class lets you launch apps and keeps -/ track of apps that are running. -/ Global be_roster represents the default BRoster. -/ app_info structure provides info for a running app. -/ -/ Copyright 1995-98, Be Incorporated, All Rights Reserved. -/ -******************************************************************************/ +//------------------------------------------------------------------------------ +// Copyright (c) 2001-2002, OpenBeOS +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the "Software"), +// to deal in the Software without restriction, including without limitation +// the rights to use, copy, modify, merge, publish, distribute, sublicense, +// and/or sell copies of the Software, and to permit persons to whom the +// Software is furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +// DEALINGS IN THE SOFTWARE. +// +// File Name: Roster.h +// Author: Ingo Weinhold (bonefish@users.sf.net) +// Description: BRoster class lets you launch apps and keeps +// track of apps that are running. +// Global be_roster represents the default BRoster. +// app_info structure provides info for a running app. +//------------------------------------------------------------------------------ #ifndef _ROSTER_H #define _ROSTER_H @@ -29,8 +45,8 @@ extern "C" int _init_roster_(); /* --------- app_info Struct and Values ------------------------ */ struct app_info { - app_info(); - ~app_info(); + app_info(); + ~app_info(); thread_id thread; team_id team; @@ -52,9 +68,9 @@ struct app_info { enum { - B_REQUEST_LAUNCHED = 0x00000001, - B_REQUEST_QUIT = 0x00000002, - B_REQUEST_ACTIVATED = 0x00000004 + B_REQUEST_LAUNCHED = 0x00000001, + B_REQUEST_QUIT = 0x00000002, + B_REQUEST_ACTIVATED = 0x00000004 }; enum { @@ -68,152 +84,130 @@ enum { class BRoster { public: - BRoster(); - ~BRoster(); + BRoster(); + ~BRoster(); -/* Querying for apps */ - bool IsRunning(const char *mime_sig) const; - bool IsRunning(entry_ref *ref) const; - team_id TeamFor(const char *mime_sig) const; - team_id TeamFor(entry_ref *ref) const; - void GetAppList(BList *team_id_list) const; - void GetAppList(const char *sig, BList *team_id_list) const; - status_t GetAppInfo(const char *sig, app_info *info) const; - status_t GetAppInfo(entry_ref *ref, app_info *info) const; - status_t GetRunningAppInfo(team_id team, app_info *info) const; - status_t GetActiveAppInfo(app_info *info) const; - status_t FindApp(const char *mime_type, entry_ref *app) const; - status_t FindApp(entry_ref *ref, entry_ref *app) const; + /* Querying for apps */ + bool IsRunning(const char *mimeSig) const; + bool IsRunning(entry_ref *ref) const; + team_id TeamFor(const char *mimeSig) const; + team_id TeamFor(entry_ref *ref) const; + void GetAppList(BList *teamIDList) const; + void GetAppList(const char *sig, BList *teamIDList) const; + status_t GetAppInfo(const char *sig, app_info *info) const; + status_t GetAppInfo(entry_ref *ref, app_info *info) const; + status_t GetRunningAppInfo(team_id team, app_info *info) const; + status_t GetActiveAppInfo(app_info *info) const; + status_t FindApp(const char *mimeType, entry_ref *app) const; + status_t FindApp(entry_ref *ref, entry_ref *app) const; -/* Launching, activating, and broadcasting to apps */ - status_t Broadcast(BMessage *msg) const; - status_t Broadcast(BMessage *msg, BMessenger reply_to) const; - status_t StartWatching(BMessenger target, - uint32 event_mask = B_REQUEST_LAUNCHED | B_REQUEST_QUIT) const; - status_t StopWatching(BMessenger target) const; - status_t ActivateApp(team_id team) const; - status_t Launch(const char *mime_type, BMessage *initial_msgs = NULL, - team_id *app_team = NULL) const; - status_t Launch(const char *mime_type, BList *message_list, - team_id *app_team = NULL) const; - status_t Launch(const char *mime_type, int argc, char **args, - team_id *app_team = NULL) const; + /* Launching, activating, and broadcasting to apps */ + status_t Broadcast(BMessage *msg) const; + status_t Broadcast(BMessage *msg, BMessenger replyTo) const; + status_t StartWatching(BMessenger target, + uint32 eventMask = B_REQUEST_LAUNCHED | B_REQUEST_QUIT) const; + status_t StopWatching(BMessenger target) const; + status_t ActivateApp(team_id team) const; - status_t Launch(const entry_ref *ref, const BMessage *initial_message = NULL, - team_id *app_team = NULL) const; - status_t Launch(const entry_ref *ref, const BList *message_list, - team_id *app_team = NULL) const; - status_t Launch(const entry_ref *ref, int argc, const char * const *args, - team_id *app_team = NULL) const; + status_t Launch(const char *mimeType, BMessage *initialMsgs = NULL, + team_id *appTeam = NULL) const; + status_t Launch(const char *mimeType, BList *messageList, + team_id *appTeam = NULL) const; + status_t Launch(const char *mimeType, int argc, char **args, + team_id *appTeam = NULL) const; + status_t Launch(const entry_ref *ref, + const BMessage *initialMessage = NULL, + team_id *app_team = NULL) const; + status_t Launch(const entry_ref *ref, const BList *messageList, + team_id *appTeam = NULL) const; + status_t Launch(const entry_ref *ref, int argc, const char * const *args, + team_id *appTeam = NULL) const; -/* Recent document and app support */ - void GetRecentDocuments(BMessage *refList, int32 maxCount, - const char *ofType = NULL, - const char *openedByAppSig = NULL) const; - void GetRecentDocuments(BMessage *refList, int32 maxCount, - const char *ofTypeList[], int32 ofTypeListCount, - const char *openedByAppSig = NULL) const; - void GetRecentFolders(BMessage *refList, int32 maxCount, - const char *openedByAppSig = NULL) const; - void GetRecentApps(BMessage *refList, int32 maxCount) const; + /* Recent document and app support */ + void GetRecentDocuments(BMessage *refList, int32 maxCount, + const char *ofType = NULL, + const char *openedByAppSig = NULL) const; + void GetRecentDocuments(BMessage *refList, int32 maxCount, + const char *ofTypeList[], int32 ofTypeListCount, + const char *openedByAppSig = NULL) const; + void GetRecentFolders(BMessage *refList, int32 maxCount, + const char *openedByAppSig = NULL) const; + void GetRecentApps(BMessage *refList, int32 maxCount) const; - void AddToRecentDocuments(const entry_ref *doc, - const char *appSig = NULL) const; - void AddToRecentFolders(const entry_ref *folder, - const char *appSig = NULL) const; + void AddToRecentDocuments(const entry_ref *doc, + const char *appSig = NULL) const; + void AddToRecentFolders(const entry_ref *folder, + const char *appSig = NULL) const; /*----- Private or reserved ------------------------------*/ private: + friend class BApplication; + friend class BWindow; + friend class _BAppCleanup_; + friend int _init_roster_(); + friend status_t _send_to_roster_(BMessage *, BMessage *, bool); + friend bool _is_valid_roster_mess_(bool); + friend status_t BMimeType::StartWatching(BMessenger); + friend status_t BMimeType::StopWatching(BMessenger); + friend status_t BClipboard::StartWatching(BMessenger); + friend status_t BClipboard::StopWatching(BMessenger); -friend class BApplication; -friend class BWindow; -friend class _BAppCleanup_; -friend int _init_roster_(); -friend status_t _send_to_roster_(BMessage *, BMessage *, bool); -friend bool _is_valid_roster_mess_(bool); -friend status_t BMimeType::StartWatching(BMessenger); -friend status_t BMimeType::StopWatching(BMessenger); -friend status_t BClipboard::StartWatching(BMessenger); -friend status_t BClipboard::StopWatching(BMessenger); + enum mtarget { + MAIN_MESSENGER, + MIME_MESSENGER, + USE_GIVEN + }; - enum mtarget { - MAIN_MESSENGER, - MIME_MESSENGER, - USE_GIVEN - }; + status_t _StartWatching(mtarget target, BMessenger *rosterMess, + uint32 what, BMessenger notify, + uint32 event_mask) const; + status_t _StopWatching(mtarget target, BMessenger *rosterMess, uint32 what, + BMessenger notify) const; + uint32 AddApplication(const char *mimeSig, entry_ref *ref, uint32 flags, + team_id team, thread_id thread, port_id port, + bool fullReg) const; + void SetSignature(team_id team, const char *mimeSig) const; + void SetThread(team_id team, thread_id thread) const; + void SetThreadAndTeam(uint32 entry_token, thread_id thread, + team_id team) const; + void CompleteRegistration(team_id team, thread_id, port_id port) const; + bool IsAppPreRegistered(entry_ref *ref, team_id team, + app_info *info) const; + void RemovePreRegApp(uint32 entryToken) const; + void RemoveApp(team_id team) const; - status_t _StartWatching(mtarget t, BMessenger *roster_mess, uint32 what, - BMessenger notify, uint32 event_mask) const; - status_t _StopWatching(mtarget t, BMessenger *roster_mess, uint32 what, - BMessenger notify) const; - uint32 AddApplication( const char *mime_sig, - entry_ref *ref, - uint32 flags, - team_id team, - thread_id thread, - port_id port, - bool full_reg) const; - void SetSignature(team_id team, const char *mime_sig) const; - void SetThread(team_id team, thread_id tid) const; - void SetThreadAndTeam(uint32 entry_token, - thread_id tid, - team_id team) const; - void CompleteRegistration(team_id team, - thread_id, - port_id port) const; - bool IsAppPreRegistered( entry_ref *ref, - team_id team, - app_info *info) const; - void RemovePreRegApp(uint32 entry_token) const; - void RemoveApp(team_id team) const; + status_t xLaunchAppPrivate(const char *mimeSig, const entry_ref *ref, + BList* msgList, int cargs, char **args, + team_id *appTeam) const; + bool UpdateActiveApp(team_id team) const; + void SetAppFlags(team_id team, uint32 flags) const; + void DumpRoster() const; + status_t resolve_app(const char *inType, const entry_ref *ref, + entry_ref *appRef, char *appSig, uint32 *appFlags, + bool *wasDocument) const; + status_t translate_ref(const entry_ref *ref, BMimeType *appMeta, + entry_ref *appRef, BFile *appFile, char *appSig, + bool *wasDocument) const; + status_t translate_type(const char *mimeType, BMimeType *meta, + entry_ref *appRef, BFile *appFile, + char *appSig) const; + status_t sniff_file(const entry_ref *file, BNodeInfo *finfo, + char *mimeType) const; + bool is_wildcard(const char *sig) const; + status_t get_unique_supporting_app(const BMessage *apps, + char *outSig) const; + status_t get_random_supporting_app(const BMessage *apps, + char *outSig) const; + char **build_arg_vector(char **args, int *pargs, const entry_ref *appRef, + const entry_ref *docRef) const; + status_t send_to_running(team_id team, const entry_ref *appRef, + int cargs, char **args, const BList *msgList, + const entry_ref *ref) const; + void InitMessengers(); - status_t xLaunchAppPrivate( const char *mime_sig, - const entry_ref *ref, - BList* msg_list, - int cargs, - char **args, - team_id *app_team) const; - bool UpdateActiveApp(team_id team) const; - void SetAppFlags(team_id team, uint32 flags) const; - void DumpRoster() const; - status_t resolve_app(const char *in_type, - const entry_ref *ref, - entry_ref *app_ref, - char *app_sig, - uint32 *app_flags, - bool *was_document) const; - status_t translate_ref(const entry_ref *ref, - BMimeType *app_meta, - entry_ref *app_ref, - BFile *app_file, - char *app_sig, - bool *was_document) const; - status_t translate_type(const char *mime_type, - BMimeType *meta, - entry_ref *app_ref, - BFile *app_file, - char *app_sig) const; - status_t sniff_file(const entry_ref *file, - BNodeInfo *finfo, - char *mime_type) const; - bool is_wildcard(const char *sig) const; - status_t get_unique_supporting_app(const BMessage *apps, - char *out_sig) const; - status_t get_random_supporting_app(const BMessage *apps, - char *out_sig) const; - char **build_arg_vector(char **args, int *pargs, - const entry_ref *app_ref, - const entry_ref *doc_ref) const; - status_t send_to_running(team_id tema, - const entry_ref *app_ref, - int cargs, char **args, - const BList *msg_list, - const entry_ref *ref) const; - void InitMessengers(); - - BMessenger fMess; - BMessenger fMimeMess; - uint32 _fReserved[3]; + BMessenger fMess; + BMessenger fMimeMess; + uint32 _fReserved[3]; }; /*-----------------------------------------------------*/