Version

Customizing Non-Client Area with WinToolbarsManager

Topic Overview

Purpose

This topic demonstrates customizing of the non-client area with WinToolbarsManager™ component.

Customizing Non-Client Area

Introduction

The non-client area of the form is the area that is not fully exposed for customization. The WinToolbarsManager component exposes the form’s non-client area (caption area) for customization.

Customizing non-client area of the form

The following elements and properties are customized in the screenshot illustrated below.

  • Caption “ Formatted Caption

  • Caption background appearance (Light-blue color)

  • Component Style (Office2013)

  • The FormDisplayStyle property

Note
Note:

The FormDisplayStyle property is only in effect when the component’s DockWithinContainer property is set to the Form and the component counterpart ( WinFormManager ) is not on the same form.

The result from the code example illustrated above.

Customizing Non Client Area with WinToolbarsManager 1.png

Code example for customizing the form’s caption area.

In C#:

// Set the formatted text for the caption area
ultraToolbarsManager1.Ribbon.Caption =
    "<span style='color:DrakGray; font-family:Calibri; font-size:20pt;'>Formatted Caption</span>";
// Set the caption's background color
ultraToolbarsManager1.Ribbon.CaptionAreaAppearance.BackColor = Color.LightSkyBlue;
// Set the display style for the form
ultraToolbarsManager1.FormDisplayStyle = FormDisplayStyle.RoundedFixed;
// Set a specific style for the form
ultraToolbarsManager1.Style = ToolbarStyle.Office2013;

In Visual Basic:

' Set the formatted text for the caption area
ultraToolbarsManager1.Ribbon.Caption = "<span style='color:DrakGray; font-family:Calibri; font-size:20pt;'>Formatted Caption</span>"
' Set the caption's background color
ultraToolbarsManager1.Ribbon.CaptionAreaAppearance.BackColor = Color.LightSkyBlue
' Set the display style for the form
ultraToolbarsManager1.FormDisplayStyle = FormDisplayStyle.RoundedFixed
' Set a specific style for the form
ultraToolbarsManager1.Style = ToolbarStyle.Office2013

WinToolbarsManager and WinFormManager

The WinToolbarsManager and WinFormManager components are mutually exclusive; meaning only one of the components can be docked within a form, the other component must be docked in the client area of the form.

Note
Note:

It is neither required nor desired to include both WinToolbarsManager and WinFormManager in the same form.

The following table lists some of the properties used in both components for customizing the same client area of the form.

WinToolbarsManager WinFormManager

ultraToolbarsManager1.Ribbon.Caption

ultraFormManager1.FormStyleSettings.Caption

ultraToolbarsManager1.Ribbon.CaptionAreaAppearance.BackColor

ultraFormManager1.FormStyleSettings.CaptionAreaAppearance.BackColor

ultraToolbarsManager1.FormDisplayStyle

ultraFormManager1.FormStyleSettings.FormDisplayStyle

ultraToolbarsManager1.Style

ultraFormManager1.FormStyleSettings.Style

Topics

The following topic provides additional information related to this topic.

Topic Purpose

This topic illustrates setting up a form with the WinFormManager component and customizing it to style the different areas of the form such as the caption area, the form borders, and the close, restore, maximize, minimize and context help buttons.