 |
| IXlsChart |
 |
COM interface ( getting help with interfaces )
interface IXlsChart : IDispatch
{
[id(1),propget] HRESULT DataSource([out, retval]IXlsChartDataSource** datasource);
[id(2),propget] HRESULT Legend([out, retval]IXlsChartLegend** legend);
[id(3),propget] HRESULT MainTitle([out, retval]IXlsChartTitle**);
[id(4),propget] HRESULT PlotArea([out, retval]IXlsChartPlotArea** plotarea);
[id(5),propget] HRESULT SurfaceArea([out, retval]IXlsChartSurfaceArea** surfacearea);
[id(6),propget] HRESULT SeriesByIndex([in]int i, [out, retval]IXlsChartSeries** series);
[id(7),propget] HRESULT SeriesByName([in]BSTR seriesname, [out, retval]IXlsChartSeries** series);
[id(8),propget] HRESULT XAxis([in]enumChartAxisType axistype, [out, retval]IXlsChartAxis** axis);
[id(9),propget] HRESULT YAxis([in]enumChartAxisType axistype, [out, retval]IXlsChartAxis** axis);
[id(10),propget] HRESULT ZAxis([out, retval]IXlsChartAxis** axis);
[id(11),propget] HRESULT ThreeDeePanel([out, retval]IXlsChart3DPanel** threedeepanel);
[id(12),propget] HRESULT MainDataLabels([out, retval]IXlsChartDataLabels** datalabels);
[id(13),propget] HRESULT CustomProperties([out, retval]IXlsChartCustomProperties** customproperties);
[id(14),propget] HRESULT DataTableLegend([out, retval]IXlsChartDataTable** datatable);
[id(15),propget] HRESULT PageSetup([out, retval] IXlsPageSetup** pagesetup);
[id(16),propget] HRESULT DynamicDataSource([out, retval]IXlsChartDynamicDataSource** dynamicdatasource);
[id(17) ] HRESULT AddTextBox([out, retval]IXlsChartTextBox** textbox);
[id(18),propget] HRESULT Type([out, retval]enumChartType* type);
[id(18),propput] HRESULT Type([in]enumChartType type);
[id(19),propget] HRESULT Embedded([out, retval]BOOL* embedded);
[id(20),propget] HRESULT ChartPositionTop([out, retval]int* row);
[id(21),propget] HRESULT ChartPositionLeft([out, retval]int* column);
[id(22),propget] HRESULT ChartPositionBottom([out, retval]int* row);
[id(23),propget] HRESULT ChartPositionRight([out, retval]int* column);
[id(24),propget] HRESULT Shapes([out, retval]IXlsChartShapes** shapes);
[id(25) ] HRESULT ExtractToFile([out, retval]BSTR* filename);
[id(26) ] HRESULT ExtractToMemory([in]IUnknown* lockbytes);
[id(27) ] HRESULT CommitChanges();
[id(28),propget] HRESULT AlternativeText([out, retval]BSTR* text);
[id(28),propput] HRESULT AlternativeText([in]BSTR text);
[id(29) ] HRESULT TurnToStandalone([in]BSTR chartname, [out, retval]IXlsChart** chart);
[id(30) ] HRESULT TurnToEmbedded([in]IXlsWorksheet* wksht, [in]int row1, [in]int col1, [in]int row2, [in]int col2, [out, retval] IXlsChart** chart);
[id(31) ] HRESULT CopyTo([in]IXlsWorksheet* wksht, [out, retval] IXlsChart** chart);
[id(32) ] HRESULT CopyToLocation([in]IXlsWorksheet* wksht, [in]int row1, [in]int col1, [in]int row2, [in]int col2, [out, retval] IXlsChart** chart);
[id(33),propget] HRESULT WorksheetHost([out, retval]IXlsWorksheet** wksht);
[id(34) ] HRESULT Delete();
[id(35) ] HRESULT AddVectorShape([in]enumVectorShape shapeType, [out, retval]IXlsVectorShape** shape);
[id(36) ] HRESULT SwitchRowsAndColumns();
[id(37),propget] HRESULT Theme([out, retval]IXlsChartTheme** theme);
[id(38),propput] HRESULT VBAMacro([in]BSTR macro);
[id(38),propget] HRESULT VBAMacro([out, retval]BSTR* macro);
[id(39),propput] HRESULT PivotTableDataSource([in]IXlsPivotTable* pivot);
[id(40),propget] HRESULT Name([out, retval] BSTR* name);
[id(40),propput] HRESULT Name([in] BSTR name);
}
HRESULT DataSource([out, retval]IXlsChartDataSource** datasource);
returns the chart data source object. The (static) data source is an alternative to the dynamic data source.
HRESULT Legend([out, retval]IXlsChartLegend** legend);
returns the chart legend object.
HRESULT MainTitle([out, retval]IXlsChartTitle**);
returns the chart title object.
HRESULT PlotArea([out, retval]IXlsChartPlotArea** plotarea);
returns the chart plot area object.
HRESULT SurfaceArea([out, retval]IXlsChartSurfaceArea** surfacearea);
returns the chart surfacearea object.
HRESULT SeriesByIndex([in]int i, [out, retval]IXlsChartSeries** series);
returns a series by index. Index starts at 1.
HRESULT SeriesByName([in]BSTR seriesname, [out, retval]IXlsChartSeries** series);
returns a series by name. Names are case insensitive. Not available if you are using a dynamic data source (IXlsDynamicDataSource).
HRESULT XAxis([in]enumChartAxisType axistype, [out, retval]IXlsChartAxis** axis);
returns the (X) axis, used to display data labels.
HRESULT YAxis([in]enumChartAxisType axistype, [out, retval]IXlsChartAxis** axis);
returns the (Y) axis, used to display serie values.
HRESULT ZAxis([out, retval]IXlsChartAxis** axis);
returns the (Z) axis, used to display serie values in 3D charts.
HRESULT ThreeDeePanel([out, retval]IXlsChart3DPanel** threedeepanel);
returns the 3D panel object.
HRESULT MainDataLabels([out, retval]IXlsChartDataLabels** datalabels);
returns the data labels object.
HRESULT CustomProperties([out, retval]IXlsChartCustomProperties** customproperties);
returns the custom properties object.
HRESULT DataTableLegend([out, retval]IXlsChartDataTable** datatable);
returns the associated data table object. Does not apply to 3D charts and pie/doughnut/radar/surface/contour/bubble charts.
HRESULT PageSetup([out, retval] IXlsPageSetup** pagesetup);
retrieves the page setup information for this chart.
HRESULT DynamicDataSource([out, retval]IXlsChartDynamicDataSource** dynamicdatasource);
returns the chart dynamic data source object. The dynamic data source is an alternative to the regular (static) data source.
HRESULT AddTextBox([out, retval]IXlsChartTextBox** textbox);
adds a custom text box to the chart.
HRESULT Type([out, retval]enumChartType* type);
returns the chart type.
HRESULT Type([in]enumChartType type);
sets the chart type.
HRESULT Embedded([out, retval]BOOL* embedded);
returns whether the chart is part of the worksheet (i.e. embedded) or fills the entire surface of a worksheet.
HRESULT ChartPositionTop([out, retval]int* row);
returns the chart top row where it's located in the worksheet. Only applies to embedded charts.
HRESULT ChartPositionLeft([out, retval]int* column);
returns the chart left column where it's located in the worksheet. Only applies to embedded charts.
HRESULT ChartPositionBottom([out, retval]int* row);
returns the chart bottom row where it's located in the worksheet. Only applies to embedded charts.
HRESULT ChartPositionRight([out, retval]int* column);
returns the chart right column where it's located in the worksheet. Only applies to embedded charts.
HRESULT Shapes([out, retval]IXlsChartShapes** shapes);
gets the shapes collection in the chart.
HRESULT ExtractToFile([out, retval]BSTR* filename);
creates a snapshot of the chart as a picture in a file (PNG file format) and returns the filename.
HRESULT ExtractToMemory([in]IUnknown* lockbytes);
creates a snapshot of the chart as a picture in memory. The passed parameter is a pointer to a ILockBytes interface pointer. PNG buffer.
HRESULT CommitChanges();
ensures that changes made to the chart are saved back into the file.
HRESULT AlternativeText([out, retval]BSTR* text);
returns the alternative text. Optional.
HRESULT AlternativeText([in]BSTR text);
sets the alternative text. Optional.
HRESULT TurnToStandalone([in]BSTR chartname, [out, retval]IXlsChart** chart);
turns the chart to a standalone chart (chart sheet). The passed parameter is the name of the sheet holding the chart.
HRESULT TurnToEmbedded([in]IXlsWorksheet* wksht, [in]int row1, [in]int col1, [in]int row2, [in]int col2, [out, retval] IXlsChart** chart);
turns the chart to an embedded chart.
HRESULT CopyTo([in]IXlsWorksheet* wksht, [out, retval] IXlsChart** chart);
copies the chart to the passed worksheet.
HRESULT CopyToLocation([in]IXlsWorksheet* wksht, [in]int row1, [in]int col1, [in]int row2, [in]int col2, [out, retval] IXlsChart** chart);
copies the chart to the passed worksheet at the given location.
HRESULT WorksheetHost([out, retval]IXlsWorksheet** wksht);
returns the worksheet associated to the chart.
HRESULT Delete();
deletes the chart.
HRESULT AddVectorShape([in]enumVectorShape shapeType, [out, retval]IXlsVectorShape** shape);
adds a custom vector shape to the chart.
HRESULT SwitchRowsAndColumns();
switches rows and columns of the data source. Rows become columns and vice versa.
HRESULT Theme([out, retval]IXlsChartTheme** theme);
returns the chart theme object.
HRESULT VBAMacro([in]BSTR macro);
sets the vba macro name for the chart.
HRESULT VBAMacro([out, retval]BSTR* macro);
returns the vba macro name for the chart.
HRESULT PivotTableDataSource([in]IXlsPivotTable* pivot);
sets the chart dynamic data source object from an existing pivot table.
HRESULT Name([out, retval] BSTR* name);
retrieves the name of the chart.
HRESULT Name([in] BSTR name);
sets the name of the chart.