LibClipartSGallery Class Reference

The LibClipart SuperGallery class. More...

#include <sglcart.h>

Inheritance diagram for LibClipartSGallery:

List of all members.

Public Member Functions
	LibClipartSGallery ()
	LibClipartSGallery default constructor.
	~LibClipartSGallery ()
	LibClipartSGallery destructor.
INT32	GetClipTheme () const
INT32	SetClipTheme (INT32 nNewIndex)
virtual BOOL	IsLibraryGalleryWithNonLibraryGroups (void)
	To check if we're a dedicated library gallery, or a half+half (like the font gallery).
virtual MsgResult	Message (Msg *Message)
	A standard message handler, really.
void	ProfileRedraw (ReDrawInfoType *Param)
virtual BOOL	CanSearchKeywords (void)
	Used to determine if this type of gallery supports keyword searching. This one does.
virtual SGDisplayGroup *	AddLibraryGroup (Library *LibraryToDisplay, INT32 NumItems)
	Create a library group, as opposed to a display group Notes:.
virtual BOOL	CanCreateIndexes (void)
	To determine if this gallery can generate indexes or not.
virtual BOOL	GetDefaults (String_256 *DefaultIndex, String_256 *IndexDesc, SGLibType *Type)
	To determine various library gallery default properties.
virtual BOOL	GetLibraryDirectoryName (String_256 *LibDirName)
	Get the default CD directory name for the gallery.
virtual BOOL	CheckForIndexMatch (StringBase *Txt)
	To see whether we should add this line of the index.txt file to this gallery.
virtual void	WorkOutSectionName (String_256 *Section)
	Returns the section name to use in the grm file.
virtual BOOL	GetQuietStatus (void)
	Get the Quiet status of the gallery.
virtual void	SetQuietStatus (BOOL Status)
	Set the Quiet status of the gallery.
virtual BOOL	ScanForLocation (SGLibType Type, StringBase *Result)
	Searches all the drives for a CDROM drive. If it finds the Camelot CD mount here at Xara HQ, we point to that instead. Notes:.
virtual BOOL	InitMenuCommands (void)
	Initialises any menu commands that this gallery needs.
virtual BOOL	BuildCommandMenu (GalleryContextMenu *TheMenu, SGMenuID MenuID)
	To build a menu of commands to be popped up over the gallery.
virtual OpState	GetCommandState (StringBase *CommandID, String_256 *ShadeReason)
	To determine the state of a given menu item. This method is an exact parallel to an Op's GetState method (in fact, it is called by an Op's GetState).
virtual void	DoCommand (StringBase *CommandID)
	To apply a given command when it is chosen from the menu.
virtual SGLibType	GetGalleryType ()
virtual String_256 *	GetDefaultLibraryPath ()
void	SelectionHasChanged (void)
	To inform the gallery that the selection has changed in some way. We need to grey different buttons on different occasions Notes:.
void	ModeHasChanged (void)
	To toggle the visible/selectable items of this gallery between clipart and web themes Notes:.
virtual BOOL	PreCreate (void)
	The LibClipartSGallery PreCreate handler. This overrides the base class PreCreate function. It is called at the very beginning of the SuperGallery::Create method, before the window has been created.
virtual BOOL	OnGetButtonClicked (void)
	Attempts to download the main web resource index file from our web site, parse it and create corresponding gallery folders.
virtual BOOL	RemoveWebFolders (SGLibType type)
	Reclaims space taken up by downloaded files of a certain type on the local machine.
Static Public Member Functions
static LibClipartSGallery *	Instance ()
static BOOL	Init (void)
static BOOL	ImportClipart (BOOL NewDocument, LibraryGallery *pSourceGallery)
	To load/import all the selected clipart items one by one into camelot. Notes:.
Public Attributes
bool	m_bRedraw
bool	m_bRestore
Static Public Attributes
static String_256	DefaultLibraryPath = ClipartPath
static String_256	ClipartPath = TEXT("D:\\clipart")
static String_256	WebThemePath = TEXT("D:\\themes")
static INT32	DefaultDisplayMode = 0
static UINT32	DefaultSortKeys = 1
static String_256	BatchSaveLocation = ""
static BOOL	DoSounds = TRUE
static LibClipartSGallery *	ThisGallery = NULL
static BOOL	QuietStatus = FALSE
Protected Member Functions
void	DoShadeGallery (BOOL ShadeIt)
	To un-grey the options... button when there are no docs Notes:.
virtual BOOL	ApplyAction (SGActionType Action)
	Applies certain conventional gallery actions (usually associated with gallery buttons, for new, edit, delete, etc).
virtual SGDisplayItem *	AddLibraryItem (SGDisplayGroup *LibraryGroup, Library *ParentLib, LibraryIndex ItemIndex, BOOL bNew=FALSE)
	Called by the Library class to create a display item for every item in a newly-scanned library file. It is essentially a callback to the gallery which requested that the library be scanned.
BOOL	LoadAndSave (void)
	To load all the selected clipart items one by one into camelot and then to save them out again - useful for updating documents.
void	HandleDragStart (DragMessage *DragMsg)
	Checks a DragMessage to see if it is a colour drag. If it is, then it creates a drag target for this gallerys listbox.
SGDisplayItem *	CopyDisplayItem (SGDisplayItem *SourceItem, SGDisplayGroup *DestGroup, SGDisplayItem *TargetPosition)
	"Copies" the existing node in the tree in an appropriate fashion.
BOOL	BrowseClicked (void)
	Pops up the browse box and lets a new location be set for the clipart directory.
void	SortGallery (void)
	Sorts the contents of the gallery in an alphabetical fashion, whilst keeping the old sort key status... Notes:.
Private Attributes
INT32	m_nClipTheme
Static Private Attributes
static LibClipartSGallery *	m_pInstance = 0

---

Detailed Description

The LibClipart SuperGallery class.

Author:

Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> (Based on template code by Jason)

Date:

27/1/95 (Based on the Colour SGallery code)

Notes: SuperGalleries are specced in a number of docs including specs.doc ("super" gallery extensions) specs.doc (gallery basic ui) There is also howtouse.doc which describes creating a supergallery

See also:

SuperGallery; SGDisplayLibClipart; LibraryGallery

Definition at line 130 of file sglcart.h.

---

Constructor & Destructor Documentation

LibClipartSGallery::LibClipartSGallery (   )

LibClipartSGallery default constructor. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 27/1/95 (base generated in sgbase.cpp) Definition at line 249 of file sglcart.cpp. { LibClipartSGallery::ThisGallery = this; m_bDiscardWebFolders = FALSE; // Default gallery size CSize Size(((333 * 2) - 32) - 32, 256); SetGallerySize(Size); m_pInstance = this; m_nClipTheme = 0; m_bRedraw = false; }

LibClipartSGallery::~LibClipartSGallery (   )

LibClipartSGallery destructor. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 27/1/95 (base generated in sgbase.cpp) Definition at line 273 of file sglcart.cpp. { TRACEUSER( "Matt", _T("~LibClipartSGallery\n")); OpenLibFiles.DeleteAll(); // Ensure all open libraries are closed LibClipartSGallery::ThisGallery = NULL; m_pInstance = 0; }

---

Member Function Documentation

SGDisplayGroup * LibClipartSGallery::AddLibraryGroup (  Library *  LibraryToDisplay, INT32  NumItems )  [virtual]

Create a library group, as opposed to a display group Notes:. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 20/4/95 Parameters: LibraryToDisplay  - Pointer to the library associated with the group [INPUTS] NumItems - Number of items in the group Returns: The newly created library group, or NULL if there were problems Reimplemented from LibraryGallery. Definition at line 2044 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Add library group called in clipart gallery\n")); ERROR3IF(LibraryToDisplay == NULL, "LibClipartSGallery::AddLibraryGroup - NULL parameter is illegal"); if (DisplayTree == NULL) { ERROR3("LibClipartSGallery::AddLibraryGroup called before the DisplayTree was initialised!"); return(NULL); } //Flag the gallery to redraw and check the group against the state of the web themes / clipart box m_bRedraw = true; SGLibGroup *TheGroup = (SGLibGroup *)DisplayTree->FindSubtree(this, NULL, LibraryToDisplay); if (TheGroup == NULL) { // No existing group for that library, so create a new one TheGroup = new SGLibGroup(this, NULL, LibraryToDisplay); if (TheGroup == NULL) // Failed! return(NULL); // And add it to our display tree if (((GetClipTheme() == 0) && (LibraryToDisplay->Type == SGLib_ClipArt_WebThemes)) || ((GetClipTheme() == 1) && (LibraryToDisplay->Type == SGLib_ClipArt))) { TheGroup->Flags.Invisible = true; TheGroup->Flags.CanSelect = false; } DisplayTree->AddItem(TheGroup); TRACEUSER( "Matt", _T("...Add library group has just added the item to the display tree\n")); } else { if (((GetClipTheme() == 0) && (LibraryToDisplay->Type == SGLib_ClipArt_WebThemes)) || ((GetClipTheme() == 1) && (LibraryToDisplay->Type == SGLib_ClipArt))) { TheGroup->Flags.Invisible = true; TheGroup->Flags.CanSelect = false; } TheGroup->DestroySubtree(FALSE); // Delete all items in the group } return(TheGroup); }

SGDisplayItem * LibClipartSGallery::AddLibraryItem (  SGDisplayGroup *  LibraryGroup, Library *  ParentLib, LibraryIndex  ItemIndex, BOOL  bNew = FALSE )  [protected, virtual]

Called by the Library class to create a display item for every item in a newly-scanned library file. It is essentially a callback to the gallery which requested that the library be scanned. Parameters: LibraryGroup  - The group to add the item into [INPUTS] ParentLib - (For cross checking inputs) the library you allege the above group is for. ItemIndex - The Library generated index for this item Returns: NULL, or a pointer to the created item Notes: This method MUST BE OVERRIDDEN by the derived gallery that opens the library, in order to create appropriate SGDisplayItem-derived nodes for the things in the library (e.g. a clipart library gallery will have to create items that display clipart thumbnails) See also: SuperGallery::AddLibraryGroup; SuperGallery::RemoveLibraryGroup Reimplemented from LibraryGallery. Definition at line 1802 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Add library item called in clipart gallery\n")); ERROR3IF(LibraryGroup == NULL || ParentLib == NULL, "SuperGallery::AddLibraryItem - NULL params are illegal"); ERROR3IF(LibraryGroup->GetParentLibrary() != ParentLib, "SuperGallery::AddLibraryitem - The DisplayGroup is not for the same library!"); // Create a clipart library item SGClipartItem *NewItem = new SGClipartItem(ItemIndex, bNew); // Check for, and don't include if found in the Studio group, the line: // Rolex.art,Rather expensive watch,36,Rolex,Object|Time|Watch|Machine,113852 if((ParentLib->Title != NULL) && (ParentLib->Title->Sub((String_8)"Studio") == 0)) { String_256 TmpPath; BOOL ok = ParentLib->GetFilename(ItemIndex, &TmpPath, FALSE); if(ok) { INT32 Size = NewItem->GetFileSize(ParentLib); if(Size == 113852) { String_256 TmpPath; BOOL ok = ParentLib->GetFilename(ItemIndex, &TmpPath, FALSE); if(TmpPath == (String_16)"Rolex.art") { delete NewItem; NewItem = FALSE; } } } } /* SGSortKey SortKeys[MaxSGSortKeys]; for (INT32 i = 0; i < MaxSGSortKeys; i++) { SortKeys[i].SortKey = 0; SortKeys[i].Reversed = FALSE; } SortKeys[0].SortKey = 1;*/ if (NewItem != NULL) LibraryGroup->AddItem(NewItem/*, (SGSortKey *)SortKeys*/); return(NewItem); }

BOOL LibClipartSGallery::ApplyAction (  SGActionType  Action  )  [protected, virtual]

Applies certain conventional gallery actions (usually associated with gallery buttons, for new, edit, delete, etc). Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 27/1/95 (base generated in sgbase.cpp) Parameters: Action  - Indicates what action to apply [INPUTS] Returns: TRUE to indicate successful handling of the action, or FALSE to indicate failure See also: SGActionType Reimplemented from LibraryGallery. Definition at line 489 of file sglcart.cpp. { // No display tree? Better forget about it then! if (DisplayTree == NULL) return(FALSE); switch(Action) { case SGACTION_REDEFINE: break; case SGACTION_APPLY: ImportClipart(TRUE, this); break; /* case SGACTION_APPLYADJUST: ImportClipart(FALSE); break;*/ case SGACTION_EDIT: // Ignored - libraries are currently read-only break; case SGACTION_DELETE: // Ignored - libraries are currently read-only break; case SGACTION_SETOPTIONS: // Set values in the options dialogue as it is opened { if (CurrentOptionsDlg == NULL) return(FALSE); CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_LARGE)); // 0 CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_FULLINFO)); // 1 CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_SMALL)); // 2 } break; case SGACTION_SETSORTMODE: { if (CurrentSortDlg == NULL) return(FALSE); CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_NAME)); CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_MEMORY)); CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_NAMELENGTH)); CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_FILETYPE)); } break; case SGACTION_DISPLAYMODECHANGED: if(DisplayMode >= 3) DisplayMode = 0; LibClipartSGallery::DefaultDisplayMode = DisplayMode; InvalidateCachedFormat(); ReformatAndRedrawIfNecessary(); //ForceRedrawOfList(); break; default: return(SuperGallery::ApplyAction(Action)); break; } return(TRUE); }

BOOL LibClipartSGallery::BrowseClicked (  void   )  [protected, virtual]

Pops up the browse box and lets a new location be set for the clipart directory. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 2/5/95 Parameters: [INPUTS]  Returns: TRUE if the gallery has new stuff in it (FALSE if cancel clicked, etc)... Reimplemented from LibraryGallery. Definition at line 761 of file sglcart.cpp. { if (GetClipTheme() == 0) { return (LibraryGallery::BrowseClicked(&DefaultLibraryPath, SGLib_ClipArt, _R(IDS_REMOVE_OLD_GOUPS_CLIPART))); } else { return (LibraryGallery::BrowseClicked(&DefaultLibraryPath, SGLib_ClipArt_WebThemes, _R(IDS_REMOVE_OLD_GOUPS_CLIPART))); } }

BOOL LibClipartSGallery::BuildCommandMenu (  GalleryContextMenu *  TheMenu, SGMenuID  MenuID )  [virtual]

To build a menu of commands to be popped up over the gallery. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 15/9/95 Parameters: TheMenu  - The menu to add commands to [INPUTS] MenuID - The type of menu (over-list or from-options-button) to create Returns: TRUE if it succeeded Notes: Override this method to stop the default menus being built Reimplemented from SuperGallery. Definition at line 2234 of file sglcart.cpp. { BOOL ok = TRUE; if (MenuID == SGMENU_OPTIONS) { // Options menu ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Add); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_EmptyClipartCache, TRUE); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Find); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Sort); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Properties); } else { // Over-list menu ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Open); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Import); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_Remove, TRUE); // With separator SGDisplayGroup *TheGroup = FindCommandGroup(); // Fold or unfold as appropriate if (TheGroup == NULL || !TheGroup->Flags.Folded) ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_FoldGroup); else ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_UnfoldGroup); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_PrevGroup); ok = ok && AddCommand(TheMenu, (StringBase *) &SGCmd_NextGroup); } return(ok); }

BOOL LibClipartSGallery::CanCreateIndexes (  void   )  [virtual]

To determine if this gallery can generate indexes or not. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/95 Returns: TRUE to if index generation is possible Reimplemented from LibraryGallery. Definition at line 787 of file sglcart.cpp. { return TRUE; }

BOOL LibClipartSGallery::CanSearchKeywords (  void   )  [virtual]

Used to determine if this type of gallery supports keyword searching. This one does. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 30/3/95 Returns: TRUE Reimplemented from LibraryGallery. Definition at line 2001 of file sglcart.cpp. { return(TRUE); }

BOOL LibClipartSGallery::CheckForIndexMatch (  StringBase *  Txt  )  [virtual]

To see whether we should add this line of the index.txt file to this gallery. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/95 Parameters: Txt  - Last column entry in the index.txt file (" A") [INPUTS] Returns: TRUE if this signifies the gallery in question... Reimplemented from LibraryGallery. Definition at line 889 of file sglcart.cpp. { BOOL Match = FALSE; // Artwork, and Bitmaps... if(((Txt->Sub(String_8("A"))!=-1) || (Txt->Sub(String_8("a"))!=-1)) ) Match = TRUE; if(((Txt->Sub(String_8("B"))!=-1) || (Txt->Sub(String_8("b"))!=-1)) ) Match = TRUE; return Match; }

SGDisplayItem * LibClipartSGallery::CopyDisplayItem (  SGDisplayItem *  SourceItem, SGDisplayGroup *  DestGroup, SGDisplayItem *  TargetPosition )  [protected, virtual]

"Copies" the existing node in the tree in an appropriate fashion. Parameters: SourceItem  - The item to copy elsewhere in the tree (see below) [INPUTS] DestGroup - The group into which the item should be inserted TargetPosition - NULL (to add the copied item to the end of the sibling list), or points to an item BEFORE which the copied item will be inserted. Returns: NULL (failed) or a pointer to the new (copied) display item This method is normally called when a gallery-organising drag completes, and it is discovered that the dragged item(s) have been dragged to a different display group. Notes: This method should be overridden by derived galleries to provide appropriate behaviour (some galleries (e.g colour) will copy the real-item that the given display-item references to the new group (document), while other galleries (layer) may just move the item after all). Note the handy InsertCopiedItem and MoveBefore/After methods which are available to take all of the hard work out of copying/moving items! See the body of this method in the source code for example pseudocode. For real code, see the Colour Gallery (sgcolour.cpp) See also: SuperGallery::InsertCopiedItem; SGDisplayItem::MoveBefore; SGDisplayItem::MoveAfter; ColourSGallery::CopyDisplayItem Reimplemented from LibraryGallery. Definition at line 2132 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Copy display item called in clipart gallery\n")); if(SourceItem == NULL || DestGroup == NULL) { ERROR3("LibClipartSGallery::CopyDisplayItem -> Illegal NULL param"); return NULL; } // Check if we've dragged from one group to another and warn if that's the case if(DestGroup->IsKindOf(CC_RUNTIME_CLASS(SGLibGroup))) { SGDisplayNode *SourceGroup = SourceItem->GetParent(); if((SGDisplayGroup *)SourceGroup != DestGroup) { // "Can't move clipart between groups." InformError(_R(IDS_CLIPART_BETWEEN_GROUPS), _R(IDS_OK)); Error::ClearError(); } } return(NULL); }

void LibClipartSGallery::DoCommand (  StringBase *  CommandID  )  [virtual]

To apply a given command when it is chosen from the menu. Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 15/9/95 Parameters: CommandID  - The String ID of the command [INPUTS] Notes: Override this method to provide handling for your special commands. Call the base class if you don't recognise the command, so that it can handle standard commands. The base class handles all of these (maybe more - see the base class help) Properties, Sort, Find; New, Edit, Delete, Redefine; (it calls ApplyAction as appropriate) NextGroup, PrevGroup, FoldGroup, UnfoldGroup; Reimplemented from SuperGallery. Definition at line 2364 of file sglcart.cpp. { if (*CommandID == SGCmd_Open) // --- Open ImportClipart(TRUE, this); else if (*CommandID == SGCmd_Import) // --- Import ImportClipart(FALSE, this); else if (*CommandID == SGCmd_Add) // --- Add clipart BrowseClicked(); else if (*CommandID == SGCmd_EmptyClipartCache) // --- Remove web folders { RemoveWebFolders(SGLib_ClipArt); //This will actually remove both clipart and web themes! } else if (*CommandID == SGCmd_Remove) // --- Remove { RemoveSelectedLibraries(TRUE); UpdateGRMFile(); } else SuperGallery::DoCommand(CommandID); // Unknown command- pass to the base class }

void LibClipartSGallery::DoShadeGallery (  BOOL  ShadeIt  )  [protected, virtual]

To un-grey the options... button when there are no docs Notes:. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> (based on Jason code) Date: 28/3/95 Reimplemented from LibraryGallery. Definition at line 1968 of file sglcart.cpp. { if (DisplayTree == NULL) return; // Keep this here always EnableGadget(_R(IDC_GALLERY_MENU), TRUE); if(ShadeIt) { EnableGadget(_R(IDC_LIBGAL_IMPORT), FALSE); } EnableGadget(_R(IDC_LIBGAL_ADD_CLIPART), TRUE); // Standard library buttons LibraryGallery::DoShadeGallery(ShadeIt); }

INT32 LibClipartSGallery::GetClipTheme (   )  const

Author: Priestley (Xara Group Ltd) <camelotdev@xara.com> Date: 18/09/2000 Returns: The index of the theme/clipart currently shown in the selector. See also: LibClipartSGallery::SetPropertyIndex Definition at line 2395 of file sglcart.cpp. { return m_nClipTheme; }

OpState LibClipartSGallery::GetCommandState (  StringBase *  CommandID, String_256 *  ShadeReason )  [virtual]

To determine the state of a given menu item. This method is an exact parallel to an Op's GetState method (in fact, it is called by an Op's GetState). Author: Jason_Williams (Xara Group Ltd) <camelotdev@xara.com> Date: 15/9/95 Parameters: CommandID  - TheString ID of the command [INPUTS] ShadeReason  - If you return (OpState.Greyed == TRUE) then this should be filled [OUTPUTS] ion with the reason that the item is shaded/greyed. Returns: An OpState indicating the current menu item state. Notes: Override this method to provide state info for your special commands Call the base class for unknown commands to allow it to handle them for you The base class handles all of these (maybe more - see the base class help) Properties, Sort, Find; New, Edit, Delete, Redefine; NextGroup, PrevGroup, FoldGroup, UnfoldGroup; Reimplemented from SuperGallery. Definition at line 2296 of file sglcart.cpp. { OpState State; if (*CommandID == SGCmd_Add) // --- Add (always available) return(State); if (*CommandID == SGCmd_EmptyClipartCache) { if (m_bDiscardWebFolders) State.Greyed = TRUE; return (State); } if (*CommandID == SGCmd_Open || *CommandID == SGCmd_Import) // --- Open/Import { if (GetSelectedItemCount() < 1) { State.Greyed = TRUE; ShadeReason->MakeMsg(_R(IDS_SGSHADE_NOSEL)); } } else if (*CommandID == SGCmd_Remove) // --- Remove { if (GetSelectedGroupCount() < 1) { State.Greyed = TRUE; ShadeReason->MakeMsg(_R(IDS_SGSHADE_NOSELGROUP)); } } else if (*CommandID == SGCmd_Properties) // --- Properties - disabled if the gallery is currently downloading thumnails { if (!m_lstPendingThumbs.empty()) { State.Greyed = TRUE; ShadeReason->MakeMsg(_R(IDS_SGSHADE_DOWNLOADING)); } } else return(SuperGallery::GetCommandState(CommandID, ShadeReason)); // Unknown command- pass to baseclass return(State); }

virtual String_256* LibClipartSGallery::GetDefaultLibraryPath (   )  [inline, virtual]

Reimplemented from LibraryGallery. Definition at line 219 of file sglcart.h. {return &DefaultLibraryPath;}

BOOL LibClipartSGallery::GetDefaults (  String_256 *  DefaultIndex, String_256 *  IndexDesc, SGLibType *  Type )  [virtual]

To determine various library gallery default properties. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/95 Parameters: DefaultIndex  - The filename for the default index file (Xaraclip.txt) [OUTPUTS] IndexDesc - Description of the index / gallery (Clipart) Type - Default library type associated with this gallery Returns: TRUE if this was overridden successfully Reimplemented from LibraryGallery. Definition at line 810 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Getting defaults for clipart gallery\n")); if(DefaultIndex != NULL) { //Set the correct info filename for the current gallery style if (GetClipTheme() == 0) { *DefaultIndex = _R(IDS_LIBRARIES_CLIPART_FILENAME); // "XaraClip.txt"; } else { *DefaultIndex = _R(IDS_LIBRARIES_WEBTHEMES_FILENAME); // "XaraThem.txt"; } } if(IndexDesc != NULL) *IndexDesc = _R(IDS_LIBRARIES_CLIPART_DESC); // "Clipart"; if(Type != NULL) { //Set the type of the gallery to be 'Clipart' or 'Web Themes' //so that the base classes attempt to load file info from the //correct URL - real handy... if (GetClipTheme() == 0) { *Type = SGLib_ClipArt; } else { *Type = SGLib_ClipArt_WebThemes; } } return TRUE; }

virtual SGLibType LibClipartSGallery::GetGalleryType (   )  [inline, virtual]

Reimplemented from LibraryGallery. Definition at line 207 of file sglcart.h. { if (GetClipTheme() == 0) { return SGLib_ClipArt; } else { return SGLib_ClipArt_WebThemes; } }

BOOL LibClipartSGallery::GetLibraryDirectoryName (  String_256 *  LibDirName  )  [virtual]

Get the default CD directory name for the gallery. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 19/12/95 Parameters: LibDirName  - Returns the Default directory (on the clipart CD) for the gallery [OUTPUTS] Returns: TRUE if overridden and directory obtained... Reimplemented from LibraryGallery. Definition at line 861 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Getting library directory name for clipart gallery\n")); if (GetClipTheme() == 0) { LibDirName->MakeMsg(_R(IDS_LIBRARIES_CLIPART_DIRNAME)); } else { LibDirName->MakeMsg(_R(IDS_LIBRARIES_WEBTHEMES_DIRNAME)); } return TRUE; }

BOOL LibClipartSGallery::GetQuietStatus (  void   )  [virtual]

Get the Quiet status of the gallery. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 19/12/95 Returns: TRUE if Quiet has been pressed (SetQuiet status called with TRUE) Reimplemented from LibraryGallery. Definition at line 912 of file sglcart.cpp. { return LibClipartSGallery::QuietStatus; }

void LibClipartSGallery::HandleDragStart (  DragMessage *  DragMsg  )  [protected, virtual]

Checks a DragMessage to see if it is a colour drag. If it is, then it creates a drag target for this gallerys listbox. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 25/3/95 Parameters: DragMsg  - The DRAGSTARTED message that we've just recieved, indicating [INPUTS] the type of drag being started Notes: Overrides the default base-class action. Calls down to the base class if it is not a colour drag, so that dragging of gallery groups is allowed Reimplemented from LibraryGallery. Definition at line 1030 of file sglcart.cpp. { // If it's a bitmap drag, add a target for our window. If not, let the base class // have a look at it (to see if it is a gallery item being dragged) if (DragMsg->pInfo->IsKindOf(CC_RUNTIME_CLASS(GalleryClipartDragInfo))) SGClipartDragTarget *NewTarget = new SGClipartDragTarget(this, GetListGadgetID()); else SuperGallery::HandleDragStart(DragMsg); }

BOOL LibClipartSGallery::ImportClipart (  BOOL  NewDocument, LibraryGallery *  pSourceGallery )  [static]

To load/import all the selected clipart items one by one into camelot. Notes:. Author: Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> Date: 19/3/95 Asynchronous import code added by Adrian, 12/96 Parameters: NewDocument  - Set to TRUE if you don't want the import to be added ontopof [INPUTS] the currently selected document. [OUTPUTS]  Returns: TRUE if things went OK, false otherwise See also: Definition at line 1068 of file sglcart.cpp. { TRACEUSER( "Matt", _T("Importing clipart in clipart gallery\n")); if (pSourceGallery->DisplayTree == NULL) { ERROR3("LibClipartSGallery::ImportClipart No display tree - bad !"); return FALSE; } if(Document::GetSelected() == NULL && !NewDocument) { return FALSE; } BOOL ok = TRUE; // Find the first selected item (if any) and get the next item to start searching from // If there is no selection, then get the first item SGDisplayNode *Item = pSourceGallery->DisplayTree->FindNextSelectedItem(NULL); String_256 ItemText; while (Item != NULL) { if(Item->IsKindOf(CC_RUNTIME_CLASS(SGClipartItem)) || Item->IsKindOf(CC_RUNTIME_CLASS(SGFillsItem))) { Item->GetNameText(&ItemText); if(Item->Flags.Selected) { PathName FileName; SGLibDisplayItem *ClipItem = (SGLibDisplayItem *) Item; //if (Lib != NULL) ok = ClipItem->GetFileName(&FileName); if(ok) { // Bodge for clipart CD - 'Cow' in LScape should point to "Moo.tif", not just "Moo" if(FileName.GetFileName(FALSE) == (String_256)"Moo") { INT32 Size = ClipItem->GetFileSize(NULL); if(Size == 1080904) FileName.SetType("TIF"); } if(!FileName.IsValid(FileName.GetPath())) { ERROR3("LibClipartSGallery::ImportClipart - Filename is invalid"); return FALSE; } // Check if file has a long filename, and use that if it does... String_256 FilePath((const TCHAR *)FileName.GetPath()); String_256 LongFileName; BOOL LongPath = FileUtil::GetLongFileName((LPTSTR)FilePath, (LPTSTR)LongFileName, 255); if(LongPath) { FilePath = FileName.GetLocation(TRUE); FilePath += LongFileName; } // Check if the file really exists on the local drive Library* pLibrary = ClipItem->GetParentLibrary(); if (!pLibrary) { ERROR3("Illegal NULL pointer"); return FALSE; } BOOL bIsLocalFile; if (!pLibrary->IsWebLibrary()) bIsLocalFile = TRUE; else bIsLocalFile = (_access((TCHAR*) FilePath, 0) != -1); if(NewDocument) { if (bIsLocalFile) { CWinApp* pApp = AfxGetApp(); BaseFileDialog::SelectedFilter = 0; // Open a document CCamDoc* pDoc = (CCamDoc*) pApp->OpenDocumentFile((TCHAR *)FilePath); // And redraw the imported document if(pDoc) pDoc->GetKernelDoc()->ForceRedraw(); } else // do an asynch import { goto ASYNCH_IMPORT; } } else { // Invoke the clipart import operation so that we get Undo. if (bIsLocalFile) // if the file is local we do a normal import Op { OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(CC_RUNTIME_CLASS(OpClipartImport)); if (pOpDesc != NULL) { ClipartImportParam Param; PathName FullPathName(FilePath); // Set up the parameters which we require to do the import operation Param.File = &FullPathName; Param.Import = !NewDocument; Param.Result = TRUE; // Import the specified file pOpDesc->Invoke((OpParam *) &Param); ok = Param.Result; if(!ok) { ERROR3("LibClipartSGallery::ImportClipart - Problem importing file"); return FALSE; } } } else // try an asynch import { ASYNCH_IMPORT: String_256 strFileURL = FilePath; pLibrary->LocalPath2URL(&strFileURL); OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(CC_RUNTIME_CLASS(OpAsynchClipartImport)); if (pOpDesc != NULL) { AsynchClipartImportParam* Param = new AsynchClipartImportParam; ERROR2IF(!Param, FALSE, "Memory allocation error"); // Set up the parameters which we require to import the clipart Param->File.SetPathName((TCHAR *)FilePath); String_256 strDescription; ClipItem->GetNameText(&strDescription); Param->strDescription = _T("'"); Param->strDescription += strDescription; Param->strDescription += _T("'");