A rounded rectangle is a region whose location is determined by the Left, Top, Right and Bottom properties of this class. The angles of the corners of the rectangle are always drawn at 90 degrees. The corners of the rectangle are rounded off based on the value of the Height and Width properties. The routines in this class allow you to draw the rounded rectangle by calling the Windows API RoundRect function.
Procedure Name | Type | Description |
(Declarations) | Declarations | Declarations and private variables for the CGDIRoundRect class. |
BorderColor | Property | Get the current value of the color used to draw the rounded rectangle. |
BorderWidth | Property | Get the current value of the BorderWidth used to draw the rounded rectangle. |
Bottom | Property | Get the Bottom location of the rounded rectangle. |
BrushStyle | Property | Get the current style used to fill the rounded rectangle. The value of this property should be set to one of the Windows API Brush Style constants (BS_SOLID, BS_HOLLOW, BS_HATCHED etc.), which are exposed as EnumRoundRectBrushStyles constants in this class. |
FillColor | Property | Get the current value of the color used to fill the rounded rectangle. |
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 EnumRoundRectRasterOps, 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 rounded rectangle 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 EnumRoundRectHatchStyles constants in this class. |
Height | Property | Get the height of the ellipse used to draw rounded corners of the rectangle. This value controls how "rounded" the rounded corners of the rectangle will be (i.e. where the ellipse used to draw the corner is located). |
Left | Property | Get the Left location of the rounded rectangle. |
PenStyle | Property | Get the value of the style used to draw the rounded rectangle. 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 EnumRoundRectPenStyles constants in this class. |
Right | Property | Get the Right location of the rounded rectangle. |
Top | Property | Get the Top location of the rounded rectangle. |
Width | Property | Get the width of the ellipse used to draw rounded corners of the rectangle. This value controls how "rounded" the rounded corners of the rectangle will be (i.e. where the ellipse used to draw the corner is located). |
Class_Initialize | Initialize | Set initial values to defaults which may be overridden with property settings. |
Draw3DRoundRect | Method | Draws two rounded rectangles 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 rounded rectangle. |
DrawRoundRect | Method | Draw a rounded rectangle on a selected device. |
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 CGDIRoundRect 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. A rounded rectangle is ' drawn on the form around the location of the click. A 3D rounded ' rectangle is drawn around the borders of the form Private Sub Form_MouseUp(Button As Integer, Shift As Integer, x As Single, Y As Single) Dim GDIRoundRect As CGDIRoundRect Set GDIRoundRect = New CGDIRoundRect With GDIRoundRect .Left = ScaleX(X, vbTwips, vbPixels) - 100 .Top = ScaleY(Y, vbTwips, vbPixels) - 50 .Right = ScaleX(X, vbTwips, vbPixels) + 100 .Bottom = ScaleY(Y, vbTwips, vbPixels) + 50 .Width = 50 .Height = 50 .BorderColor = vbBlue .BorderWidth = 5 .FillColor = vbYellow ' Draw the rounded rectangle .DrawRoundRect Me.hDC ' Draw the 3D rounded rectangle .Left = 10 .Top = 10 .Right = ScaleX(Me.ScaleWidth, vbTwips, vbPixels) - 10 .Bottom = ScaleY(Me.ScaleHeight, vbTwips, vbPixels) - 10 .Width = 50 .Height = 50 .BorderWidth = 1 .Draw3DRoundRect Me.hDC, vb3DShadow, vb3DHighlight End With End Sub
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!
Supports Access/Office 2016, 2013, 2010 and 2007, and Visual Basic 6.0!
"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