DIAdem Help

Method: MoveArea for Sheet

  • Updated2024-09-12
  • 2 minute(s) read

Method: MoveArea for Sheet

Moves an area in DIAdem VIEW and splits the specified target area in the same or in another worksheet. Use the Move for Areas method to copy an area within the same worksheet. Use the CopyArea for Sheet or the Copy for Areas method to move an area.

Set oArea = Object.MoveArea(SourceAreaNameOrIndex, TargetSheetNameOrIndex, TargetAreaNameOrIndex, enumSplitDirection, Ratio)
ObjectSheet
Object with this method
SourceAreaNameOrIndexVariant
Specifies the name or the index of the area DIAdem moves.
TargetSheetNameOrIndexVariant
Specifies the name or index of the worksheet to which DIAdem copies the area. If you specify an empty string, DIAdem creates a new worksheet and ignores the subsequent parameters.
TargetAreaNameOrIndexVariant
Specifies the name or index of the target area.
enumSplitDirectionLongInteger

Specifies the relative position of the moved area to the target area.
1eSplitTopTop
2eSplitBottomBottom
3eSplitLeftLeft
4eSplitRightRight
RatioDouble
Specifies the split ratio for values from 0 to 1. The split ratio is the part of the original area which the moved area occupies. If the split ratio is 0.25, the moved area takes up a quarter of the original area.
oAreaArea
Returned object of the moved area.

The following example moves the first range of the active worksheet to the right of the first area of a new worksheet. The moved area occupies one quarter of the target area.

VBScriptPython

 

Dim oMySheet, oNewSheet, oMyMovedArea
Set oMySheet = View.ActiveSheet
Set oNewSheet = View.Sheets.Add("MyNewSheet")
Set oMyMovedArea = oMySheet.MoveArea(1, oMySheet.Index, 1, eSplitRight ,0.25)

The following example moves the first area of the active worksheet to a new worksheet.

VBScriptPython

 

Dim oMySheet, oMyMovedArea
Set oMySheet = View.ActiveSheet
Set oMyMovedArea = oMySheet.MoveArea(1, "", 1, eSplitRight ,0)