ControlBar Class

Represents a floating, translucent window for owner form. User can add any controls to the window.

Inheritance

object

ControlBar

Implements

IDisposable

Namespace: C1.Win.TouchToolKit

Assembly: C1.Win.TouchToolKit.4.8.dll

Syntax

public class ControlBar : IDisposable

Public Class ControlBar
    Implements IDisposable

Examples

The following code example shows how to use the ControlBar class.

public class ControlBarDemo : Form
{
	private Button _controlBarButton;
	private MyUserControl _userControl = new MyUserControl();
	private GcZoom _gcZoom1 = new GcZoom();

	public ControlBarDemo()
	{
		InitializeComponent();

		_gcZoom1.Target = this;

		// Create ControlBar
		AddControlBar();
	}

	private void AddControlBar()
	{
		ControlBar controlBar = new ControlBar();

		// Content should is a Type of UserControl.
		controlBar.Content = _userControl.GetType();

		controlBar.PositionMode = PositionMode.Floating;

		// Only take effect when Position Mode is Dock.
		// controlBar.DockPosition = ContentAlignment.MiddleCenter;
		// controlBar.Margin = new System.Windows.Forms.Padding();

		// Only take effect when PositionMode is Fix or Flowing.
		controlBar.Position = new Point(20, 20);

		controlBar.Opacity = 1d;
		controlBar.TransparentBackground = true;

		_gcZoom1.ControlBars.Add(controlBar);
	}

	private void InitializeComponent()
	{
		_controlBarButton = new Button();
		_controlBarButton.Text = "This is a Button";
		_controlBarButton.Location = new Point(100, 100);
		_controlBarButton.Size = new Size(120, 30);
		this.Controls.Add(_controlBarButton);
	}
}

public class MyUserControl : UserControl
{
	private GcZoomCommandProvider commands = new GcZoomCommandProvider();
	private Button _zoomInButton;
	private Button _zoomOutButton;
	private Button _getButton;

	public MyUserControl()
	{
		InitializeComponent();

		commands.Target = this;
		commands.SetZoomCommands(_zoomInButton, ZoomCommands.ZoomIn);
		Console.WriteLine(commands.GetZoomCommands(_zoomInButton).ToString());

		commands.SetZoomCommands(_zoomOutButton, ZoomCommands.ZoomOut);
		Console.WriteLine(commands.GetZoomCommands(_zoomOutButton).ToString());

		_getButton.Click += _getButton_Click;
	}

	void _getButton_Click(object sender, EventArgs e)
	{
		Console.WriteLine(commands.OwnerForm.ToString());
		Console.WriteLine(commands.OwnerGcZoom.ToString());
	}

	private void InitializeComponent()
	{
		_zoomInButton = new Button();
		_zoomInButton.Text = "+";
		_zoomInButton.Size = new Size(40, 40);
		_zoomInButton.Location = new Point(10, 10);

		_zoomOutButton = new Button();
		_zoomOutButton.Text = "_";
		_zoomOutButton.Size = new Size(40, 40);
		_zoomOutButton.Location = new Point(60, 10);

		_getButton = new Button();
		_getButton.Text = "Get";
		_getButton.Size = new Size(40, 40);
		_getButton.Location = new Point(110, 10);

		this.Size = new Size(160, 60);
		this.Controls.Add(_zoomInButton);
		this.Controls.Add(_zoomOutButton);
		this.Controls.Add(_getButton);
	}
}

Public Class ControlBarDemo
	Inherits Form
	Private _controlBarButton As Button
	Private _userControl As New MyUserControl()
	Private _gcZoom1 As New GcZoom()

	Public Sub New()
		InitializeComponent()

		_gcZoom1.Target = Me

		' Create ControlBar
		AddControlBar()
	End Sub

	Private Sub AddControlBar()
		Dim controlBar As New ControlBar()

		' Content should is a Type of UserControl.
		controlBar.Content = _userControl.[GetType]()
		controlBar.PositionMode = PositionMode.Floating

		' Only take effect when Position Mode is Dock.
		' controlBar.DockPosition = ContentAlignment.MiddleCenter;
		' controlBar.Margin = new System.Windows.Forms.Padding();

		' Only take effect when PositionMode is Fix or Flowing.
		controlBar.Position = New Point(20, 20)

		controlBar.Opacity = 1.0
		controlBar.TransparentBackground = True

		_gcZoom1.ControlBars.Add(controlBar)
	End Sub

	Private Sub InitializeComponent()
		_controlBarButton = New Button()
		_controlBarButton.Text = "This is a Button"
		_controlBarButton.Location = New Point(100, 100)
		_controlBarButton.Size = New Size(120, 30)
		Me.Controls.Add(_controlBarButton)
	End Sub
End Class

Public Class MyUserControl
	Inherits UserControl
	Private commands As New GcZoomCommandProvider()
	Private _zoomInButton As Button
	Private _zoomOutButton As Button
	Private _getButton As Button

	Public Sub New()
 		InitializeComponent()

		commands.Target = Me
		commands.SetZoomCommands(_zoomInButton, ZoomCommands.ZoomIn)
		Console.WriteLine(commands.GetZoomCommands(_zoomInButton).ToString())

		commands.SetZoomCommands(_zoomOutButton, ZoomCommands.ZoomOut)
		Console.WriteLine(commands.GetZoomCommands(_zoomOutButton).ToString())

		AddHandler _getButton.Click, AddressOf _getButton_Click
	End Sub

	Private Sub _getButton_Click(sender As Object, e As EventArgs)
		Console.WriteLine(commands.OwnerForm.ToString())
		Console.WriteLine(commands.OwnerGcZoom.ToString())
	End Sub

	Private Sub InitializeComponent()
 		_zoomInButton = New Button()
 		_zoomInButton.Text = "+"
 		_zoomInButton.Size = New Size(40, 40)
 		_zoomInButton.Location = New Point(10, 10)

 		_zoomOutButton = New Button()
 		_zoomOutButton.Text = "_"
 		_zoomOutButton.Size = New Size(40, 40)
 		_zoomOutButton.Location = New Point(60, 10)

 		_getButton = New Button()
 		_getButton.Text = "Get"
 		_getButton.Size = New Size(40, 40)
 		_getButton.Location = New Point(110, 10)

 		Me.Size = New Size(160, 60)
 		Me.Controls.Add(_zoomInButton)
 		Me.Controls.Add(_zoomOutButton)
 		Me.Controls.Add(_getButton)
	End Sub
End Class

Constructors

Name	Description
ControlBar()	Initializes a new instance of the ControlBar class.

Properties

Name	Description
Content	Gets or sets a value indicating the C1.Win.TouchToolKit.ControlBar.UserControl type object for the ControlBar window.
DockPosition	Gets or sets a value indicating the alignment of the ControlBar window.
Margin	Gets or sets a value indicating the outer margin of a ControlBar window relative the owner form client coordinates.
Opacity	Gets or sets the opacity level of the ControlBar window.
Position	Gets or sets a value that represents the upper-left corner of the owner form client coordinates.
PositionMode	Gets or sets the ControlBar window position mode.
TransparencyKey	Gets or sets the color that will represent transparent the ControlBar window.
TransparentBackground	Gets or sets a value indicating whether the ControlBar window is transparent.

Methods

Name	Description
Dispose()	Releases the unmanaged resources.