SliceHelper Class Reference

#include <slicehelper.h>

List of all members.

Public Types
enum	SelStateAction { CLEAR, SET, TOGGLE }
Static Public Member Functions
static Layer *	FindLayerCalled (const StringBase &LayerName)
static INT32	CountButtonsInBar (const StringBase &BarName)
static void	CountButtonsInBarScan (Node *pNode, TemplateAttribute **ppFoundButton, INT32 *pNumberOfButtons, const StringBase &BarName)
	Finds the number of buttons in the bar and the names of each button, by filling in the ppFoundButton array and pNumberOfButtons.
static void	BuildListOfNodesInBar (List *pList, Node *pNode, const StringBase &BarName)
	Builds a list (or extends an existing list) of ALL the wix attribute nodes that have this bar name hidden in the question.
static SGNameItem *	LookupNameGalleryItem (const StringBase &strName)
	Used to find out if a button name has been used before. Or find the dimensions of a button.
static void	GetNextFreeButtonName (INT32 &butno, StringBase *pStr=NULL)
	Used to find the next button name that can be reused or created, that isn't going to interfere with what we have.
static Node *	FindNextOfClass (Node *pNode, Node *pLidNode, const class CCRuntimeClass *pClass, BOOL CheckThis=FALSE)
	Used to walk a tree repeatedly from any given branch, searching for nodes of a particular type.
static Node *	FindNextNameNode (Node *pNode, Node *pLidNode, BOOL CheckThis=FALSE)
static void	SelectAllSetsOfThisNode (NodeRenderableInk *pInk, String_256 &SetName, BOOL bShift)
	Calls RecurseSelectAllSetsOfThisNode after looking up the tree for any non-selectable nodes. These are tested for by looking for a FALSE return from PromoteHitTestOnChildrenToMe. We do this because the user may try to select eg a NodeBevelController with a name on it, the selection slips through to its children who don't have the name directly applied. We must therefore find the node the user thought they were clicking on, and work on from there.
static void	RecurseSelectAllSetsOfThisNode (Node *pAttrs, String_256 &SetName, BOOL bShift)
	Looks at all template attributes applied to this node and its children. Sets the selection state of the any referred name sets according to the shift setting. ie. you pick a member of a set and it selects all members of that set. ie2. If it is a member of more than one set all those sets are selected.
static BOOL	SelectObjectsInSet (const StringBase &strName, SelectScan::Change eNewState)
	Wraps the scan functionality. Selects all items from the named set.
static void	SelectAllSetsInRect (const DocRect, Spread *, SelStateAction st=SET)
	For each object wholly inside the supplied rectangle, selects that object and all other objects sharing any names belonging to that object. It will draw in all the EORed blobs of the objects that it selects/deselects. rewritten by Simon so that objects on locked layers do not get selected also more optimal. (st parameter etc added by JCF 1.11.94).
static String_256	GetBarName (TemplateAttribute *pTemplAttrib)
	The bar name is stored as the question in the wix attrib. This fn extracts the bar name from the attrib, checking that it is a bar name and not any old string in there. If it isn't a bar identifier it returns an empty string.
static void	MeshImportedLayersWithExistingButtonBars (Node *pImportedLayer[5], UndoableOperation *pUndoableOp, BOOL Imported)
	Used when a drawing (.XAR, .WEB) is imported or dragged into an existing drawing, or cloned. Button names and bar names are rationalised and made unique, after the nodes themselves have already been merged onto the existing special layers. The function also has to mesh the stretching properties of any buttons that it tampers with providing new extenders to go with each new button defined. The extenders have to be uniquely named too and match with the correct button and the correct nodes of that button.
static BOOL	IsUniqueName (const String_256 &Name, List *pList)
static Node *	ReplaceAttrsInTree (UndoableOperation *pOp, List *pImportedAttrList, const String_256 &OldButtonName, const String_256 &OldBarName, const String_256 &NewButtonName, const String_256 &NewBarName, Node **ppNodeFound=NULL)
	Scans the pImportedAttrList looking for OldButtonName and OldBarName. Replaces it with new versions of the template attribute. Returns a ptr to an example of a changed attr node Fills in an example of an old node into ppNodeFound if required.
static BOOL	BarNameExists (Node *pNode, String_256 &BarName, Node *pLid=NULL)
	Just a quick check to see if this bar name is used anywhere here. Used to find unused bar names.
static INT32	FindTargetAndExtender (Node *pStartNode, String_256 &Target, String_256 &Extender, INT32 RequiredLevel, BYTE *pExtenderFlags=NULL, DocRect *pTargetRect=NULL, DocRect *pExtenderRect=NULL)
	When you want to find out what extends what from a button level (ie you have a node).
static BOOL	CreatePropertiesForSet (const String_256 &SetName, const String_256 &BarName, BOOL isSlice, BOOL Stretches, BOOL IsBackBar, BYTE StretchFlags, const String_256 &StretchedBy, BOOL DontOverWrite=FALSE, DocRect *pTargetRect=NULL, DocRect *pExtenderRect=NULL, UndoableOperation *pOp=NULL, NodeSetProperty *pExampleProp=NULL)
	If you create a named set these days you need to create properties in the node set sentinel too so that they are stored somewhere that can be saved out, undone, etc. So if you have made any in your code this is a useful little number.
static BOOL	PurgeUseOfSetName (const StringBase &SetName, UndoableOperation *pOp, const String_256 *pReplacementName=NULL)
	"SetName" should be a new clean set there should be no old references to this "SetName" in any extend lists remove them if there are any. find the property node for the setname
static BOOL	MakeTriggerLikeExample (const String_256 &NewButtonName, const String_256 &ButtonName, const String_256 *pExclude=NULL)
	Adds NewButtonName to the lists of triggers that ButtonName belongs to. This is used by the bars thatwant all the buttons to stretch the same background bar.
static DocRect	BoundingNodeSize (Node *pNode)
	Get bounds was returning the acturate "how big is it" This fn treats text that is of a size and the same font as being the same size ignoring decsenders and ascenders.
static INT32	GetBarNumberFromBarName (const String_256 &BarName)
	Converts the bar name into a bar number.
static TemplateAttribute *	FindFirstSetNodeBelongsTo (Node *pNode)
	returns the fist attrib that may apply to a node
static String_256	GetSetNameFromAttrib (Node *pNode)
	returns the fist attrib that may apply to a node
static TextStory *	FindNextTextStoryToSync (TextStory *pLastStory, Node *pLid, TextStory *pMasterStory, const String_256 &ButtonName, const String_256 &MasterText, BOOL AnyText=FALSE)
	scans for text stories that are of the named set and match the criteria to edit when the master is edited.
static BOOL	TextStoriesHaveSameText (TextStory *pStory1, TextStory *pStory2)
static BOOL	TextLinesHaveSameText (TextLine *pLine1, TextLine *pLine2)
static BOOL	SyncTextLines (TextLine *pLine1, TextLine *pLine2, UndoableOperation *pOp)
static BOOL	SyncTextStories (TextStory *pStory, TextStory *pMaster, UndoableOperation *pOp)
	Changes the characters in the story pStory to match those in pMaster. In this process it attempts to minimise the amount of undo information required. Calls the fn bellow SyncTextLines().
static BOOL	OnTextStoryChanged (TextStory *pMasterStory, UndoableOperation *pOp, ObjChangeParam *pObjChange, const String_256 &MasterText)
	Call this if a master text may have been edited. It tests to see if the text is a master text. Finds slave text stories and syncs these with the master text.
static DocRect	ScanForSetSizeExcluding (const String_256 &IncludeSet, const String_256 &ExcludeSet)
	Caculating clean set sizes for extending buttons.
static BOOL	BarExistsOnLayer (const String_256 &BarName, const String_256 &Layer)
	Fast scan for existance.
static void	BarNameInRect (DocRect r, String_256 *pBarName)
static void	ShowLayer (BOOL Visible, Layer *pLayer, Spread *pSpread, UndoableOperation *pUndoOp)
static INT32	DoesSelectionOnlyContainCompleteSets ()
static BOOL	SetUsedInTree (Node *pNode, const String_256 &SetName, Node *pLid=NULL)
static void	DeleteUnusedReferences (const String_256 &SetName, UndoableOperation *pOp)
static BOOL	AddNamesToController (UndoableOperation *pOp, Node *pCtrlr)
static BOOL	RemoveNamesFromController (UndoableOperation *pOp, Node *pCtrlr)
static BOOL	ModifySelectionToContainWholeButtonElements ()
static void	SaveSelection ()
	Save the current selection to m_pSelNodeList.
static void	RestoreSelection ()
	Restores the current selection to that given in m_pSelNodeList.
static void	ValidateNodeSetSentinel ()
static void	BuildListOfNodesInButton (List *pList, Layer *pLayer, const StringBase &ButtonName)
	Scans all of pLayer, building a list of all nodes which are part of ButonName - if a NodeShadowController is encountered, we add its children instead in order to get the correct bounding box info...
static void	EnsureTriggerInfo ()
	Scans the NameGallery ensuring that the triggers are in the right places...
Static Private Attributes
static List *	m_pSelNodeList = 0

---

Detailed Description

Definition at line 116 of file slicehelper.h.

---

Member Enumeration Documentation

enum SliceHelper::SelStateAction

Enumerator: CLEAR  SET  TOGGLE  Definition at line 120 of file slicehelper.h. { CLEAR, SET, TOGGLE };

---

Member Function Documentation

BOOL SliceHelper::AddNamesToController (  UndoableOperation *  pOp, Node *  pCtrlr )  [static]

Definition at line 2909 of file slicehelper.cpp. { Node * pNode = pCtrlr->FindFirstChild(); while (pNode) { if (!pNode->IsAnAttribute() && !pNode->IsNodeHidden()) { Node * pAttr = NULL; do { // find any name attrs on this node pAttr = SliceHelper::FindNextNameNode(pNode, pNode); // does this already exist on the controller? Node * pExistingAttr = NULL; Node * pTemp = NULL; if (pAttr) { for (pTemp = pCtrlr->FindFirstChild(); pTemp != NULL && pExistingAttr == NULL; pTemp = pTemp->FindNext() ) { if (pTemp->IsAnObjectName()) { if (((TemplateAttribute *) pTemp)->GetParam() == ((TemplateAttribute *) pAttr)->GetParam()) pExistingAttr = pTemp; } } pTemp = SliceHelper::FindNextNameNode(pAttr, pNode); // didn't exist on controller so add it if (!pExistingAttr) { TemplateAttribute* pNewAttr = new TemplateAttribute(String_256(TEXT("ObjectName")), ((TemplateAttribute *) pAttr)->GetQuestion(), ((TemplateAttribute *) pAttr)->GetParam()); // add the new attrib to the tree if (pNewAttr) { pNewAttr->AttachNode(pCtrlr, FIRSTCHILD); // Create a hide node action to hide the node when we undo HideNodeAction* UndoHideNodeAction; HideNodeAction::Init(pOp, pOp->GetUndoActions(), //&UndoActions, pNewAttr, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)); } } // did exist so just delete the duplicate pOp->DoHideNode(pAttr, FALSE); pAttr = pTemp; } }while (pAttr != NULL); } pNode = pNode->FindNext(); } return TRUE; }

BOOL SliceHelper::BarExistsOnLayer (  const String_256 &  BarName, const String_256 &  Layer )  [static]

Fast scan for existance. Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 26/6/00 Returns: TRUE if an element of the bar is found on the layer, FALSE if not found Definition at line 2773 of file slicehelper.cpp. { Node * pLayer = SliceHelper::FindLayerCalled(Layer); if (!pLayer) return FALSE; Node * pNode = pLayer; do { pNode = FindNextOfClass(pNode, pLayer, CC_RUNTIME_CLASS(TemplateAttribute)); if (pNode && BarName.CompareTo(((TemplateAttribute *)pNode)->GetQuestion()) == 0) return TRUE; } while (pNode); return FALSE; }

BOOL SliceHelper::BarNameExists (  Node *  pNode, String_256 &  BarName, Node *  pLid = NULL )  [static]

Just a quick check to see if this bar name is used anywhere here. Used to find unused bar names. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> JK Date: 4/10/99 Returns: TRUE if this bar name is used from this node down Params: pNode - The node to check from BarName - The name of the bar we are looking for. pButtonName - If provided fills in the button name found in a bar. Modified non recursive version written 17/9/00 (sjk) pnode is the node to start looking from and pLid is the node to stop looking when we reach it if pnode == plid or plid == 0 then it scans the entire branch defined by pnode Definition at line 1537 of file slicehelper.cpp. { if (pLid == NULL) pLid = pNode; Node * pNextNode = FindNextNameNode(pNode, pLid); while (pNextNode) { if (BarName.CompareTo(((TemplateAttribute *)pNextNode)->GetQuestion()) == 0) return TRUE; pNextNode = FindNextNameNode(pNextNode, pLid); } return FALSE; }

void SliceHelper::BarNameInRect (  DocRect  r, String_256 *  pBarName )  [static]

Definition at line 2791 of file slicehelper.cpp. { NameGallery * pNameGallery = NameGallery::Instance(); if (!pNameGallery) return; SGUsedNames* pNames = pNameGallery->GetUsedNames(); if (!pNames) return; SGNameItem * pNameGalleryItem = (SGNameItem*) pNames->GetChild(); while (pNameGalleryItem) { if (pNameGalleryItem->m_BarNumber >= 0 && r.IsIntersectedWith(pNameGalleryItem->GetSetBounds())) { pBarName->MakeMsg(_R(IDS_BARNAME), pNameGalleryItem->m_BarNumber + 1); return; } pNameGalleryItem = (SGNameItem *) pNameGalleryItem->GetNext(); } }

DocRect SliceHelper::BoundingNodeSize (  Node *  pNode  )  [static]

Get bounds was returning the acturate "how big is it" This fn treats text that is of a size and the same font as being the same size ignoring decsenders and ascenders. Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 17/3/00 Params: pNode - the node that you want to know how big it is Returns: its size WARNING * It does this by examining the char size of the first char in each line and getting a min and max height. It uses the width from getbounds(). So if fonts change mid way then descenders become a problem again. But this is faster than checking each char. Definition at line 1966 of file slicehelper.cpp. { if (!pNode->IsBounded()) return DocRect(0,0,0,0); DocRect rBounds = ((NodeRenderableBounded*) pNode)->GetBoundingRect(); if (IS_A(pNode,TextStory)) { DocRect rTextBounds; Node * pLid = pNode; pNode = SliceHelper::FindNextOfClass(pLid, pLid, CC_RUNTIME_CLASS(TextChar)); if (pNode) { if (((TextChar*) pNode)->GetMetricsRectBounds(&rTextBounds)) { rBounds.hi.y = rTextBounds.hi.y; rBounds.lo.y = rTextBounds.lo.y; } } else return DocRect(0,0,0,0); // no text chars should return empty while (pNode) { pNode = SliceHelper::FindNextOfClass(pNode, pLid, CC_RUNTIME_CLASS(TextLine)); if (pNode) { pNode = SliceHelper::FindNextOfClass(pNode, pLid, CC_RUNTIME_CLASS(TextChar)); if (pNode) { if (((TextChar*) pNode)->GetMetricsRectBounds(&rTextBounds)) { rBounds.hi.y = max(rTextBounds.hi.y, rBounds.hi.y); rBounds.lo.y = min(rTextBounds.lo.y, rBounds.lo.y); } } } } } else if (IS_A(pNode,NodeShadowController)) // ignore the size of the shadow and just get me the size of the other bits { rBounds.MakeEmpty(); pNode = pNode->FindFirstChild(); while (pNode) { if (!pNode->IsAnAttribute() && !pNode->IsNodeHidden() && !IS_A(pNode, NodeShadow)) rBounds = rBounds.Union(BoundingNodeSize(pNode)); pNode = pNode->FindNext(); } } else if (IS_A(pNode,NodeBevelController)) // ignore the size of the bevel and just get me the size of the other bits { rBounds.MakeEmpty(); INT32 BevWidth = ((NodeBevelController *)pNode)->m_bOuter ? ((NodeBevelController *)pNode)->m_Indent : 0; pNode = pNode->FindFirstChild(); while (pNode) { if (!pNode->IsAnAttribute() && !pNode->IsNodeHidden() && !IS_A(pNode, NodeBevel) && !IS_A(pNode, NodeBevelBegin)) { rBounds = rBounds.Union(BoundingNodeSize(pNode)); } pNode = pNode->FindNext(); } if (!rBounds.IsEmpty()) rBounds.Inflate(BevWidth); // inflate the other bits' size by the bevel width } else if (IS_A(pNode,NodeContourController)) // ignore the size of the contour and just get me the size of the other bits { rBounds.MakeEmpty(); // -ve width means outer contour!!?! // this is crazy but ignore inners so negate it to get the actual width increase INT32 Width = -((NodeContourController *)pNode)->GetWidth(); pNode = pNode->FindFirstChild(); while (pNode) { if (!pNode->IsAnAttribute() && !pNode->IsNodeHidden() && !IS_A(pNode, NodeContour)) { rBounds = rBounds.Union(BoundingNodeSize(pNode)); } pNode = pNode->FindNext(); } if (Width > 0) rBounds.Inflate(Width); // inflate the size of the other bits' by the width of the contour } return rBounds; }

void SliceHelper::BuildListOfNodesInBar (  List *  pList, Node *  pNode, const StringBase &  BarName )  [static]

Builds a list (or extends an existing list) of ALL the wix attribute nodes that have this bar name hidden in the question. Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 30/9/99 Params: pList - List that is filled in of pointers to all the nodes pNode - The node to scan from. Looks at everything down from here. BarName - The bar we are looking for Returns: - Errors: Caution is RECURSIVE Definition at line 324 of file slicehelper.cpp. { if (pNode->IsAnAttribute()) // looking for an attrib { if (IS_A(pNode,TemplateAttribute)) // that is a wix attrib { // that has the bar name in the question // the same as the one we are looking for if (BarName.CompareTo(((TemplateAttribute *)pNode)->GetQuestion()) == 0) { //add it to the list then NodeListItem * pItem = new NodeListItem(pNode); pList->AddTail(pItem); } } } else // find anything else interesting? { Node * pChildNode = pNode->FindFirstChild(); while (pChildNode) { // ***recursive call*** if (!pChildNode->IsNodeHidden()) BuildListOfNodesInBar(pList, pChildNode, BarName); pChildNode = pChildNode->FindNext(); } } }

void SliceHelper::BuildListOfNodesInButton (  List *  pList, Layer *  pLayer, const StringBase &  ButtonName )  [static]

Scans all of pLayer, building a list of all nodes which are part of ButonName - if a NodeShadowController is encountered, we add its children instead in order to get the correct bounding box info... Author: Priestley (Xara Group Ltd) <camelotdev@xara.com> Date: 20/12/2000 Params: pList - List that gets filled with pointers to all the nodes pLayer - The layer we are interested in ButtonName - The button we are looking for Returns: - Definition at line 3356 of file slicehelper.cpp. { ERROR3IF(!pLayer || !ButtonName || !pList, "Please don't call SliceHelper::BuildListOfNodesInButton with null params!"); // Starting at pLayer, look for all TemplateAttributes with the correct name attached... Node * pNode = FindNextOfClass(pLayer, pLayer, CC_RUNTIME_CLASS(TemplateAttribute)); while (pNode) { // If this Node is part of a bar AND has the correct name, then add it to the list... if (((TemplateAttribute *)pNode)->GetQuestion() && (((TemplateAttribute *)pNode)->GetParam() == ButtonName)) { // Add this node to the list unless it is a nodeshadowcontroller - if it is, add all of its children individually (except the nodeshadow child) if (IS_A(pNode->FindParent(), NodeShadowController)) { TRACEUSER( "Matt", _T("\nNodeShadowController found in BuildListOfNodesInButton - replacing list entries with its children")); Node * pChild = pNode->FindParent()->FindFirstChild(); while (pChild) { if (!pChild->IsAnAttribute() && !pChild->IsNodeHidden() && !IS_A(pChild, NodeShadow)) { // Then add this child to the list NodeListItem * pItem = new NodeListItem(pChild); pList->AddTail(pItem); } pChild = pChild->FindNext(); } } else { // Then we were safe to add it to the list... NodeListItem * pItem = new NodeListItem(pNode->FindParent()); pList->AddTail(pItem); } } pNode = FindNextOfClass(pNode, pLayer, CC_RUNTIME_CLASS(TemplateAttribute)); } }

INT32 SliceHelper::CountButtonsInBar (  const StringBase &  BarName  )  [static]

Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 30/9/99 Params: BarName - The name of the bar we refer to Returns: The number of buttons in the bar. Zero if it doesn't think the bar exists. Errors: - Definition at line 207 of file slicehelper.cpp. { String_256 DefaultLayerName; DefaultLayerName.Load(_R(IDS_ROLLOVER_DEFAULT)); // count the buttons on the default layer // every button bar requires a member to be on the default layer // so there is no point in counting any other layer Layer * pDef = FindLayerCalled(DefaultLayerName); INT32 NumberOfButtons = 0; if (pDef) { // store of example attribs of each button in this bar // but we don't need this data so we can throw it away afterwards TemplateAttribute ** ppFoundButton[MAX_BUTTONS_IN_A_BAR]; // scan down from the default layer counting the different button names // that all have the same bar name CountButtonsInBarScan(pDef, (TemplateAttribute **) ppFoundButton, &NumberOfButtons, BarName); } return NumberOfButtons; }

void SliceHelper::CountButtonsInBarScan (  Node *  pNode, TemplateAttribute **  ppFoundButton, INT32 *  pNumberOfButtons, const StringBase &  BarName )  [static]

Finds the number of buttons in the bar and the names of each button, by filling in the ppFoundButton array and pNumberOfButtons. Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 30/9/99 Params: pNode - The node to scan from. Looks at everything down from here. ppFoundButton - Pointer to array of Template Attribute nodes. Each one holds the name of the bar and the name of the button it is. pNumberOfButtons- The number of buttons found so far BarName - The bar we are looking for Returns: - Errors: Limitation of 20 buttons in a bar, which is all the program will let you have. Caution this function is RECURSIVE. Definition at line 255 of file slicehelper.cpp. { // is this a node we are looking for? if (pNode->IsAnAttribute()) // is an attrib { if (IS_A(pNode,TemplateAttribute)) // is a wix attrib { // does it have the correct bar name hidden in the question? if (BarName.CompareTo(((TemplateAttribute *)pNode)->GetQuestion()) == 0) { BOOL ok = TRUE; // get this buttons name String_256 ThisButton = ((TemplateAttribute *)pNode)->GetParam(); for (INT32 i = 0; ok && i < *pNumberOfButtons; i++) { // has this button name been seen before? if (ThisButton.CompareTo(ppFoundButton[i]->GetParam()) == 0) ok = FALSE; } // found a new button name if (ok && *pNumberOfButtons < MAX_BUTTONS_IN_A_BAR) { // add this button to the array ppFoundButton[*pNumberOfButtons] = (TemplateAttribute *)pNode; TRACE( _T("Found new button called ")); TRACE(ppFoundButton[*pNumberOfButtons]->GetParam()); TRACE( _T("\n")); // increase the number of buttons *pNumberOfButtons = *pNumberOfButtons + 1; } } } } else // look at this nodes children { Node * pChildNode = pNode->FindFirstChild(); while (pChildNode) { // ***recursive call*** if (!pChildNode->IsNodeHidden()) CountButtonsInBarScan(pChildNode, ppFoundButton, pNumberOfButtons, BarName); pChildNode = pChildNode->FindNext(); } } }

BOOL SliceHelper::CreatePropertiesForSet (  const String_256 &  SetName, const String_256 &  BarName, BOOL  isSlice, BOOL  Stretches, BOOL  IsBackBar, BYTE  StretchFlags, const String_256 &  StretchedBy, BOOL  DontOverWrite = FALSE, DocRect *  pTargetRect = NULL, DocRect *  pExtenderRect = NULL, UndoableOperation *  pOp = NULL, NodeSetProperty *  pExampleProp = NULL )  [static]

If you create a named set these days you need to create properties in the node set sentinel too so that they are stored somewhere that can be saved out, undone, etc. So if you have made any in your code this is a useful little number. Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 11/11/99 Params: SetName - The name of the set that you wish to create properties for BarName - The name of the bar if it is to belong to one, every thing but a button should ahve this empty isSlice - Is it a slice Stretches - Does it stretch IsBackBar - Is it a back bar - if so it will find its own buttons and set its triggers StretchFlags- If it stretches how does it stretch StretchedBy - What stretches it. This is currently limited to just one set name for the purposes of this function. It could be extended to be a list later in the day. DontOverWrite- If this is TRUE it cuts out if the property already exists strRefBoundsSet - the set, if not empty, whose reference bounds for triggers/targets should be copied into the newly created property. pOp - Ptr to the undoable op Returns: TRUE if it succeeded Definition at line 1664 of file slicehelper.cpp. { NodeSetSentinel * pSentinel = Document::GetSelected()->GetSetSentinel(); if (!pSentinel) return FALSE; // find the property node for the setname NodeSetProperty* pOldSetProp =pSentinel->FindPropertyNode(SetName); // hide the old properties if they existed if (pOldSetProp) { if (DontOverWrite) return TRUE; // it exists and that is good enough for us // need a ptr to an op to hide a node ASSERT(pOp); pOp->DoHideNode(pOldSetProp, FALSE); TRACE( _T("Deleting property set of ")); TRACE(SetName); TRACE( _T("\n")); } // create the new properties NodeSetProperty* pNewSetProp = pSentinel->CreatePropertyNode(SetName); if (pNewSetProp == 0 || !pNewSetProp->CreateDefaults()) return FALSE; // debug info TRACE( _T("Creating property set of ")); TRACE(SetName); TRACE( _T(" ")); NamedSliceProp* pNamedSliceProp = !isSlice ? new NamedSliceProp(SetName, isSlice) : 0; if (!pNamedSliceProp && !isSlice) return FALSE; NamedStretchProp* pNamedStretchProp = new NamedStretchProp(SetName, StretchFlags, Stretches); if (!pNamedStretchProp) { if (pNamedSliceProp) delete pNamedSliceProp; return FALSE; } // add the export props from the example if passed one // this will remember that the user wanted it as a jpeg and saved as whatever if (pExampleProp) { NamedExportProp * pExampleExportProp = (NamedExportProp *) pExampleProp->GetProperty(NamedExportProp::nIndex); if (pExampleExportProp) { NamedExportProp * pNamedExportProp = new NamedExportProp(*pExampleExportProp); if (pNamedExportProp) { SGNameProp* pOld = pNewSetProp->SetProperty(pNamedExportProp); if (pOld) delete pOld; } } } // debugging info if (pNamedSliceProp) TRACE( _T("with slices ")); if (Stretches) TRACE( _T("with stretching ")); // add an extend trigger if (pNamedStretchProp) { if (!StretchedBy.IsEmpty() && !IsBackBar) { pNamedStretchProp->AddTrigger(StretchedBy); // Fix up the trigger and target reference rectangles. if (pTargetRect && pExtenderRect) { TRACE( _T("button")); pNamedStretchProp->SetRefTargetBounds(*pTargetRect); pNamedStretchProp->SetRefUnionTriggerBounds(*pExtenderRect); } } else if (IsBackBar) // build a list of all the members of the bar to make triggers for the back bar { NameGallery * pNameGallery = NameGallery::Instance(); SGUsedNames* pNames = pNameGallery ? pNameGallery->GetUsedNames() : NULL; if (pNameGallery && pNames) { TRACE( _T("BackBar")); // scan to get data about everything pNameGallery->FastUpdateNamedSetSizes(FALSE); INT32 BarNo = GetBarNumberFromBarName(BarName); DocRect RefUnionTriggers; DocRect BackBarBounds; RefUnionTriggers.MakeEmpty(); BackBarBounds.MakeEmpty(); String_256 FoundSetName; // reset all the names SGNameItem * pNameGalleryItem = (SGNameItem*) pNames->GetChild(); while (pNameGalleryItem) { if (pNameGalleryItem->m_BarNumber == BarNo )//&& !pNameGalleryItem->IsABackBar()) { pNameGalleryItem->GetNameText(&FoundSetName); if (FoundSetName.CompareTo(SetName) == 0) { // found yourself the back bar BackBarBounds = pNameGalleryItem->GetSetBounds(); } else { // found a button of this bar RefUnionTriggers = RefUnionTriggers.Union(pNameGalleryItem->GetSetBounds()); pNamedStretchProp->AddTrigger(FoundSetName); } } pNameGalleryItem = (SGNameItem *) pNameGalleryItem->GetNext(); } pNamedStretchProp->SetRefTargetBounds(pTargetRect ? *pTargetRect : BackBarBounds); pNamedStretchProp->SetRefUnionTriggerBounds(pExtenderRect ? *pExtenderRect : RefUnionTriggers); } } } // replace the slice and stretch properties if (pNamedSliceProp) { SGNameProp* pOld = pNewSetProp->SetProperty(pNamedSliceProp); if (pOld) delete pOld; } if (pNamedStretchProp) { SGNameProp* pOld = pNewSetProp->SetProperty(pNamedStretchProp); if (pOld) delete pOld; } TRACE( _T("\n")); // Create a hide node action to hide the node when we undo // this node was attached by the fn "NodeSetProperty* pNewSetProp = pSentinel->CreatePropertyNode(SetName);" // which is 107 lines above HideNodeAction* UndoHideNodeAction; HideNodeAction::Init(pOp, pOp->GetUndoActions(), //&UndoActions, pNewSetProp, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)); // now we have added the property we should also add the standard attrib // to the node set sentinel too Node * pSentinelChild = pSentinel->FindFirstChild(); BOOL Found = FALSE; while (pSentinelChild && !Found) { if (pSentinelChild->IsAnAttribute()) { if (SetName.CompareTo(((TemplateAttribute *)pSentinelChild)->GetParam()) == 0) { if ((BarName.CompareTo(((TemplateAttribute *)pSentinelChild)->GetQuestion()) == 0)) Found = TRUE; else { pOp->DoHideNode(pSentinelChild, TRUE); // hide the near duplicate pSentinelChild = NULL; // end the search } } } if (pSentinelChild) pSentinelChild = pSentinelChild->FindNext(); } if (!Found) { TemplateAttribute* pExtraAttr = new TemplateAttribute(String_256(TEXT("ObjectName")), BarName, SetName); if (!pExtraAttr) return TRUE; // add the attrib into the tree pExtraAttr->AttachNode(pSentinel, FIRSTCHILD); // Create a hide node action to hide the node when we undo HideNodeAction* UndoHideNodeAction; HideNodeAction::Init(pOp, pOp->GetUndoActions(), //&UndoActions, pExtraAttr, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)); } return TRUE; }

void SliceHelper::DeleteUnusedReferences (  const String_256 &  SetName, UndoableOperation *  pOp )  [static]

Definition at line 2889 of file slicehelper.cpp. { NodeSetSentinel * pNodeSetSentinel = Document::GetSelected()->GetSetSentinel(); if (!pNodeSetSentinel) return; // remove all properties of the deleted node Node * pNode = pNodeSetSentinel->FindPropertyNode(SetName); if (pNode) pOp->DoHideNode(pNode, FALSE); // deleted bar members should be got rid of completely // remove the attribs from the sentinel pNode = pNodeSetSentinel->GetNameAttr(SetName); if (pNode) pOp->DoHideNode(pNode, FALSE); }

INT32 SliceHelper::DoesSelectionOnlyContainCompleteSets (   )  [static]

Definition at line 2834 of file slicehelper.cpp. { NameGallery * pNameGallery = NameGallery::Instance(); if (!pNameGallery) return 2; pNameGallery->FastUpdateNamedSetSizes(); // Ensure timely info in NameGallery SGUsedNames* pNames = pNameGallery->GetUsedNames(); if (!pNames) return 2; SGNameItem * pNameGalleryItem = (SGNameItem*) pNames->GetChild(); INT32 ret = 2; // default as none of any set INT32 count = 0; while (pNameGalleryItem) { count = pNameGalleryItem->GetSelectedCount(); if ( count > 0 && count < pNameGalleryItem->GetObjectCount()) { return 0; // has part of this set } else if (count > 0) ret = 1; // has all of this set then pNameGalleryItem = (SGNameItem *) pNameGalleryItem->GetNext(); } return ret; }

void SliceHelper::EnsureTriggerInfo (   )  [static]

Scans the NameGallery ensuring that the triggers are in the right places... Author: Priestley (Xara Group Ltd) <camelotdev@xara.com> Date: 22/01/2001 Definition at line 3403 of file slicehelper.cpp. { NameGallery *pNameGallery = NameGallery::Instance(); SGUsedNames* pNames = pNameGallery->GetUsedNames(); if (!pNames) { return; } SGNameItem* pNameGalleryItem = (SGNameItem*) pNames->GetChild(); // First we need to loop around and set all the triggers to false... while (pNameGalleryItem) { pNameGalleryItem->m_IsATrigger = FALSE; pNameGalleryItem = (SGNameItem *) pNameGalleryItem->GetNext(); } // Now go back to the beginning and work out which named sets have triggers - mark these triggers as being such... pNameGalleryItem = (SGNameItem*) pNames->GetChild(); while (pNameGalleryItem) { NodeSetProperty* pPropNode = NULL; NamedStretchProp* pProp = NULL; // Check if the named set has 'Stretch' property information... pPropNode = pNameGalleryItem->GetPropertyNode(); if (pPropNode) { pProp = (NamedStretchProp*) pPropNode->GetProperty(NamedStretchProp::nIndex); } // If so, and its list of triggers is not empty, loop around ensuring that all of the triggers of this set have their 'is trigger' flag set... if (pProp && !pProp->GetTriggers().empty()) { for (std::list<TriggerSet>::iterator pt = pProp->GetTriggers().begin(); pt != pProp->GetTriggers().end(); pt++) { SGNameItem* pTempTriggerSet = SliceHelper::LookupNameGalleryItem(pt->m_strSet); if (pTempTriggerSet) { pTempTriggerSet->m_IsATrigger = TRUE; } } } // Get the next item and try again... pNameGalleryItem = (SGNameItem *) pNameGalleryItem->GetNext(); } }

TemplateAttribute * SliceHelper::FindFirstSetNodeBelongsTo (  Node *  pNode  )  [static]

returns the fist attrib that may apply to a node / /*! Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 12/5/00 Returns: Definition at line 2110 of file slicehelper.cpp. { while (!pNode->IsLayer()) { // test children for wix attrib Node * pChild = pNode->FindFirstChild(); while (pChild) { if (pChild->IsAnAttribute() && IS_A(pChild,TemplateAttribute)) return (TemplateAttribute *) pChild; pChild = pChild->FindNext(); } pNode = pNode->FindParent(); } return NULL; }

Layer * SliceHelper::FindLayerCalled (  const StringBase &  LayerName  )  [static]

Author: Simon_Knight (Xara Group Ltd) <camelotdev@xara.com> Date: 30/9/99 Params: LayerName - The name of the layer to find Returns: returns the layer node for the Layer name passed in. Returns NULL if there is no layer of that name Errors: - Definition at line 173 of file slicehelper.cpp. 00174 { 00175 // find a spread? 00176 Spread* pSpread = Document::GetSelectedSpread(); 00177 if (pSpread == NULL) 00178 return FALSE; 001