ChartSheet.Location(XlChartLocation, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assemblies:: Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Moves the ChartSheet to a new location.

public Microsoft.Office.Interop.Excel.Chart Location (Microsoft.Office.Interop.Excel.XlChartLocation Where, object Name);

abstract member Location : Microsoft.Office.Interop.Excel.XlChartLocation * obj -> Microsoft.Office.Interop.Excel.Chart

Public Function Location (Where As XlChartLocation, Optional Name As Object) As Chart

Parameters

Where: XlChartLocation

One of the XlChartLocation values that specify where to move the chart.

Name: Object

The name of the sheet where the chart will be embedded if Where is xlLocationAsObject or the name of the new sheet if Where is xlLocationAsNewSheet.

Returns

Chart

Examples

The following code example uses the Location method to move the current Microsoft.Office.Tools.Excel.ChartSheet to a new worksheet named "NewSheet".

private void MoveToNewSheet()
{
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    this.ChartType = Excel.XlChartType.xl3DColumn; 

    this.Location(Excel.XlChartLocation.xlLocationAsNewSheet, 
        "NewSheet");
}

Private Sub MoveToNewSheet()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    Me.ChartType = Excel.XlChartType.xl3DColumn

    Me.Location(Excel.XlChartLocation.xlLocationAsNewSheet, _
        "NewSheet")
End Sub

Applies to