Método Chart.Location

Artigo
01/09/2014

Move o controle de Chart para um novo local.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Location ( _
    Where As XlChartLocation, _
    Name As Object _
) As Chart

Chart Location(
    XlChartLocation Where,
    Object Name
)

Parâmetros

Where
Tipo: Microsoft.Office.Interop.Excel.XlChartLocation
XlChartLocation.Onde mover o elemento gráfico.

Name
Tipo: System.Object
O nome da planilha onde o gráfico é inserido se Where é xlLocationAsObject ou o nome da nova folha se Where é xlLocationAsNewSheet.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.Chart

Comentários

Se você desejar mover um gráfico a outra posição em uma folha, use a propriedade de Top e a propriedade Left de ChartArea. Você pode obter o objeto de ChartArea de Chart usando a propriedade de ChartArea .

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria Chart e usa o método de Location para mover o gráfico para uma nova folha chamada “vendas”.

Private Sub MoveChartToNewSheet()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")

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

    Chart1.Location(Excel.XlChartLocation.xlLocationAsNewSheet, "Sales")
End Sub

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

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H12"], 
        "chart1");

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

    chart1.Location(Excel.XlChartLocation.xlLocationAsNewSheet, 
        "Sales");
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via