OpMoveToLyrBehind Class Reference

This class represents the move to layer behind operation. More...

#include <zordops.h>

Inheritance diagram for OpMoveToLyrBehind:

List of all members.

Public Member Functions
	OpMoveToLyrBehind ()
	OpMoveToLyrBehind constructor.
void	Do (OpDescriptor *)
	Performs the OpMoveToLyrBehind operation. This moves all selected nodes (which are not on the lowest visible layer) to the highest z-order position on the next visible layer behind.
virtual BOOL	MayChangeNodeBounds () const
Static Public Member Functions
static BOOL	Init ()
	OpMoveToLyrBehind initialiser method.
static OpState	GetState (String_256 *, OpDescriptor *)
	For finding OpMoveToLyrBehind's state.

---

Detailed Description

This class represents the move to layer behind operation.

Author:

Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com>

Date:

9/7/93

See also:

OpBringToFront

OpPutToBack

OpMoveForwards

OpMoveBackwards

OpMoveToLyrInFront Documentation: specs.doc

Definition at line 284 of file zordops.h.

---

Constructor & Destructor Documentation

OpMoveToLyrBehind::OpMoveToLyrBehind (   )

OpMoveToLyrBehind constructor. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 29/9/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Definition at line 2539 of file zordops.cpp. : SelOperation() { }

---

Member Function Documentation

void OpMoveToLyrBehind::Do (  OpDescriptor *   )  [virtual]

Performs the OpMoveToLyrBehind operation. This moves all selected nodes (which are not on the lowest visible layer) to the highest z-order position on the next visible layer behind. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 16/8/93 Parameters: OpDescriptor  (unused) [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: - Reimplemented from Operation. Definition at line 2794 of file zordops.cpp. { // Obtain the current selections Range Sel(*(GetApplication()->FindSelection())); RangeControl rg = Sel.GetRangeControlFlags(); rg.PromoteToParent = TRUE; Sel.Range::SetRangeControl(rg); // Find the first node which is selected Node* FirstSelectedNode = Sel.FindFirst(); // The first selected node should not ever be NULL ENSURE(FirstSelectedNode != NULL, "The OpMoveToLyrInFront's GetState fn has not done a very good job"); if (FirstSelectedNode != NULL) { if (!DoStartSelOp(FALSE,FALSE)) // Try to record the selection state , don't // render the blobs though { goto EndOperation; } // We need to invalidate the region if (!DoInvalidateNodesRegions(Sel, TRUE, FALSE, FALSE, FALSE)) { goto EndOperation; } Node* CurrentNode = FirstSelectedNode; // RangeControl LyrCntrl = { TRUE, FALSE, FALSE }; // Selected + don't cross layers Range LayerRange; Node* Destination = NULL; // Pointer to the last child of the previous layer. // We move all nodes to be next siblings of this node Node* ThisLayer = NULL; Layer* PrevLayer = NULL; Node* LastSelectedThisLayer = NULL; Node* NextNode = NULL; BOOL OldVisible = FALSE; BOOL OldLocked = FALSE; #ifndef WEBSTER MODE PresentMode = LAYER; #endif // Loop for all layers while (CurrentNode != NULL) { ENSURE(CurrentNode->IsAnObject(), "Non ink node in OpMoveToLyrBehind"); // Create a range of selected nodes on this layer Range temp(CurrentNode, NULL, RangeControl(TRUE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,TRUE) ); LayerRange = temp; // LayerRange = Range(CurrentNode, // NULL, // RangeControl(TRUE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,TRUE) ); // ----------------------------------------------------------------------------- // Find the last child object of the previous visible layer, which is the destination for all // nodes moved from this layer. // - there may not be a previous layer // - there may not be any children on the previous layer Destination = NULL; ThisLayer = CurrentNode->FindParent(CC_RUNTIME_CLASS(Layer)); if (ThisLayer != NULL) ((Layer*)ThisLayer)->InvalidateBoundingRect(); // WEBSTER - markn 2/2/97 // Not needed in Webster. // Neville 23/6/97 Now needed but must work in Frame mode in Webster // RanbirR - 28/10/97 - Changed for Camelot v2, Frame/Layer integration. #ifdef WEBSTER // ---------------------------------------------------------------------------- // Find the previous frame PrevLayer = (Layer*)ThisLayer; do { PrevLayer = PrevLayer->FindPrevFrameLayer(); if (PrevLayer != NULL) { // Is the layer not a guide or a page background layer? if (!PrevLayer->IsGuide() && !PrevLayer->IsPageBackground()) { // found break; } } } while (PrevLayer != NULL); if (PrevLayer != NULL) { // Make the layer visible and editable so we don't loose the selection // do it blatently as it will be fixed up properly latter OldVisible = PrevLayer->IsVisible(); OldLocked = PrevLayer->IsLocked(); PrevLayer->SetVisible(TRUE); PrevLayer->SetLocked(FALSE); } #else // ----------------------------------------------------------------------------- // Determine the document mode. PrevLayer = (Layer*)ThisLayer; PresentMode = (MODE)PrevLayer->IsFrame(); if(PresentMode == LAYER) { do { PrevLayer = (Layer*)(PrevLayer->FindPrevious(CC_RUNTIME_CLASS(Layer))); if (PrevLayer != NULL) { if (PrevLayer->IsVisible() && !PrevLayer->IsLocked() && !PrevLayer->IsGuide()) { // found break; } } } while (PrevLayer != NULL); if (PrevLayer != NULL) { // Make the layer visible and editable so we don't loose the selection // do it blatently as it will be fixed up properly latter OldVisible = PrevLayer->IsVisible(); OldLocked = PrevLayer->IsLocked(); PrevLayer->SetVisible(TRUE); PrevLayer->SetLocked(FALSE); } } else if (PresentMode == FRAME) { // Find the previous visible layer do { PrevLayer = PrevLayer->FindPrevFrameLayer(); if (PrevLayer != NULL) { // Is the layer not a guide or a page background layer? if (!PrevLayer->IsGuide() && !PrevLayer->IsPageBackground()) { // found break; } } } while (PrevLayer != NULL); if (PrevLayer != NULL) { // Make the layer visible and editable so we don't loose the selection // do it blatently as it will be fixed up properly latter OldVisible = PrevLayer->IsVisible(); OldLocked = PrevLayer->IsLocked(); PrevLayer->SetVisible(TRUE); PrevLayer->SetLocked(FALSE); } } else ERROR3("OpMoveToLyrBehind::Do - Bad mode"); #endif if (PrevLayer != NULL) { PrevLayer->InvalidateBoundingRect(); Destination = PrevLayer->FindLastChild(); if (Destination != NULL) // It will be NULL if there are no objects on the // previous layer { // The Destination node could be an Insertion node, we certainly don't want to insert // after that if (!(Destination->IsAnObject())) { Destination = Destination->FindPrevious(CC_RUNTIME_CLASS(NodeRenderableInk)); } } } // If there is a previous layer then shift all selected nodes // on this layer to the layer behind. do { NextNode = LayerRange.FindNext(CurrentNode); // Hand over hand if (PrevLayer != NULL) { if (Destination == NULL) { // The destination is NULL which means that the layer // has no existing objects ((NodeRenderableBounded*)CurrentNode)->ReleaseCached(TRUE, FALSE, FALSE, TRUE); if (!DoMoveNode(CurrentNode, PrevLayer, FIRSTCHILD)) { goto EndOperation; } ((NodeRenderableBounded*)CurrentNode)->ReleaseCached(TRUE, FALSE, FALSE, TRUE); CurrentNode->SetSelected(TRUE); } else { ((NodeRenderableBounded*)CurrentNode)->ReleaseCached(TRUE, FALSE, FALSE, TRUE); if (!DoMoveNode(CurrentNode, Destination, NEXT)) { goto EndOperation; } ((NodeRenderableBounded*)CurrentNode)->ReleaseCached(TRUE, FALSE, FALSE, TRUE); CurrentNode->SetSelected(TRUE); } Destination = CurrentNode; } LastSelectedThisLayer = CurrentNode; // Used to find first // selected on next layer CurrentNode = NextNode; } while (CurrentNode != NULL); // #ifdef WEBSTER // Include in Camelot2 for Frame/Layer integration - RanbirR 03/11/97 #ifdef WEBSTER if (PrevLayer != NULL) #else if (PrevLayer != NULL && PresentMode == FRAME) #endif { // Put back the old states so we get the redraw correct PrevLayer->SetVisible(OldVisible); //PrevLayer->SetLocked(OldLocked); } //#endif // Obtain the first selected node of the next layer CurrentNode = Sel.FindNext(LastSelectedThisLayer); } //#ifdef WEBSTER Include in Camelot2 for Frame/Layer integration - RanbirR 03/11/97 // Switch to viewing the destination layer // Otherwise, the user will see the objects dissappear and will be worried // Also, the range blows up as the destination is invisible #ifdef WEBSTER // Include in Camelot2 for Frame/Layer integration - RanbirR 03/11/97 if (PrevLayer != NULL) #else if (PrevLayer != NULL && PresentMode == FRAME) #endif { PORTNOTETRACE("gallery", "Removed used of FrameSGallery from OpMoveToLyrBehind"); #if !defined(EXCLUDE_FROM_XARALX) FrameSGallery::MakeActiveLayer(PrevLayer); BROADCAST_TO_ALL(LayerMsg(PrevLayer,LayerMsg::UPDATE_ACTIVE_LAYER)); #endif } //#endif // WEBSTER // We need to invalidate the region if (!DoInvalidateNodesRegions(*(GetApplication()->FindSelection()), TRUE)) { goto EndOperation; } // Call ChangeBounds() on the first node to ensure all parent node bounds contain // the newly moved nodes bounds if (FirstSelectedNode->IsBounded()) { NodeRenderableBounded* pNodeRB = (NodeRenderableBounded*)FirstSelectedNode; pNodeRB->InvalidateBoundingRect(); } } EndOperation: GetApplication()->UpdateSelection(); End(); // End of operation }

OpState OpMoveToLyrBehind::GetState (  String_256 *  UIDescription, OpDescriptor *  )  [static]

For finding OpMoveToLyrBehind's state. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 28/9/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The state of the OpMoveToLyrBehind operation Errors: - See also: - Definition at line 2608 of file zordops.cpp. { OpState OpSt; // In Camelot, work as before in layer mode // In Webster, work only on frame layers // This should never go off in Webster but we will leave it in just in case String_256 DisableReason; SelRange Sel(*(GetApplication()->FindSelection())); RangeControl rg = Sel.GetRangeControlFlags(); rg.PromoteToParent = TRUE; Sel.Range::SetRangeControl(rg); Node* pNode = Sel.FindFirst(); while (pNode != NULL) { Node* pLayer = pNode->FindParent(CC_RUNTIME_CLASS(Layer)); if (pLayer != NULL && ((Layer*)pLayer)->IsGuide()) { *UIDescription = String_256(_R(IDS_CANT_MOVE_OFF_GUIDE_LAYER)); OpSt.Greyed = TRUE; return OpSt; } pNode = Sel.FindNext(pNode); } // WEBSTER - markn 2/2/97 // Not needed in Webster. Now required but must be frame orientated // RanbirR - 28/10/97 - Changed for Camelot v2, Frame/Layer integration. #ifdef WEBSTER // We need to work in Frame mode in Webster // The operation is disabled if there does not exist a selected node on a layer // which is not the bottom-most layer. // Find the first node which is selected Node* pLastSelectedNode = Sel.FindLast(); // The operation is disabled if the last selected object is already on the lowest // visible layer. BOOL LowestVisible = TRUE; Layer* pCurrentLayer = (Layer*) (pLastSelectedNode->FindParent(CC_RUNTIME_CLASS(Layer))); ERROR2IF(pCurrentLayer == NULL, OpSt, "Cannot find layer of first selected object"); do { pCurrentLayer = pCurrentLayer->FindPrevFrameLayer(); if (pCurrentLayer != NULL) { // Is the layer not a guide or a page background layer? if (!pCurrentLayer->IsGuide() && !pCurrentLayer->IsPageBackground()) { LowestVisible = FALSE; // The last node selected is not on the lowest visible frame // so the operation can be performed. break; } } } while (pCurrentLayer != NULL); #else // Find the first node which is selected Node* pLastSelectedNode = Sel.FindLast(); // Karim 18/04/2000 - spot-check! - any NULL pointers?? if (pLastSelectedNode == NULL) { // fail in the same way as the layer check below, but we'll only complaing in debug. ERROR3("OpMoveToLyrBehind::GetState; NULL returned as last node in Selection!"); return OpSt; } // The operation is disabled if the last selected object is already on the lowest // visible layer. BOOL LowestVisible = TRUE; Layer* pCurrentLayer = (Layer*) (pLastSelectedNode->FindParent(CC_RUNTIME_CLASS(Layer))); ERROR2IF(pCurrentLayer == NULL, OpSt, "Cannot find layer of first selected object"); // Determine the Document mode. MODE PresentMode = (MODE)pCurrentLayer->IsFrame(); if (PresentMode == LAYER) { do { pCurrentLayer = pCurrentLayer->FindPrevLayer(); if (pCurrentLayer != NULL) { // Is the layer visible if (pCurrentLayer->IsVisible() && !pCurrentLayer->IsLocked() && !pCurrentLayer->IsGuide()) { LowestVisible = FALSE; // The last node selected is not on the lowest visible layer // so the operation can be performed. break; } } } while (pCurrentLayer != NULL); } else if (PresentMode == FRAME) { do { pCurrentLayer = pCurrentLayer->FindPrevFrameLayer(); if (pCurrentLayer != NULL) { // Is the layer not a guide or a page background layer? if (!pCurrentLayer->IsGuide() && !pCurrentLayer->IsPageBackground()) { LowestVisible = FALSE; // The last node selected is not on the lowest visible frame // so the operation can be performed. break; } } } while (pCurrentLayer != NULL); } else ERROR3("OpMoveToLyrInFront::GetState - Bad mode!"); #endif // WEBSTER if (LowestVisible) { // The operation must be disabled OpSt.Greyed = TRUE; if (Sel.FindFirst() == pLastSelectedNode) { #ifdef WEBSTER // There is only a single selected node DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_FRMS)); #else if(PresentMode == FRAME) DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_FRMS)); else if(PresentMode == LAYER) DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_LYRS)); else ERROR3("OpMoveToLyrInBehind::GetState - Bad mode!"); #endif } else { #ifdef WEBSTER // There is more than one selected node DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_FRM)); #else if(PresentMode == FRAME) { // There is more than one selected node DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_FRM)); } else if (PresentMode == LAYER) { // There is more than one selected node DisableReason = String_256(_R(IDS_ALREADY_ON_BOTTOM_LYRP)); } else ERROR3("OpMoveToLyrInFront::GetState - Bad mode!"); #endif } } *UIDescription = DisableReason; return(OpSt); }

BOOL OpMoveToLyrBehind::Init (  void   )  [static]

OpMoveToLyrBehind initialiser method. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 28/9/93 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the operation could be successfully initialised FALSE if no more memory could be allocated Errors: ERROR will be called if there was insufficient memory to allocate the operation. See also: - Reimplemented from SimpleCCObject. Definition at line 2561 of file zordops.cpp. { /* return (RegisterOpDescriptor(0, _R(IDS_MOVELAYERBEHIND), CC_RUNTIME_CLASS(OpMoveToLyrBehind), OPTOKEN_MOVELAYERBEHIND, OpMoveToLyrBehind::GetState, 0, // help ID _R(IDBBL_MOVELAYERBEHIND), _R(IDD_ANIMATIONBAR), // resource ID _R(IDC_FRAME_MOVEDOWNAFRAME), // control ID SYSTEMBAR_ANIMATION, // Bar ID TRUE, // Receive messages FALSE, FALSE, 0, (GREY_WHEN_NO_CURRENT_DOC | GREY_WHEN_NO_SELECTION) )); */ FrameBehindOpDescriptor* pOpDesc = new FrameBehindOpDescriptor(OPTOKEN_MOVELAYERBEHIND, CC_RUNTIME_CLASS(OpMoveToLyrBehind), OpMoveToLyrBehind::GetState); if(pOpDesc) return TRUE; return FALSE; }

virtual BOOL OpMoveToLyrBehind::MayChangeNodeBounds (   )  const [inline, virtual]

Reimplemented from SelOperation. Definition at line 295 of file zordops.h. { return FALSE; }

---

The documentation for this class was generated from the following files:

• Kernel/zordops.h (r1785/r1282)
• Kernel/zordops.cpp (r1785/r1282)

---