會傳回指定 X 及 Y 座標上圖表元素的相關資訊。 此方法將在 Project 2013 發布版本中移除。
語法
表情。GetChartElement (x, y, ElementID, Arg1, Arg2)
expression 代表 Chart 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| x | 必要 | Long | 圖表元素的 X 座標。 |
| y | 必要 | Long | 圖表元素的 Y 座標。 |
| ElementID | 必要 | Long | 當 GetChartElement 方法回傳時, ElementID 會包含該圖表元素在指定座標的 Office.XLChartItem 值。 欲了解更多資訊,請參閱備註。 |
| Arg1 | 必要 | Long | 當方法返回時, Arg1 包含與圖表元素相關的資訊。 欲了解更多資訊,請參閱備註。 |
| Arg2 | 必要 | Long | 當方法回傳時, Arg2 包含與圖表元素相關的資訊。 欲了解更多資訊,請參閱備註。 |
傳回值
GetChartElement 方法回傳 Nothing。 回傳的值位於 ElementID、 Arg1 和 Arg2 參數中。
註解
注意事項
GetChartElement 方法將在 Project 2013 發布版本中移除。 Project 中的 Chart 物件不實作事件;因此,Project 中的圖表無法透過與滑鼠事件互動來使用 GetChartElement 方法來動畫化。
GetChartElement 方法比較特別,因為你只指定前兩個參數的值。 專案會回傳其他參數的資料,當方法回傳時,你的程式碼應該會檢查那些值。
方法回傳後的 ElementID 值決定 Arg1 與 Arg2 是否包含任何資訊 (詳見表 1) 。
表 1. Arg1 和 Arg2 中的資訊,基於元素 ID
| ElementID 常數 | 常數值 | Arg1 | Arg2 |
|---|---|---|---|
| xl軸 | 21 | 軸向索引 | 軸型 |
| xlAxis標題 | 17 | 軸向索引 | 軸型 |
| xlDisplayUnitLabel | 30 | 軸向索引 | 軸型 |
| xl主要格網線 | 15 | 軸向索引 | 軸型 |
| xl小格網線 | 16 | 軸向索引 | 軸型 |
| xl樞紐圖表投放區 | 32 | 投放區類型 | 無 |
| xlPivotChartFieldButton | 31 | 投放區類型 | 樞紐欄位索引 |
| xlDownBars | 20 | GroupIndex | 無 |
| xlDropLines | 26 | GroupIndex | None |
| xlHiLoLines | 25 | GroupIndex | 無 |
| xlRadarAxisLabels | 27 | GroupIndex | 無 |
| xl系列線 | 22 | GroupIndex | 無 |
| xlUpBars | 18 | GroupIndex | 無 |
| xl圖表區域 | 2 | 無 | 無 |
| xl排行榜標題 | 4 | 無 | 無 |
| xl角 | 6 | 無 | 無 |
| xlDataTable | 7 | 無 | 無 |
| xl樓層 | 23 | 無 | 無 |
| xlLeaderLines | 29 | 無 | 無 |
| xl傳說 | 24 | 無 | 無 |
| xlNothing | 28 | 無 | 無 |
| xl劇情區域 | 19 | 無 | 無 |
| xl牆 | 5 | 無 | 無 |
| xlDataLabel | 7 | 系列索引 | 點索引 |
| xlErrorBars | 9 | 系列索引 | 無 |
| xl傳說條目 | 12 | 系列索引 | 無 |
| xl傳說鑰匙 | 13 | 系列索引 | 無 |
| xl系列賽 | 3 | 系列索引 | 點索引 |
| xl形狀 | 14 | ShapeIndex | 無 |
| xl趨勢線 | 8 | 系列索引 | 趨勢線指數 |
| xlXErrorBars | 10 | 系列索引 | 無 |
| xlYErrorBars | 11 | 系列索引 | 無 |
表 2 描述方法返回後 Arg1 與 Arg2 的意義。 參數欄中的值取自表 1。
表 2. Arg1 與 Arg2 中資料的意義
| 引數 | 說明 |
|---|---|
| 軸向索引 | 指定座標軸主要或次要。 可以是以下 Office.XlAxisGroup 常數之一: xlPrimary 或 xlSecondary。 |
| 軸型 | 會指定座標軸類型。 可以是以下 Office.XlAxisType 常數之一: xlCategory、 xlSeriesAxis 或 xlValue。 |
| 投放區類型 | 會指定放置區域類型: 資料行、 資料、 頁面或列欄位。 可以是以下 Office.XlPivotFieldOrientation 常數之一: xlColumnField、 xlDataField、 xlPageField 或 xlRowField。 欄和列欄位常數分別指定數列] 和 [類別] 欄位。 |
| GroupIndex | 指定 Office.IMsoChart.ChartGroups 集合中特定圖表群組的偏移量。 |
| 樞紐欄位索引 | 在 Excel.PivotFields 集合中指定特定欄位 (系列) 、資料、頁面或列 (類別) 欄位的偏移量。 若投放區類型為 xlDataField,則值為 -1。 |
| 點索引 | 在 Office.IMsoSeries.Points 集合中指定序列中特定點的偏移量。 值為 1 表示所有資料點都已選取。 |
| 系列索引 | 指定 Office.IMsoChart.SeriesCollection 中特定系列的偏移量。 |
| ShapeIndex | 指定特定圖案在 Shapes 集合內的位移。 |
| 趨勢線指數 | 在 Office.IMsoSeries.Trendlines 集合中指定系列中特定趨勢線的偏移量。 |
範例
以下範例取得圖表中第 (100、100) 的元素資訊。 例如,若點位於繪圖區域內,立即窗格中的輸出為 idNum: 19, a: 0, b: 0。 根據表1的資訊, xlPlotArea = 19。
Sub TestGetChartElements()
Dim chartShape As Shape
Dim reportName As String
Dim x As Long
Dim y As Long
Dim idNum As Long
Dim a As Long
Dim b As Long
reportName = "Simple scalar chart"
Set chartShape = ActiveProject.Reports(reportName).Shapes(1)
' Specify a point in the chart.
x = 100
y = 100
chartShape.Chart.GetChartElement x, y, idNum, a, b
Debug.Print "idNum: " & idNum & ", a: " & a & ", b: " & b
End Sub
另請參閱
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。