Bitmap Custom Pane (Panel Edit)
The Bitmap control is actually capable of creating a selection of different backgrounds although it is largely used to place bitmaps.
specifies the type of graphic to create. There are 12 options:
File Bitmap: displays the bitmap set in Bitmap File below
Rectangle: draws an unfilled rectangle using the Fore Color (the skin may replace the rectangle with a bitmap)
Ellipse: draws an unfilled ellipse using the Fore Color
Fill Rectangle: draws a filled rectangle using a combination of Fore Color and Back Color mixed using Fill Pattern. Border Color sets the color of the border. Border Thickness sets the thickness of the bordering line. (the skin may replace the rectangle with a bitmap)
Fill Ellipse: draws a filled ellipse using a combination of Fore Color and Back Color mixed using Fill Pattern. Border Color sets the color of the border. Border Thickness sets the thickness of the bordering line.
Image: legacy, do not use
Rectangle !3d: same as Rectangle but the skin can't over-ride with a bitmap
Fill Rectangle !3d: same as Fill Rectangle but the skin can't over-ride with a bitmap
Bitmap: draw a bitmap stored in the bitmap list
Scaled Bitmap: the bitmap is scaled to fit the control
Round Rect: draw a rounded rectangle using Fore and Back Colors
Round Rect with File Bitmap: creates a rounded rectangle filled with the File Bitmap. The top bar is drawn using the Border Color and the top bar has a depth set by Val/Image Num
Round Rect with Color: draws a rounded rectangle where X Rounding and Y Rounding specify the rounding of the edges, Fore Color specifies the internal color, Border Thickness and Border Color specify the color and thickness of the outer border, and Val/Image Num sets the height of the header area of there is one
Horizontal Line: a horizontal line is drawn through the center of the control where the color of the line is specified by Fore Color and the thickness of the line is specified by Val/Image Num
Vertical Line: a vertical line is drawn through the center of the control where the color of the line is specified by Fore Color and the thickness of the line is specified by Val/Image Num
specifies the bitmap file to display in the control when Type is set to File Bitmap
specifies the main color to use
specifies the second color to use
specifies the drawing pattern used by the Fore and Back colors to make a pattern.
For bordered objects, this parameter specifies the width of the border in pixels
specifies the color of the border
When checked the background bitmap is specified to have a transparency color which allows elements of the background to pass through it
Transparent Color uses a standard Color Select Dialog to select and specify the color that is considered to be transparent in the background bitmap
When checked, bitmaps as many copies of the bitmap are draw as necessary to fill the control. When unchecked, a single copy of the bitmap is stretched to fill the control.
When Type is set to Bitmap, this parameter determines the number of the bitmap to display.
When Type is set to Round Rect with File Bitmap, this parameter sets the depth of the header bar drawn across the top
When Type is a vertical or horizontal line, this parameter sets the width of the line
Set the amount of horizontal rounding applied to the control
Set the amount of vertical rounding applied to the control
If a non-zero frame size is supplied with Type selection which displays a scaled bitmap, the bitmap is specially displayed. The bitmap is divided into 9 pieces as shown here using the specified outer frame size.
If, for example, the frame size were specified as "4" then the corners would be blitted into place as 4x4 squares. The vertical edges are stretched into the edge space with a fixed width of 4. The horizontal edges are stretched into edge space with a fixed height of 4. Finally, the center area is stretched into place using the available bitmap minus the 4 pixel border.
This allows background bitmaps to be created with a stylized border which can be effectively stretched into any specified frame size.