Class: GDIEllipse in Category Microsoft Visual Basic 6 : Graphics from Total Visual SourceBook

Class that draws an ellipse, using Windows API GDI calls in VB6.

An ellipse is a circle or oval region whose center is located in the middle of an imaginary bounding rectangle. The routines in this class allow you to draw the ellipse by calling the Windows API Ellipse function.

Procedure Name Type Description
(Declarations) Declarations Declarations and private variables for the CGDIEllipse class.
BorderColor Property Get the current value of the color used to draw the ellipse.
BorderWidth Property Get the current value of the BorderWidth used to draw the ellipse.
Bottom Property Get the Bottom location of the bounding rectangle for the ellipse.
BrushStyle Property Get the current style used to fill the ellipse.
FillColor Property Get the current value of the color used to fill the ellipse.
ForegroundMixMode Property Get the current value of the ForegroundMixMode property, which defines how colors from the pen and the colors in the existing image are to be combined. The value should be one of the enumerated raster op values exposed in EnumEllipseRasterOps, or the equivalent VBA/VB6 "DrawModeConstants", such as vbCopyPen, vbXorPen etc. See "Drawing Constants" in the VBA/VB6 on-line help.
HatchStyle Property Get the current value of the style used to fill the ellipse when the BrushStyle is set to hatched. The value of this property should be set to one of the Windows API Hatch Style constants (HS_HORIZONTAL, HS_BDIAGONAL, HS_CROSS etc.) which are exposed as EnumEllipseHatchStyles constants in this class.
Left Property Get the Left location of the bounding rectangle for the ellipse.
PenStyle Property Get the value of the style used to draw the ellipse. The value of this property should be set to one of the Windows API Pen Style constants (PS_SOLID, PS_DASHDOT etc.) which are exposed as EnumEllipsePenStyles constants in this class.
Right Property Get the Right location of the bounding rectangle for the ellipse.
Top Property Get the Top location of the bounding rectangle for the ellipse.
Class_Initialize Initialize Set initial values to defaults which may be overridden with property settings.
Draw3DEllipse Method Draws two Ellipses on a selected device so that they create a 3D effect. This method ignores the regular BorderColor and FillStyle properties, and instead uses the colors which are passed to it to draw a 3D ellipse.
DrawEllipse Method Draw an Ellipse on a selected device. The ellipse is bounded by the dimensions of a rectangle specified in the Left, Top, Bottom and Right properties.
TranslateVBColor Private Translates VBA/VB6 color constants for system colors into GDI equivalents. VBA/VB6 color constants, such as vbRed, vbBlue, or values returned using the QBColor() or RGB() functions, can be used directly for the color values used with Windows API calls. However, the VBA/VB6 color constants for system colors (vbButtonFace, vb3DShadow etc.) do not map correctly to those expected by Windows. This function accepts either form of constant and translates the value, if necessary, into the equivalent value expected by the Windows GDI subsystem.
' Example of the CGDIEllipse class
'
' To try this example, do the following:
' 1. Create a new form
' 2. Paste all the code from this example to the new form's module
' 3. Run the form and click on the background. The ellipses are drawn
'    based on the location of the click

Private Sub Form_MouseUp(Button As Integer, Shift As Integer, x As Single, Y As Single)

  Dim GDIEllipse As CGDIEllipse
  Set GDIEllipse = New CGDIEllipse

  With GDIEllipse

    ' Draw a hatched green circle
    .Left = ScaleX(X, vbTwips, vbPixels) - 100
    .Top = ScaleY(Y, vbTwips, vbPixels) - 100
    .Right = ScaleX(X, vbTwips, vbPixels)
    .Bottom = ScaleY(Y, vbTwips, vbPixels)

    .BorderColor = vbYellow
    .BorderWidth = 1
    .FillColor = vbGreen
    .BrushStyle = ebsBS_HATCHED
    .HatchStyle = ehsHS_DIAGCROSS
    .ForegroundMixMode = eroR2_COPYPEN
    .PenStyle = epsPS_DASH

    ' Draw the ellipse. See also Draw3DEllipse
    .DrawEllipse Me.hDC

    ' Draw a 3D Oval
    .Left = ScaleX(X, vbTwips, vbPixels)
    .Top = ScaleY(Y, vbTwips, vbPixels)
    .Right = ScaleX(X, vbTwips, vbPixels) + 100
    .Bottom = ScaleY(Y, vbTwips, vbPixels) + 75

    .PenStyle = epsPS_SOLID
    .Draw3DEllipse Me.hDC, vb3DShadow, vb3DHighlight

  End With

End Sub

Total Visual SourceBook The source code in Total Visual Sourcebook includes modules and classes for Microsoft Access, Visual Basic 6 (VB6), and Visual Basic for Applications (VBA) developers. Easily add this professionally written, tested, and documented royalty-free code into your applications to simplify your application development efforts.

Total Visual SourceBook is written for the needs of a developer using a source code library covering the many challenges you face. Countless developers over the years have told us they learned some or much of their development skills and tricks from our code. You can too!

Additional Resources

Total Visual SourceBook CD and Printed Manual

Microsoft Access/ Office 2016, 2013, 2010, and 2007 Version
is Shipping!

New features in Total Visual SourceBook for Access, Office and VB6

Supports Access/Office 2016, 2013, 2010 and 2007, and Visual Basic 6.0!


View all FMS products for Microsoft Access All Our Microsoft Access Products

Reviews

Reader Choice Award for MS Access Source Code Library
Reader Choice

"The code is exactly how I would like to write code and the algorithms used are very efficient and well-documented."

Van T. Dinh, Microsoft MVP

SourceBook Info

Additional Info

Question

 

 

Free Product Catalog from FMS