wxAutoExcel  2.0.0
wxAutoExcel::wxExcelPoint Class Reference

Represents Microsoft Excel Point object. More...

Inheritance diagram for wxAutoExcel::wxExcelPoint:
wxAutoExcel::wxExcelObject

Public Member Functions

void ApplyDataLabels (XlDataLabelsType *type=NULL, wxXlTribool legendKey=wxDefaultXlTribool, wxXlTribool autoText=wxDefaultXlTribool, wxXlTribool hasLeaderLines=wxDefaultXlTribool, wxXlTribool showSeriesName=wxDefaultXlTribool, wxXlTribool showCategoryName=wxDefaultXlTribool, wxXlTribool showValue=wxDefaultXlTribool, wxXlTribool showPercentage=wxDefaultXlTribool, wxXlTribool showBubbleSize=wxDefaultXlTribool, const wxString &separator=wxEmptyString)
 Applies data labels to a point. More...
 
bool ClearFormats ()
 Clears the formatting of the object. More...
 
bool Copy ()
 If the point has a picture fill, then this method copies the picture to the Clipboard. More...
 
bool Delete ()
 Deletes the series the point belongs to. More...
 
bool Paste ()
 Pastes a picture from the Clipboard as the marker on the selected point. More...
 
bool Select ()
 Selects the object. More...
 
bool GetApplyPictToEnd ()
 True if a picture is applied to the end of the point or all points in the series. More...
 
void SetApplyPictToEnd (bool applyPictToEnd)
 True if a picture is applied to the end of the point or all points in the series. More...
 
bool GetApplyPictToFront ()
 True if a picture is applied to the front of the point or all points in the series. More...
 
void SetApplyPictToFront (bool applyPictToFront)
 True if a picture is applied to the front of the point or all points in the series. More...
 
bool GetApplyPictToSides ()
 True if a picture is applied to the sides of the point or all points in the series. More...
 
void SetApplyPictToSides (bool applyPictToSides)
 True if a picture is applied to the sides of the point or all points in the series. More...
 
wxExcelDataLabel GetDataLabel ()
 Returns a DataLabel object that represents the data label associated with the point. More...
 
long GetExplosion ()
 Returns the explosion value for a pie-chart or doughnut-chart slice. More...
 
void SetExplosion (long explosion)
 Sets the explosion value for a pie-chart or doughnut-chart slice. More...
 
wxExcelChartFormat GetFormat ()
 Returns the ChartFormat object. More...
 
bool GetHas3DEffect ()
 True if a point has a three-dimensional appearance. More...
 
void SetHas3DEffect (bool has3DEffect)
 True if a point has a three-dimensional appearance. More...
 
bool GetHasDataLabel ()
 True if the point has a data label. More...
 
void SetHasDataLabel (bool hasDataLabel)
 True if the point has a data label. More...
 
bool GetInvertIfNegative ()
 True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number. More...
 
void SetInvertIfNegative (bool invertIfNegative)
 True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number. More...
 
bool GetIsTotal ()
 True if the point represents a total. More...
 
void SetIsTotal (bool isTotal)
 True if the point represents a total. More...
 
wxColour GetMarkerBackgroundColor ()
 Sets the marker background color as an RGB value or returns the corresponding color index value. More...
 
void SetMarkerBackgroundColor (const wxColour &markerBackgroundColor)
 Sets the marker background color as an RGB value or returns the corresponding color index value. More...
 
long GetMarkerBackgroundColorIndex ()
 Returns the marker background color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone. More...
 
void SetMarkerBackgroundColorIndex (long markerBackgroundColorIndex)
 Sets the marker background color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone. More...
 
wxColour GetMarkerForegroundColor ()
 Sets the marker background color as an RGB value or returns the corresponding color index value. More...
 
void SetMarkerForegroundColor (const wxColour &markerForegroundColor)
 Sets the marker background color as an RGB value or returns the corresponding color index value. More...
 
long GetMarkerForegroundColorIndex ()
 Returns the marker foreground color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone. More...
 
void SetMarkerForegroundColorIndex (long markerForegroundColorIndex)
 Sets the marker foreground color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone. More...
 
long GetMarkerSize ()
 Returns the data-marker size, in points. More...
 
void SetMarkerSize (long markerSize)
 Sets the data-marker size, in points. More...
 
XlMarkerStyle GetMarkerStyle ()
 Returns the marker style for a point or series in a line chart, scatter chart, or radar chart. More...
 
void SetMarkerStyle (XlMarkerStyle markerStyle)
 Sets the marker style for a point or series in a line chart, scatter chart, or radar chart. More...
 
XlChartPictureType GetPictureType ()
 Returns a XlChartPictureType value that represents the way pictures are displayed on a column or bar picture chart. More...
 
void SetPictureType (XlChartPictureType pictureType)
 Sets a XlChartPictureType value that represents the way pictures are displayed on a column or bar picture chart. More...
 
long GetPictureUnit ()
 Returns the unit for each picture on the chart if the PictureType property is set to xlStackScale (if not, this property is ignored). More...
 
void SetPictureUnit (long pictureUnit)
 Sets the unit for each picture on the chart if the PictureType property is set to xlStackScale (if not, this property is ignored). More...
 
double GetPictureUnit2 ()
 Read/write Since Excel 2007. More...
 
void SetPictureUnit2 (double pictureUnit2)
 Read/write Since Excel 2007. More...
 
bool GetSecondaryPlot ()
 True if the point is in the secondary section of either a pie of pie chart or a bar of pie chart. More...
 
void SetSecondaryPlot (bool secondaryPlot)
 True if the point is in the secondary section of either a pie of pie chart or a bar of pie chart. More...
 
bool GetShadow ()
 Returns a Boolean value that determines if the object has a shadow. More...
 
void SetShadow (bool shadow)
 Sets a Boolean value that determines if the object has a shadow. More...
 
virtual wxString GetAutoExcelObjectName_ () const
 Returns "Point". More...
 
- Public Member Functions inherited from wxAutoExcel::wxExcelObject
bool IsOk_ () const
 Returns true if the object has a valid dispatch. More...
 
wxString GetAutomationObjectName_ (bool stripUnderscores=false) const
 Returns object name as provided by IDispatch->GetTypeInfo()->GetDocumentation(MEMBERID_NIL, &name, NULL, NULL, NULL). More...
 
wxSharedPtr< wxAutomationObject > GetAutomationObject_ ()
 Returns the underlying wxAutomationObject. More...
 
 operator bool () const
 Returns true if the object has a valid dispatch and its last automation call (if any), i.e. More...
 
WXLCID GetAutomationLCID_ () const
 Returns the locale identifier used in automation calls. More...
 
bool SetAutomationLCID_ (WXLCID lcid)
 Sets the locale identifier to be used in automation calls. More...
 
bool GetPropertyAndMethodNames_ (wxArrayString &propertyNames, wxArrayString &methodNames, bool includeHidden=false)
 Returns lists of property and method names the automation interface exposes. More...
 
bool GetUnimplementedObject_ (const wxString &name, wxAutomationObject &object)
 Helper function for receiving an automation object not implemented in wxAutoExcel, see FAQ on how to use. More...
 

Additional Inherited Members

- Public Types inherited from wxAutoExcel::wxExcelObject
enum  ErrorFlags {
  Err_DoNothing = 0 , Err_LogOnInvalidDispatch = 1 , Err_AssertOnInvalidDispatch = 1 << 1 , Err_ThrowOnInvalidDispatch = 1 << 2 ,
  Err_LogOnInvalidArgument = 1 << 3 , Err_AssertOnInvalidArgument = 1 << 4 , Err_ThrowOnInvalidArgument = 1 << 5 , Err_LogOnFailedInvoke = 1 << 6 ,
  Err_AssertOnFailedInvoke = 1 << 7 , Err_ThrowOnFailedInvoke = 1 << 8 , Err_LogOnInvalidReturnType = 1 << 9 , Err_AssertOnInvalidReturnType = 1 << 10 ,
  Err_ThrowOnInvalidReturnType = 1 << 11 , Err_LogOnOtherError = 1 << 12 , Err_AssertOnOtherError = 1 << 13 , Err_ThrowOnOtherError = 1 << 14
}
 Flags affecting the behaviour of wxExcelObject and its descendants when an error occurs during accessing an Excel object property or calling its method. More...
 
- Static Public Member Functions inherited from wxAutoExcel::wxExcelObject
static unsigned GetErrorMode_ ()
 Sets the error mode to the combination of wxExcelObject::ErrorFlags. More...
 
static void SetErrorMode_ (unsigned mode)
 Sets the error mode as the combination of wxExcelObject::ErrorFlags. More...
 
static bool GetUnimplementedCollectionItem_ (wxAutomationObject &collection, const long index, wxAutomationObject &item, bool asProperty)
 Helper function for obtaining an item from MS Excel collection not implemented in wxAutoExcel, see FAQ on how to use. More...
 

Detailed Description

Represents Microsoft Excel Point object.

Member Function Documentation

◆ ApplyDataLabels()

void wxAutoExcel::wxExcelPoint::ApplyDataLabels ( XlDataLabelsType type = NULL,
wxXlTribool  legendKey = wxDefaultXlTribool,
wxXlTribool  autoText = wxDefaultXlTribool,
wxXlTribool  hasLeaderLines = wxDefaultXlTribool,
wxXlTribool  showSeriesName = wxDefaultXlTribool,
wxXlTribool  showCategoryName = wxDefaultXlTribool,
wxXlTribool  showValue = wxDefaultXlTribool,
wxXlTribool  showPercentage = wxDefaultXlTribool,
wxXlTribool  showBubbleSize = wxDefaultXlTribool,
const wxString &  separator = wxEmptyString 
)

Applies data labels to a point.

MSDN documentation for Point.ApplyDataLabels.

◆ ClearFormats()

bool wxAutoExcel::wxExcelPoint::ClearFormats ( )

Clears the formatting of the object.

MSDN documentation for Point.ClearFormats.

◆ Copy()

bool wxAutoExcel::wxExcelPoint::Copy ( )

If the point has a picture fill, then this method copies the picture to the Clipboard.

MSDN documentation for Point.Copy.

◆ Delete()

bool wxAutoExcel::wxExcelPoint::Delete ( )

Deletes the series the point belongs to.

MSDN documentation for Point.Delete.

◆ Paste()

bool wxAutoExcel::wxExcelPoint::Paste ( )

Pastes a picture from the Clipboard as the marker on the selected point.

MSDN documentation for Point.Paste.

◆ Select()

bool wxAutoExcel::wxExcelPoint::Select ( )

◆ GetApplyPictToEnd()

bool wxAutoExcel::wxExcelPoint::GetApplyPictToEnd ( )

True if a picture is applied to the end of the point or all points in the series.

MSDN documentation for Point.ApplyPictToEnd.

◆ SetApplyPictToEnd()

void wxAutoExcel::wxExcelPoint::SetApplyPictToEnd ( bool  applyPictToEnd)

True if a picture is applied to the end of the point or all points in the series.

MSDN documentation for Point.ApplyPictToEnd.

◆ GetApplyPictToFront()

bool wxAutoExcel::wxExcelPoint::GetApplyPictToFront ( )

True if a picture is applied to the front of the point or all points in the series.

MSDN documentation for Point.ApplyPictToFront.

◆ SetApplyPictToFront()

void wxAutoExcel::wxExcelPoint::SetApplyPictToFront ( bool  applyPictToFront)

True if a picture is applied to the front of the point or all points in the series.

MSDN documentation for Point.ApplyPictToFront.

◆ GetApplyPictToSides()

bool wxAutoExcel::wxExcelPoint::GetApplyPictToSides ( )

True if a picture is applied to the sides of the point or all points in the series.

MSDN documentation for Point.ApplyPictToSides.

◆ SetApplyPictToSides()

void wxAutoExcel::wxExcelPoint::SetApplyPictToSides ( bool  applyPictToSides)

True if a picture is applied to the sides of the point or all points in the series.

MSDN documentation for Point.ApplyPictToSides.

◆ GetDataLabel()

wxExcelDataLabel wxAutoExcel::wxExcelPoint::GetDataLabel ( )

Returns a DataLabel object that represents the data label associated with the point.

MSDN documentation for Point.DataLabel.

◆ GetExplosion()

long wxAutoExcel::wxExcelPoint::GetExplosion ( )

Returns the explosion value for a pie-chart or doughnut-chart slice.

Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie).

MSDN documentation for Point.Explosion.

◆ SetExplosion()

void wxAutoExcel::wxExcelPoint::SetExplosion ( long  explosion)

Sets the explosion value for a pie-chart or doughnut-chart slice.

Returns 0 (zero) if there's no explosion (the tip of the slice is in the center of the pie).

MSDN documentation for Point.Explosion.

◆ GetFormat()

wxExcelChartFormat wxAutoExcel::wxExcelPoint::GetFormat ( )

Returns the ChartFormat object.

Since Excel 2007.

MSDN documentation for Point.Format.

◆ GetHas3DEffect()

bool wxAutoExcel::wxExcelPoint::GetHas3DEffect ( )

True if a point has a three-dimensional appearance.

Since Excel 2007.

MSDN documentation for Point.Has3DEffect.

◆ SetHas3DEffect()

void wxAutoExcel::wxExcelPoint::SetHas3DEffect ( bool  has3DEffect)

True if a point has a three-dimensional appearance.

Since Excel 2007.

MSDN documentation for Point.Has3DEffect.

◆ GetHasDataLabel()

bool wxAutoExcel::wxExcelPoint::GetHasDataLabel ( )

True if the point has a data label.

MSDN documentation for Point.HasDataLabel.

◆ SetHasDataLabel()

void wxAutoExcel::wxExcelPoint::SetHasDataLabel ( bool  hasDataLabel)

True if the point has a data label.

MSDN documentation for Point.HasDataLabel.

◆ GetInvertIfNegative()

bool wxAutoExcel::wxExcelPoint::GetInvertIfNegative ( )

True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number.

MSDN documentation for Point.InvertIfNegative.

◆ SetInvertIfNegative()

void wxAutoExcel::wxExcelPoint::SetInvertIfNegative ( bool  invertIfNegative)

True if Microsoft Excel inverts the pattern in the item when it corresponds to a negative number.

MSDN documentation for Point.InvertIfNegative.

◆ GetIsTotal()

bool wxAutoExcel::wxExcelPoint::GetIsTotal ( )

True if the point represents a total.

Since Excel 2016.

MSDN documentation for Point.IsTotal.

◆ SetIsTotal()

void wxAutoExcel::wxExcelPoint::SetIsTotal ( bool  isTotal)

True if the point represents a total.

Since Excel 2016.

MSDN documentation for Point.IsTotal.

◆ GetMarkerBackgroundColor()

wxColour wxAutoExcel::wxExcelPoint::GetMarkerBackgroundColor ( )

Sets the marker background color as an RGB value or returns the corresponding color index value.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerBackgroundColor.

◆ SetMarkerBackgroundColor()

void wxAutoExcel::wxExcelPoint::SetMarkerBackgroundColor ( const wxColour &  markerBackgroundColor)

Sets the marker background color as an RGB value or returns the corresponding color index value.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerBackgroundColor.

◆ GetMarkerBackgroundColorIndex()

long wxAutoExcel::wxExcelPoint::GetMarkerBackgroundColorIndex ( )

Returns the marker background color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerBackgroundColorIndex.

◆ SetMarkerBackgroundColorIndex()

void wxAutoExcel::wxExcelPoint::SetMarkerBackgroundColorIndex ( long  markerBackgroundColorIndex)

Sets the marker background color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerBackgroundColorIndex.

◆ GetMarkerForegroundColor()

wxColour wxAutoExcel::wxExcelPoint::GetMarkerForegroundColor ( )

Sets the marker background color as an RGB value or returns the corresponding color index value.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerForegroundColor.

◆ SetMarkerForegroundColor()

void wxAutoExcel::wxExcelPoint::SetMarkerForegroundColor ( const wxColour &  markerForegroundColor)

Sets the marker background color as an RGB value or returns the corresponding color index value.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerForegroundColor.

◆ GetMarkerForegroundColorIndex()

long wxAutoExcel::wxExcelPoint::GetMarkerForegroundColorIndex ( )

Returns the marker foreground color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerForegroundColorIndex.

◆ SetMarkerForegroundColorIndex()

void wxAutoExcel::wxExcelPoint::SetMarkerForegroundColorIndex ( long  markerForegroundColorIndex)

Sets the marker foreground color as an index into the current color palette, or as one of the following XlColorIndex constants: xlColorIndexAutomatic or xlColorIndexNone.

Applies only to line, scatter, and radar charts.

MSDN documentation for Point.MarkerForegroundColorIndex.

◆ GetMarkerSize()

long wxAutoExcel::wxExcelPoint::GetMarkerSize ( )

Returns the data-marker size, in points.

Can be a value from 2 through 72.

MSDN documentation for Point.MarkerSize.

◆ SetMarkerSize()

void wxAutoExcel::wxExcelPoint::SetMarkerSize ( long  markerSize)

Sets the data-marker size, in points.

Can be a value from 2 through 72.

MSDN documentation for Point.MarkerSize.

◆ GetMarkerStyle()

XlMarkerStyle wxAutoExcel::wxExcelPoint::GetMarkerStyle ( )

Returns the marker style for a point or series in a line chart, scatter chart, or radar chart.

Read/write XlMarkerStyle.

MSDN documentation for Point.MarkerStyle.

◆ SetMarkerStyle()

void wxAutoExcel::wxExcelPoint::SetMarkerStyle ( XlMarkerStyle  markerStyle)

Sets the marker style for a point or series in a line chart, scatter chart, or radar chart.

Read/write XlMarkerStyle.

MSDN documentation for Point.MarkerStyle.

◆ GetPictureType()

XlChartPictureType wxAutoExcel::wxExcelPoint::GetPictureType ( )

Returns a XlChartPictureType value that represents the way pictures are displayed on a column or bar picture chart.

MSDN documentation for Point.PictureType.

◆ SetPictureType()

void wxAutoExcel::wxExcelPoint::SetPictureType ( XlChartPictureType  pictureType)

Sets a XlChartPictureType value that represents the way pictures are displayed on a column or bar picture chart.

MSDN documentation for Point.PictureType.

◆ GetPictureUnit()

long wxAutoExcel::wxExcelPoint::GetPictureUnit ( )

Returns the unit for each picture on the chart if the PictureType property is set to xlStackScale (if not, this property is ignored).

[MSDN documentation for Point.PictureUnit]().

◆ SetPictureUnit()

void wxAutoExcel::wxExcelPoint::SetPictureUnit ( long  pictureUnit)

Sets the unit for each picture on the chart if the PictureType property is set to xlStackScale (if not, this property is ignored).

[MSDN documentation for Point.PictureUnit]().

◆ GetPictureUnit2()

double wxAutoExcel::wxExcelPoint::GetPictureUnit2 ( )

Read/write Since Excel 2007.

MSDN documentation for Point.PictureUnit2.

◆ SetPictureUnit2()

void wxAutoExcel::wxExcelPoint::SetPictureUnit2 ( double  pictureUnit2)

Read/write Since Excel 2007.

MSDN documentation for Point.PictureUnit2.

◆ GetSecondaryPlot()

bool wxAutoExcel::wxExcelPoint::GetSecondaryPlot ( )

True if the point is in the secondary section of either a pie of pie chart or a bar of pie chart.

Applies only to points on pie of pie charts or bar of pie charts.

MSDN documentation for Point.SecondaryPlot.

◆ SetSecondaryPlot()

void wxAutoExcel::wxExcelPoint::SetSecondaryPlot ( bool  secondaryPlot)

True if the point is in the secondary section of either a pie of pie chart or a bar of pie chart.

Applies only to points on pie of pie charts or bar of pie charts.

MSDN documentation for Point.SecondaryPlot.

◆ GetShadow()

bool wxAutoExcel::wxExcelPoint::GetShadow ( )

Returns a Boolean value that determines if the object has a shadow.

MSDN documentation for Point.Shadow.

◆ SetShadow()

void wxAutoExcel::wxExcelPoint::SetShadow ( bool  shadow)

Sets a Boolean value that determines if the object has a shadow.

MSDN documentation for Point.Shadow.

◆ GetAutoExcelObjectName_()

virtual wxString wxAutoExcel::wxExcelPoint::GetAutoExcelObjectName_ ( ) const
inlinevirtual

Returns "Point".

Reimplemented from wxAutoExcel::wxExcelObject.