Chart.ColumnGroups 方法

在平面圖表上，傳回表示單一直條圖群組 (ChartGroup 物件) 或直條圖群組集合 (ChartGroups 集合) 的物件。

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function ColumnGroups ( _
    Index As Object _
) As Object

Object ColumnGroups(
    Object Index
)

參數

• Index
  型別：System.Object
  指定圖表群組。

傳回值

型別：System.Object
表示單一直條圖群組 (ChartGroup 物件) 或直條圖群組集合 (ChartGroups 集合) 的物件。

備註

選擇性參數

如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。

範例

下列程式碼範例會建立直條圖 Chart，然後使用 ColumnGroups 方法設定圖中直條的間距。

Private Sub UseColumnGroups()
    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.xlColumnClustered

    Dim group As Excel.ChartGroup = CType(Chart1.ColumnGroups(1), _
        Excel.ChartGroup)

    group.GapWidth = 400
End Sub

private void UseColumnGroups()
{
    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.xlColumnClustered;

    Excel.ChartGroup group =
        (Excel.ChartGroup)chart1.ColumnGroups(1);

    group.GapWidth = 400;
}

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

Chart 介面

Microsoft.Office.Tools.Excel 命名空間