Método ChartSheetBase.GetChartElement
Deixa as informações sobre o elemento gráfico no especificado coordenadas x e Y.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxe
'Declaração
Public Sub GetChartElement ( _
x As Integer, _
y As Integer, _
ByRef elementID As Integer, _
ByRef arg1 As Integer, _
ByRef arg2 As Integer _
)
public void GetChartElement(
int x,
int y,
ref int elementID,
ref int arg1,
ref int arg2
)
Parâmetros
- x
Tipo: System.Int32
A coordenada x do elemento gráfico.
- y
Tipo: System.Int32
A coordenada y do elemento gráfico.
- elementID
Tipo: System.Int32%
Quando o método retorna, esse argumento contém o XlChartItem o valor do elemento gráfico em coordenadas especificadas.Para obter mais informações, consulte "Comentários" seção.
- arg1
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações relacionadas ao elemento gráfico.Para obter mais informações, consulte "Comentários" seção.
- arg2
Tipo: System.Int32%
Quando o método retorna, esse argumento contém informações relacionadas ao elemento gráfico.Para obter mais informações, consulte "Comentários" seção.
Comentários
Esse método é incomum que você especificar valores para os dois primeiros de argumentos. Excel de Microsoft Office preenche os outros argumentos e seu código deverá examinar esses valores quando o método retorna.
O valor de ElementID após o método retornar determina se Arg1 e Arg2 contêm alguma informação, como mostrado na tabela a seguir.
ElementID |
Arg1 |
Arg2 |
---|---|---|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
AxisIndex |
AxisType |
|
DropZoneType |
None |
|
DropZoneType |
PivotFieldIndex |
|
GroupIndex |
None |
|
GroupIndex |
None |
|
GroupIndex |
None |
|
GroupIndex |
None |
|
GroupIndex |
None |
|
GroupIndex |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
None |
None |
|
SeriesIndex |
PointIndex |
|
SeriesIndex |
None |
|
SeriesIndex |
None |
|
SeriesIndex |
None |
|
SeriesIndex |
PointIndex |
|
ShapeIndex |
None |
|
SeriesIndex |
TrendLineIndex |
|
SeriesIndex |
None |
|
SeriesIndex |
None |
A tabela a seguir descreve o significado de Arg1 e Arg2 após o método retorna.
Argument |
Description |
---|---|
AxisIndex |
Especifica se o eixo é primário ou secundário. Pode ser uma das seguintes XlAxisGroup constantes: xlPrimary or xlSecondary. |
AxisType |
Especifica o tipo de eixo. Pode ser uma das seguintes XlAxisType constantes: xlCategory, xlSeriesAxis, or xlValue. |
DropZoneType |
Especifica o tipo de zona de soltar: coluna, dados, página ou campo de linha. Pode ser uma das seguintes XlPivotFieldOrientation constantes: xlColumnField, xlDataField, xlPageField, or xlRowField. As constantes de campo de coluna e linha especificam os campos de série e categoria, respectivamente. |
GroupIndex |
Especifica o deslocamento dentro da Microsoft.Office.Interop.Excel.ChartGroups a coleção para um grupo gráfico específico. |
PivotFieldIndex |
Especifica o deslocamento dentro da coleção de T:Microsoft.Office.Interop.Excel.PivotFields para uma coluna específica (série), dados, página ou campo de linha (categoria). -1 se o tipo de zona de soltar é xlDataField. |
PointIndex |
Especifica o deslocamento dentro da Points coleção para um ponto específico dentro de uma série. Um valor de – 1 indica que todos os pontos de dados estão selecionados. |
SeriesIndex |
Especifica o deslocamento dentro da Series coleção para uma série específica. |
ShapeIndex |
Especifica o deslocamento dentro da Shapes coleção para uma forma específica. |
TrendlineIndex |
Especifica o deslocamento dentro da Trendlines coleção para uma linha de tendência específica dentro de uma série. |
Exemplos
O seguinte exemplo de código usa a GetChartElement método para exibir o elemento gráfico quando um usuário clica no gráfico.
Private Sub DisplayChartElement()
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.xlColumnClustered
End Sub
Sub ChartSheet_MouseDown(ByVal Button As Integer, ByVal Shift As Integer, _
ByVal x As Integer, ByVal y As Integer) Handles Me.MouseDown
Dim elementID As Integer = 0
Dim arg1 As Integer = 0
Dim arg2 As Integer = 0
Me.GetChartElement(x, y, elementID, arg1, arg2)
MsgBox("Chart element is: " & CType(elementID, Excel.XlChartItem).ToString() _
& Constants.vbNewLine & "arg1 is: " & arg1.ToString() _
& Constants.vbNewLine & "arg2 is: " & arg2.ToString())
End Sub
private void DisplayChartElement()
{
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.xlColumnClustered;
this.MouseDown +=
new Excel.ChartEvents_MouseDownEventHandler(ChartSheet_MouseDown);
}
void ChartSheet_MouseDown(int Button, int Shift, int x, int y)
{
Int32 elementID = 0;
Int32 arg1 = 0;
Int32 arg2 = 0;
this.GetChartElement(x, y, ref elementID, ref arg1, ref arg2);
MessageBox.Show("Chart element is: " + ((Excel.XlChartItem)elementID).ToString()
+ "\n arg1 is: " + arg1.ToString() + "\n arg2 is: " + arg2.ToString());
}
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áveis.