2.5.9 g2w

Brief Information

Move graphs to worksheet cells in an mxn arrangement

Command Line Usage

1. g2w option:=recursive;

2. g2w option:= recursive cols:=4;

3. g2w embed:=link;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display
Name
Variable
Name
I/O
and
Type
Default
Value
Description
Output Worksheet ow

Output

Worksheet

<new>

Specifies the worksheet which the graphs will be moved into. See the syntax here.

Move Graphs From option

Input

int

folder

Specifies the graphs to be moved.
Option list

  • page:Active Page
    Moves all graphs in the active page into the target worksheet.
  • folder:All in Active Folder
    Moves all graphs in the active folder, not including those in its subfolders, into the target worksheet.
  • recursive:All in Active Folder (Recursive)
    Moves all graphs in the active folder, including those in the subfolders, into the target worksheet.
  • open:All in Active Folder (Open)
    Moves all open graphs in the active folder into the target worksheet. All hidden graphs are excluded.
  • embed:All in Active Folder (Include Embedded)
    Moves all open graphs in the active folder, including those that are embedded in worksheets, into the target worksheet. Note: this option is only available when the Embed variable is set to Linking.
  • project:All in Project
    Moves all graphs in the project.
  • specified:Specified
    Moves the specified graphs into the target worksheet. The Graphs box will be enabled.


Graphs graphs

Input

string

If the Move Graphs From variable is set to Specified, user can use this text box to enter the names of the graphs to be moved. In this case, the browse button to the right of this text box becomes enabled and you can use it to browse for the graphs to be moved. However, if other options are selected for the Move Graphs From variable, this textbox will be read-only. You can see the names of the graphs that will be moved, but you cannot edit the content of this text box.

Graph Arrangement arrange

Input

int

nm

Specifies how to arrange the graphs and their names
Option list

  • Vertical:Vertically
    Two columns in the target worksheet will be used. The name so the graphs will be put in the first column. And the graphs will be put in the second column.
  • nm:N*M Panel
    N columns in the target worksheet will be used, where N is specified by the cols variable. The name of the graph will be put in the cell above the cell where the graph is embedded.


Columns(N) cols

Input

double

3

This variable is available only when the arrange variable is set to NMPanel. It specifies the number of columns that will be used to arrange the graphs.

Embed embed

Input

int

embed

Specifies whether or not to embed the graphs. If the graphs are not embedded, they will be linking to the worksheet instead.
Option list

  • Embed:Embedding
    Embeds the graphs into the target workbook.
  • Link:Linking
    Link the graphs to the target workbook.


Description

This function moves the selected graphs into a worksheet. You can use it to arrange graphs.

Graphs can be either embedded into the workbook or linked it. When a graph is embedded, it cannot be seen in the Project Explorer. However, you can open it again by double-clicking on the cell where it is embedded into. When a graph is linked, it will not be moved into the cell. However, you can see a miniature of it there. If you double-click on the cell, the linked graph will be active.

Related X-Functions

insertGraph, insertSparklines, insertArrow, insertImg, insertNotes, insertVar


Keywords:embedding