BCGControlBar Pro for MFC
CBCGPBaseVisualObjectabstract

Detailed Description

The CBCGPBaseVisualObject implements basic behavior of a "visual object". A "visual object" is a kind of windowless control, which can be displayed on any window inside a specified rectangle (CBCGPBaseVisualObject::SetRect).

All Gauges and Charts are "visual objects" and have a number of common properties.

The following features are automatically enabled for any "visual object" (e.g. a class derived from CBCGPBaseVisualObject):

  • Ability to reside in container. A container manages a layout and Z-order of visual objects.
  • Export to image, file or clipboard.
  • "Dirty" flag - invalidation and redraw on demand.
  • Animation managed at the base level.
  • Edit mode. In "edit mode" a visual object can be moved or resized. Tracking rectangle is drawn automatically by the library.
  • Image cache. The content of visual object is stored as an image, which can be redrawn much faster than it would be done with the regular drawing logic.
+ Inheritance diagram for CBCGPBaseVisualObject:

Public Member Functions

 CBCGPBaseVisualObjectConstructor.
 
 CBCGPBaseVisualObjectCopy constructor.
 
 CopyToClipboardCopies visual object to the Clipboard.
 
 EnableImageCacheEnables or disables visual object image cache.
 
 ExportToBitmapExports the visual object to bitmap.
 
 ExportToFileExports the visual object to a file (BMP or PNG).
 
 ExportToImageExports the visual object to an image.
 
 GetDataGets an internal data object.
 
 GetDataAnimationTypeGets data animation type.
 
 GetDataCountReturns a number of data objects.
 
 GetEditFlagsGets editing flags.
 
 GetIDGets the object identifier.
 
 GetNameGets the object name.
 
 GetParentContainerGets the parent visual container.
 
 GetRectGets the object bounding rectangle.
 
 GetSelectedThemeObtain a currently selected visual theme.
 
 GetUserDataGets user-defined data associated with this object.
 
 GetValueGets the object value.
 
 IsAutoDestroyTells whether this object will be destroyed automatically.
 
 IsEditModeTells whether this object has the edit mode.
 
 IsEnabledTells whether the visual object is enabled.
 
 IsImageCacheTells whether image cache is enabled for this object.
 
 IsSelectedTells whether this object is selected in the parent container.
 
 IsVisibleTells whether the visual object is visible.
 
 OnDrawCalled by the framework to draw a visual object
 
 RedrawRedraws this object.
 
 RedrawRectRedraws a specified rectangle.
 
 SelectVisualThemeSelect a visual theme created in Visual Designer.
 
 SetAutoDestroySpecifies whether the object should be destroyed automatically.
 
 SetDataAnimationTypeSets data animation type.
 
 SetDirtyInvalidates and redraws a visual object.
 
 SetEditFlagsSets editing flags.
 
 SetIDSets the object identifier.
 
 SetNameSets an object name.
 
 SetRectSets a new bounding rectangle.
 
 SetSelectedSelects or unselects the object in the parent container.
 
 SetUserDataSets user-defined data associated with this object.
 
 SetValueSets the object value.
 
 SetVisibleShows or hides the visual object.