CaptionHeight Property

CaptionHeight Property

Applies to: Subclasser object, PowerForm control
See also: CaptionButtonSize property, BorderThickness property, Property Index

Returns the height (in pixels) of the window's caption.

Read Only at run-time, not available at design-time.

Type:

Long

Remarks:

The height of a window's caption bar is dependant on user settings which can be updated via the Display Control Panel. Use this property to maintain a consistent look and feel which responds to user preferences.

The CaptionHeight property is not required when sizing or positioning controls. Instead, use the ScaleWidth and ScaleHeight properties of the form.

Example:

The following snippet assumes that there is a PictureBox control called PictureBox1, and a PowerForm control called PowerForm1. When executed, this line of code will resize the form so that the PictureBox fills the form, irrespective of the form's BorderStyle or ScaleMode properties.

Move Left, Top, ScaleX(Picture1.Width, ScaleMode, vbTwips) _
        + ScaleX(PowerForm1.BorderThickness * 2, vbPixels, vbTwips), _
    ScaleY(Picture1.Height, ScaleMode, vbTwips) _
        + ScaleY(PowerForm1.BorderThickness * 2 _
            + PowerForm1.CaptionHeight, vbPixels, vbTwips)

Home	Copyright and Disclaimer