Introduction

Panels are not transparent. Therefore, their color can be changed to control their background display. A panel is a complete control with properties, methods, and events.

To add a panel to a container, you can click the Panel button from the Toolbox and click the desired location on the container. Unlike the form, during design, a panel must primarily be positioned on another container which would be a form or another panel.

To programmatically create a panel, declare a handle to Panel, allocate memory for it using the gcnew operator, and add it to its parent. Here is an example:

#include <windows.h>

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;

public ref class CExercise : public Form
{
private:
    Panel ^ pnlContainer;

public:
    CExercise()
    {
	InitializeComponent();
    }

    void InitializeComponent()
    {
        Text     = L"Domain Configuration";
        Width    = 320;
        Height   = 210;
        Location = System::Drawing::Point(140, 100);
        StartPosition = FormStartPosition::CenterScreen;

        pnlContainer = gcnew Panel;
        pnlContainer->Location = Point(20, 20);
	pnlContainer->Size = System::Drawing::Size(100, 60);
        Controls->Add(pnlContainer);
    }
};

int APIENTRY WinMain(HINSTANCE hInstance,
		     HINSTANCE hPrevInstance,
		     LPSTR lpCmdLine,
		     int nCmdShow)
{
    Application::Run(gcnew CExercise());

    return 0;
}

By default, a panel object is drawn without borders. If you want to add borders to it, use the BorderStyle property. It provides three values that you can set in the Properties window: None, FixedSingle, and Fixed3D and their effects are as follows:

	None	FixedSingle	Fixed3D
Design
Run

To programmatically specify the border style, assign the desired value to the Panel::BorderStyle property. Here is an example:

public ref class CExercise : public Form
{
private:
    Panel ^ pnlContainer;

public:
    CExercise()
    {
	InitializeComponent();
    }

    void InitializeComponent()
    {
        Text     = L"Domain Configuration";
        Width    = 320;
        Height   = 210;
        Location = System::Drawing::Point(140, 100);
        StartPosition = FormStartPosition::CenterScreen;

        pnlContainer = gcnew Panel;
        pnlContainer->Location = Point(20, 20);
        pnlContainer->Size = System::Drawing::Size(100, 60);
	pnlContainer->BorderStyle = BorderStyle::Fixed3D;
        Controls->Add(pnlContainer);
    }
};

A panel can be used as a button, in which case the user would click it to initiate an action.

A property that is highly used on panels (and forms) is the Color. If you change the BackColor property, the new color would cover the face of the panel.

A panel is one of the best control containers you can use. Besides aesthetic characteristics, the panel provides the ability to scroll, vertically and/or horizontally on its body. Scrolling makes it possible to give the user access to hidden parts that go beyond the (visible) client area of the panel. Here is an example:

To assist you with scroll bars, the Panel class is equipped with a property named AutoScroll. In reality, this property is inherited from the ScrollableControl class. If you want a ScrollableControl-based control to display the scroll bars, set this property to true. The steps to have the scroll bars on a panel are:

1. Add a panel to a form and specify the characteristics you want. You must also set the AutoScroll property to true
2. Add a picture box to the above panel (so that the panel is its parent). You should manually align it to the left of its container so that the top-left corner of the panel coincides with the top-left corner of the panel. Set this picture box's Dock property to None. Set its SizeMode to AutoSize.  If you (and most of the time you will) want to programmatically handle the picture box, give it a recognizable name that you can refer to in your code

One of the properties that influences the behavior of scroll bars is AutoScrollMargin. This property controls the area inside of which the scrolling can occur. This property is of type Size, which means it holds the width and the height of the scrollable area. Its default value is (0, 0), which means the whole client area of the parent will be used. If you to limit the area, change the value of this property.