1 /* 2 Open Tracker License 3 4 Terms and Conditions 5 6 Copyright (c) 1991-2000, Be Incorporated. All rights reserved. 7 8 Permission is hereby granted, free of charge, to any person obtaining a copy of 9 this software and associated documentation files (the "Software"), to deal in 10 the Software without restriction, including without limitation the rights to 11 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies 12 of the Software, and to permit persons to whom the Software is furnished to do 13 so, subject to the following conditions: 14 15 The above copyright notice and this permission notice applies to all licensees 16 and shall be included in all copies or substantial portions of the Software. 17 18 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 19 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF TITLE, MERCHANTABILITY, 20 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 21 BE INCORPORATED BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN 22 AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION 23 WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24 25 Except as contained in this notice, the name of Be Incorporated shall not be 26 used in advertising or otherwise to promote the sale, use or other dealings in 27 this Software without prior written authorization from Be Incorporated. 28 29 Tracker(TM), Be(R), BeOS(R), and BeIA(TM) are trademarks or registered trademarks 30 of Be Incorporated in the United States and other countries. Other brand product 31 names are registered trademarks or trademarks of their respective holders. 32 All rights reserved. 33 */ 34 #ifndef _OPEN_WITH_WINDOW_H 35 #define _OPEN_WITH_WINDOW_H 36 37 38 // OpenWithContainerWindow supports the Open With feature 39 40 41 #include <String.h> 42 43 #include "ContainerWindow.h" 44 #include "EntryIterator.h" 45 #include "NodeWalker.h" 46 #include "PoseView.h" 47 #include "Query.h" 48 #include "SlowMenu.h" 49 #include "Utilities.h" 50 51 class BGroupView; 52 53 namespace BPrivate { 54 55 enum { 56 kUnknownRelation = -1, 57 kNoRelation = 0, 58 kSuperhandler, 59 kSupportsSupertype, 60 kSupportsType, 61 kPreferredForType, 62 kPreferredForFile 63 }; 64 65 66 class OpenWithPoseView; 67 68 // pass in a predicate; a query will search for matches 69 // matches will be returned in iteration 70 class SearchForSignatureEntryList : public EntryListBase { 71 public: 72 SearchForSignatureEntryList(bool canAddAllApps); 73 virtual ~SearchForSignatureEntryList(); 74 75 void PushUniqueSignature(const char*); 76 // add one signature to search for 77 78 // entry list iterators 79 virtual status_t GetNextEntry(BEntry* entry, bool traverse = false); 80 virtual status_t GetNextRef(entry_ref* ref); 81 virtual int32 GetNextDirents(struct dirent* buffer, size_t length, 82 int32 count = INT_MAX); 83 84 virtual status_t Rewind(); 85 virtual int32 CountEntries(); 86 87 bool GetPreferredApp(entry_ref* ref) const; 88 // gets the preferred app for all the files it was asked to 89 // find supporting apps for, returns false if no preferred app 90 // found or if more than one found 91 void TrySettingPreferredApp(const entry_ref*); 92 void TrySettingPreferredAppForFile(const entry_ref*); 93 94 int32 Relation(const BMessage* entriesToOpen, const Model*) const; 95 // returns the reason why an application is shown in 96 // Open With window 97 void RelationDescription(const BMessage* entriesToOpen, const Model*, 98 BString*) const; 99 // returns a string describing why application handles files 100 // to open 101 102 static int32 Relation(const BMessage* entriesToOpen, 103 const Model*, const entry_ref* preferredApp, 104 const entry_ref* preferredAppForFile); 105 // returns the reason why an application is shown in Open With 106 // window static version, needs the preferred app for preformance 107 static void RelationDescription(const BMessage* entriesToOpen, 108 const Model*, BString*, const entry_ref* preferredApp, 109 const entry_ref* preferredAppForFile); 110 // returns a string describing why application handles files 111 // to open 112 113 bool CanOpenWithFilter(const Model* appModel, 114 const BMessage* entriesToOpen, const entry_ref* preferredApp); 115 116 void NonGenericFileFound(); 117 bool GenericFilesOnly() const; 118 119 bool ShowAllApplications() const; 120 121 private: 122 static int32 Relation(const Model* node, const Model* app); 123 // returns the reason why an application is shown in 124 // Open With window 125 126 CachedEntryIteratorList* fIteratorList; 127 BObjectList<BString> fSignatures; 128 129 entry_ref fPreferredRef; 130 int32 fPreferredAppCount; 131 entry_ref fPreferredRefForFile; 132 int32 fPreferredAppForFileCount; 133 bool fGenericFilesOnly; 134 bool fCanAddAllApps; 135 bool fFoundOneNonSuperHandler; 136 }; 137 138 139 class OpenWithContainerWindow : public BContainerWindow { 140 public: 141 OpenWithContainerWindow(BMessage* entriesToOpen, 142 LockingList<BWindow>* windowList); 143 // <entriesToOpen> eventually get opened by the selected app 144 virtual ~OpenWithContainerWindow(); 145 146 virtual void Init(const BMessage* message); 147 virtual void InitLayout(); 148 149 const BMessage* EntryList() const; 150 // return the list of the entries we are supposed to open 151 152 void SetCanSetAppAsDefault(bool); 153 void SetCanOpen(bool); 154 155 OpenWithPoseView* PoseView() const; 156 157 protected: 158 virtual BPoseView* NewPoseView(Model* model, uint32 viewMode); 159 160 virtual bool ShouldAddMenus() const; 161 virtual void ShowContextMenu(BPoint, const entry_ref*); 162 virtual void AddShortcuts(); 163 virtual void NewAttributesMenu(BMenu*); 164 165 virtual void RestoreState(); 166 virtual void RestoreState(const BMessage&); 167 virtual void RestoreWindowState(AttributeStreamNode*); 168 virtual void RestoreWindowState(const BMessage&); 169 virtual bool NeedsDefaultStateSetup(); 170 virtual void SaveState(bool hide = true); 171 virtual void SaveState(BMessage&) const; 172 virtual void SetupDefaultState(); 173 174 virtual bool IsShowing(const node_ref*) const; 175 virtual bool IsShowing(const entry_ref*) const; 176 177 virtual void MessageReceived(BMessage*); 178 179 void OpenWithSelection(); 180 // open entries with the selected app 181 void MakeDefaultAndOpen(); 182 // open entries with the selected app and make it 183 // the default handler 184 185 private: 186 static filter_result KeyDownFilter(BMessage*, BHandler**, 187 BMessageFilter*); 188 189 BMessage* fEntriesToOpen; 190 BButton* fLaunchButton; 191 BButton* fLaunchAndMakeDefaultButton; 192 BButton* fCancelButton; 193 194 BGroupView* fButtonContainer; 195 196 typedef BContainerWindow _inherited; 197 }; 198 199 200 class OpenWithPoseView : public BPoseView { 201 public: 202 OpenWithPoseView(); 203 virtual ~OpenWithPoseView(); 204 205 virtual void OpenSelection(BPose*, int32*); 206 // open entries with the selected app 207 208 int32 OpenWithRelation(const Model*) const; 209 // returns the reason why an application is shown in 210 // Open With window 211 void OpenWithRelationDescription(const Model*, BString*) const; 212 // returns a string describing why application handles files 213 // to open 214 215 OpenWithContainerWindow* ContainerWindow() const; 216 217 virtual bool AddPosesThreadValid(const entry_ref*) const; 218 219 protected: 220 // don't do any volume watching and memtamime watching in open with 221 // panels for now 222 virtual void InitialStartWatching() {} 223 virtual void FinalStopWatching() {} 224 225 virtual void AttachedToWindow(); 226 virtual rgb_color TextColor(bool selected = false) const; 227 virtual rgb_color BackColor(bool selected = false) const; 228 virtual EntryListBase* InitDirentIterator(const entry_ref* ref); 229 virtual void ReturnDirentIterator(EntryListBase* iterator); 230 231 virtual void SetupDefaultColumnsIfNeeded(); 232 // show launch window specific columns 233 234 // empty overrides for functions that depend on having an fModel 235 virtual void SaveState(AttributeStreamNode*); 236 virtual void RestoreState(AttributeStreamNode*); 237 virtual void SaveState(BMessage&) const; 238 virtual void RestoreState(const BMessage&); 239 virtual void SavePoseLocations(BRect* = NULL); 240 virtual void MoveSelectionToTrash(bool selectNext = true); 241 virtual void MoveSelectionTo(BPoint, BPoint, BContainerWindow*); 242 virtual void MoveSelectionInto(Model* destFolder, 243 BContainerWindow* srcWindow, bool forceCopy, 244 bool create_link = false); 245 virtual bool HandleMessageDropped(BMessage*); 246 virtual bool CanHandleDragSelection(const Model*, const BMessage*, 247 bool); 248 249 virtual bool Represents(const node_ref*) const; 250 virtual bool Represents(const entry_ref*) const; 251 252 virtual void CreatePoses(Model** models, PoseInfo* poseInfoArray, 253 int32 count, BPose** resultingPoses, bool insertionSort = true, 254 int32* lastPoseIndexPtr = NULL, BRect* boundsPtr = NULL, 255 bool forceDraw = false); 256 // override to add selecting the default handling app 257 // for selection 258 259 virtual void Pulse(); 260 261 virtual void KeyDown(const char* bytes, int32 count); 262 263 private: 264 entry_ref fPreferredRef; 265 bool fHaveCommonPreferredApp; 266 267 SearchForSignatureEntryList* fIterator; 268 BRefFilter* fRefFilter; 269 270 typedef BPoseView _inherited; 271 }; 272 273 274 class OpenWithRefFilter: public BRefFilter { 275 public: 276 OpenWithRefFilter(SearchForSignatureEntryList*, const BMessage*, 277 entry_ref*); 278 bool Filter(const entry_ref* ref, BNode* node, stat_beos* st, 279 const char* filetype); 280 281 private: 282 SearchForSignatureEntryList* fIterator; 283 const BMessage *fEntryList; 284 entry_ref* fPreferredRef; 285 }; 286 287 288 class RelationCachingModelProxy { 289 public: 290 RelationCachingModelProxy(Model* model); 291 ~RelationCachingModelProxy(); 292 293 int32 Relation(SearchForSignatureEntryList* iterator, 294 BMessage* entries) const; 295 296 Model* fModel; 297 mutable int32 fRelation; 298 }; 299 300 301 class OpenWithMenu: public BSlowMenu { 302 public: 303 OpenWithMenu(const char* label, const BMessage* entriesToOpen, 304 BWindow* parentWindow, BHandler* target); 305 OpenWithMenu(const char* label, const BMessage* entriesToOpen, 306 BWindow* parentWindow, const BMessenger &target); 307 308 private: 309 friend int SortByRelation(const RelationCachingModelProxy*, 310 const RelationCachingModelProxy*, void*); 311 friend int SortByName(const RelationCachingModelProxy*, 312 const RelationCachingModelProxy*, void*); 313 friend int SortByRelationAndName(const RelationCachingModelProxy*, 314 const RelationCachingModelProxy*, void*); 315 316 virtual bool StartBuildingItemList(); 317 virtual bool AddNextItem(); 318 virtual void DoneBuildingItemList(); 319 virtual void ClearMenuBuildingState(); 320 321 BMessage fEntriesToOpen; 322 BHandler* target; 323 BMessenger fMessenger; 324 325 // menu building state 326 SearchForSignatureEntryList* fIterator; 327 entry_ref fPreferredRef; 328 BObjectList<RelationCachingModelProxy>* fSupportingAppList; 329 bool fHaveCommonPreferredApp; 330 BWindow* fParentWindow; 331 332 typedef BSlowMenu _inherited; 333 }; 334 335 336 // used for optionally showing the list of all apps. Do nothing 337 // until asked to iterate and only if supposed to do so 338 class ConditionalAllAppsIterator : public EntryListBase { 339 public: 340 ConditionalAllAppsIterator(SearchForSignatureEntryList* parent); 341 ~ConditionalAllAppsIterator(); 342 343 virtual status_t GetNextEntry(BEntry* entry, bool traverse = false); 344 virtual status_t GetNextRef(entry_ref* ref); 345 virtual int32 GetNextDirents(struct dirent* buffer, size_t length, 346 int32 count = INT_MAX); 347 348 virtual status_t Rewind(); 349 virtual int32 CountEntries(); 350 351 protected: 352 bool Iterate() const; 353 void Instantiate(); 354 355 private: 356 SearchForSignatureEntryList* fParent; 357 BTrackerPrivate::TWalker* fWalker; 358 }; 359 360 } // namespace BPrivate 361 362 using namespace BPrivate; 363 364 365 #endif // _OPEN_WITH_WINDOW_H 366