ChartGroup Interface

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Representa uma ou mais séries plotadas em um gráfico com o mesmo formato. O objeto ChartGroup é um membro da ChartGroups coleção.

public interface class ChartGroup

[System.Runtime.InteropServices.Guid("00020859-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ChartGroup

Public Interface ChartGroup

Atributos

GuidAttribute InterfaceTypeAttribute

Comentários

Um gráfico contém um ou mais grupos de gráficos, cada grupo gráfico contém uma ou mais séries e cada seqüência contém um ou mais pontos. Por exemplo, um único gráfico pode conter um grupo de gráficos de linha, que contém todas as séries plotadas com o formato de gráfico de linhas e um grupo de gráficos de barras, contendo todas as séries plotadas com o formato de gráfico de barras.

Use ChartGroups(index), onde index é o número de índice do grupo de gráficos, para retornar um único objeto ChartGroup . Se o gráfico tiver sido ativado, você poderá usar a ActiveChart propriedade.

Como o número de índice para um determinado grupo gráfico pode mudar se o formato do gráfico usado para este grupo for alterado, pode ser mais fácil usar um dos métodos de atalho de grupo gráfico nomeados para retornar um determinado grupo gráfico. O PieGroups(Object) método retorna a coleção de grupos de gráficos de pizza em um gráfico, o LineGroups(Object) método retorna a coleção de grupos de gráficos de linhas e assim por diante. Cada um destes métodos pode ser usado com um número de índice para retornar um único objeto ChartGroup ou sem um número do índice para retornar uma coleção ChartGroups. Os seguintes métodos de grupo de gráficos estão disponíveis:

• AreaGroups(Object) Método
• BarGroups(Object) Método
• ColumnGroups(Object) Método
• DoughnutGroups(Object) Método
• LineGroups(Object) Método
• PieGroups(Object) Método

Propriedades

Application	Retorna um Application objeto que representa o criador do objeto especificado (você pode usar essa propriedade com um objeto de Automação OLE para retornar o aplicativo desse objeto).
AxisGroup	Retorna o grupo da série ou do grupo de gráficos especificado.
BubbleScale	Retorna ou define o fator de dimensionamento para balões no grupo de gráficos especificado. Pode ser um valor inteiro de 0 (zero) a 300, correspondente a uma porcentagem do tamanho padrão. Aplica-se apenas a gráficos de bolhas.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual esse objeto foi criado. Se o objeto foi criado no Microsoft Excel, essa propriedade retornará a sequência XCEL, que é equivalente ao número hexadecimal 5843454C.
DoughnutHoleSize	Retorna ou define o tamanho do buraco em um grupo de gráficos de rosca. O tamanho do buraco é expresso como um percentual do tamanho do gráfico, entre 10 e 90%.
DownBars	Retorna um DownBars objeto que representa as barras para baixo em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
DropLines	Retorna um DropLines objeto que representa as linhas suspensas de uma série em um gráfico de linhas ou gráfico de área. Aplica-se apenas a gráficos de linhas e a gráficos de áreas.
FirstSliceAngle	Retorna ou define o ângulo da primeira fatia de gráfico de tortas ou gráfico de donuts em graus (no sentido horário da vertical). Aplica-se apenas a pizza, torta 3-D e gráficos de rosca..
GapWidth	Gráficos de barras e colunas: retorna ou define o espaço entre clusters de barras ou colunas como uma porcentagem da largura da barra ou da coluna. Gráficos pizza de pizza e barra de pizza: Retorna ou define o espaço entre as seções primária e secundária do gráfico.
Has3DShading	True se o grupo gráfico possuir sombreamento tridimensional. Essa propriedade só se aplica a gráficos de superfície e retornará um erro em tempo de execução se você tentar defini-la como um gráfico fora da superfície.
HasDropLines	True se o gráfico de linhas ou gráfico de área tem grades verticais. Só se aplica a gráficos de linhas e de área.
HasHiLoLines	True se o gráfico de linhas tem linhas de máximo/mínimo. Só se aplica a gráficos de linhas.
HasRadarAxisLabels	True se um gráfico de radar tem rótulos de eixo. Só se aplica a gráficos de radar.
HasSeriesLines	True se um gráfico de colunas ou de barras empilhadas tiver linhas de série ou se um gráfico pizza de pizza ou gráfico barra de pizza tiver linhas de conexão entre as duas seções. Aplica-se somente a gráficos de colunas ou de barras empilhadas, gráficos pizza de pizza ou gráficos barra de pizza.
HasUpDownBars	True se um gráfico de linhas tiver barras superiores e inferiores. Aplica-se apenas a gráficos de linhas.
HiLoLines	Retorna um HiLoLines objeto que representa as linhas altas e baixas para uma série em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
Index	Retorna o número de índice do objeto dentro da coleção de objetos similares.
Overlap	Especifica como barras e colunas são posicionadas. Pode ser um valor entre –100 e 100. Se aplicam apenas às barras 2D e gráficos de colunas 2D.
Parent	Retorna o objeto pai do objeto especificado.
RadarAxisLabels	Retorna um TickLabels objeto que representa os rótulos do eixo de radar para o grupo de gráficos especificado.
SecondPlotSize	Retorna ou define o tamanho da seção secundária de um gráfico Pie of Pie ou um gráfico Bar of Pie, como uma porcentagem do tamanho da torta primária. Pode ser um valor de 5 de 200.
SeriesLines	Retorna um SeriesLines objeto que representa as linhas da série para um gráfico de barras empilhado ou um gráfico de colunas empilhado. Aplica-se somente aos gráficos de colunas e barras empilhadas.
ShowNegativeBubbles	True se bolhas negativas forem mostradas para o grupo gráfico. Válida somente para gráficos de bolhas.
SizeRepresents	Retorna ou define o que o tamanho da bolha representa em um gráfico de bolhas. Pode ser uma das seguintes constantes XlSizeRepresents : xlSizeIsArea ou xlSizeIsWidth.
SplitType	Retorna ou define a forma como as duas seções de um gráfico do Pie of Pie ou um gráfico Bar of Pie são divididas.
SplitValue	Retorna ou define o valor limite que separa as duas seções de um gráfico Pie of Pie ou um gráfico Bar of Pie.
SubType	Reservado para uso interno.
Type	Reservado para uso interno.
UpBars	Retorna um UpBars objeto que representa as barras para cima em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
VaryByCategories	True se o Microsoft Excel atribuir uma cor ou padrão diferente a cada marcador de dados. O gráfico deve conter apenas uma série.

Métodos

CategoryCollection(Object)	Retorna um objeto que representa uma coleção de todas as categorias visíveis (uma CategoryCollection coleção) no grupo de gráficos.
FullCategoryCollection(Object)	Retorna um objeto que representa uma coleção de todas as categorias visíveis e filtradas (a CategoryCollection) no grupo de gráficos.
SeriesCollection(Object)	Retorna um objeto que representa uma única série (um Series objeto) ou uma coleção de todas as séries (uma SeriesCollection coleção) no gráfico ou no grupo de gráficos.