Images from our predefined frame VistaRoyal

 

The custom image should have identical structure. Two images should be provided - one for an active frame and one for inactive.

Margins are very important for the frame to be rendered properly. For the above example the margins are defined as:

 

• Left - 47
• Right - 47
• Top - 28 (this should be the height of the caption)
• Bottom - 5

 

The client area of the Form is excluded from the non-client painting so it doesn't matter what filling will have the inner frame space. For more information see Segmented Image. 

Our framework will automatically exclude any transparent pixels found in the provided image from the visible region of the Form. Currently only pixels around the four corners of the image are processed and excluded if needed.

To completely define the frame you will have to specify the non-client metrics.

For the above example these are defined as follows:

 

• CaptionHeight - 28
• TopBorder - 4. Note that the top border is not added to the caption height. It is used to properly respond to WM_NCHITTEST message.
• LeftBorder - 4
• RightBorder - 4
• BottomBorder - 4 

The NFrameAppearance object provides five image sets to be used for the predefined buttons:

 

• CloseButtonImageSet - provides set of images to be used by the "Close" button.
• MaximizeButtonImageSet - provides set of images to be used by the "Maximize" button.
• RestoreButtonImageSet - provides set of images to be used by the "Restore" button.
• MinimizeButtonImageSet - provides set of images to be used by the "Minimize" button.
• HelpButtonImageSet - provides set of images to be used by the "Help" button.

 

Optionally you may add custom buttons, specify their images and capture their clicks.