WinForms Sizer

ComponentOne
Sizer for WinForms
Copyright 1987-2015 GrapeCity, Inc. All rights reserved.
ComponentOne, a division of GrapeCity

201 South Highland Avenue, Third Floor
Pittsburgh, PA 15206 USA
Website:
Sales:
Telephone:
http://www.componentone.com
sales@componentone.com
1.800.858.2739 or 1.412.681.4343 (Pittsburgh, PA USA Office)
Trademarks
The ComponentOne product name is a trademark and ComponentOne is a registered trademark of GrapeCity, Inc.
All other trademarks used herein are the properties of their respective owners.
Warranty
ComponentOne warrants that the media on which the software is delivered is free from defects in material and
workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this
time, you may return the defective media to ComponentOne, along with a dated proof of purchase, and
ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for the defective media by
sending it and a check for $25 (to cover postage and handling) to ComponentOne.
Except for the express warranty of the original media on which the software is delivered is set forth here,
ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the
information contained in this manual is correct as of the time it was written. ComponentOne is not responsible for
any errors or omissions. ComponentOnes liability is limited to the amount you paid for the product. ComponentOne
is not liable for any special, consequential, or other damages for any reason.
Copying and Distribution

While you are welcome to make backup copies of the software for your own use and protection, you are not
permitted to make copies for the use of anyone else. We put a lot of time and effort into creating this product, and
we appreciate your support in seeing that it is used by licensed users only.
Table of Contents
Sizer for WinForms Overview ....................................................................................................... 8
Help with WinForms Edition ..................................................................................................... 8
Migrating a C1Sizer Project to Visual Studio 2005.................................................................... 8
Key Features................................................................................................................................ 12
Design-Time Support .................................................................................................................. 13
C1Sizer Smart Tag ................................................................................................................... 13
C1SizerLight Smart Tag ........................................................................................................... 14
C1Sizer Context Menus ........................................................................................................... 15
C1Sizer Grid Editor .................................................................................................................. 16
C1Sizer Gradient Editor ........................................................................................................... 18
Using the C1SizerLight Component ............................................................................................ 20
Quick Start Tutorial ................................................................................................................. 20
Using the C1Sizer Control ........................................................................................................... 24
Tutorial 1: Set up the grid, then add the controls .................................................................. 26
Tutorial 2: Add the controls, then set up the grid .................................................................. 33
Sizer for WinForms Samples ....................................................................................................... 37
Sizer for WinForms Task-Based Help .......................................................................................... 38
Add a C1SizerLight Component to a Form in code ................................................................. 39
Position Controls on the C1Sizer Grid at Run Time ................................................................ 40
Create a Three Dimensional Border for the Rows and Columns ............................................ 42
Store Layout Information for the C1Sizer Control .................................................................. 43
API Reference.............................................................................................................................. 45
C1.Win.C1Sizer.4 Assembly .................................................................................................... 45
Namespaces ........................................................................................................................ 45
C1.Win.C1Sizer Namespace ............................................................................................ 45
Overview ..................................................................................................................... 45
Classes ......................................................................................................................... 47
Band ........................................................................................................................ 47
Overview ............................................................................................................. 48
Members ............................................................................................................. 49
Properties............................................................................................................ 50
Bounds Property ............................................................................................. 50
Index Property ................................................................................................ 51

IsFixedSize Property ........................................................................................ 52
IsSplitter Property ........................................................................................... 52
Size Property ................................................................................................... 53
BandCollection ........................................................................................................ 54
Overview ............................................................................................................. 55
Members ............................................................................................................. 55
Methods .............................................................................................................. 56
Insert Method ................................................................................................. 57
Remove Method ............................................................................................. 57
SetSizes Method.............................................................................................. 58
Properties............................................................................................................ 59
Count Property................................................................................................ 60
Border ..................................................................................................................... 60
Overview ............................................................................................................. 61
Members ............................................................................................................. 62
Properties............................................................................................................ 62
Color Property ................................................................................................. 63
Corners Property ............................................................................................. 64
Thickness Property .......................................................................................... 64
C1Sizer..................................................................................................................... 65
Overview ............................................................................................................. 66
Members ............................................................................................................. 67
C1Sizer Constructor ............................................................................................ 78
Methods .............................................................................................................. 79
AddControl Method ........................................................................................ 82
AddControl(Control,Int32,Int32,Int32,Int32) Method ................................ 82
AddControl(Control,Int32,Int32) Method................................................... 84
GetCellAtPoint Method................................................................................... 85
GetCellAtPoint(Point) Method .................................................................... 85
GetCellAtPoint(Int32,Int32) Method .......................................................... 86
GetCellBounds Method................................................................................... 87
GetCellBounds(Int32,Int32,Int32,Int32) Method ....................................... 88
GetCellBounds(Int32,Int32) Method .......................................................... 89
GetControlAtCell Method ............................................................................... 90

ResumeLayout Method................................................................................... 91
ResumeLayout() Method ............................................................................ 92
ResumeLayout(Boolean) Method ............................................................... 93
SuspendLayout Method .................................................................................. 93
Properties............................................................................................................ 94
AutoSizeMode Property.................................................................................. 99
BackColor Property ......................................................................................... 99
Border Property ............................................................................................ 100
Cursor Property ............................................................................................. 100
Gradient Property ......................................................................................... 101
Grid Property ................................................................................................ 101
Image Property ............................................................................................. 102
ImageAlignment Property ............................................................................. 103
ImageScaling Property .................................................................................. 103
Padding Property .......................................................................................... 104
SplitterWidth Property.................................................................................. 104
Events ................................................................................................................ 105
SplitterMoved Event ..................................................................................... 109
SplitterMoving Event .................................................................................... 110
C1SizerEventArgs .................................................................................................. 111
Overview ........................................................................................................... 112
Members ........................................................................................................... 112
Properties.......................................................................................................... 113
Band Property ............................................................................................... 114
X Property ..................................................................................................... 114
Y Property ..................................................................................................... 115
C1SizerLight ........................................................................................................... 115
Overview ........................................................................................................... 116
Members ........................................................................................................... 118
C1SizerLight Constructor................................................................................... 119
C1SizerLight Constructor(IContainer) ........................................................... 120
C1SizerLight Constructor() ............................................................................ 121
Methods ............................................................................................................ 121
GetAutoResize Method ................................................................................. 122

SetAutoResize Method ................................................................................. 123
Properties.......................................................................................................... 124
Enabled Property .......................................................................................... 124
ResizeFonts Property .................................................................................... 125
Events ................................................................................................................ 126
ResizingControl Event ................................................................................... 126
ResizingFont Event ........................................................................................ 127
C1SizerLightEventArgs .......................................................................................... 129
Overview ........................................................................................................... 129
Members ........................................................................................................... 130
Properties.......................................................................................................... 131
Cancel Property............................................................................................. 131
Control Property ........................................................................................... 132
Column .................................................................................................................. 132
Overview ........................................................................................................... 133
Members ........................................................................................................... 134
Methods ............................................................................................................ 135
ToString Method ........................................................................................... 135
Properties.......................................................................................................... 136
Size Property ................................................................................................. 137
ColumnCollection .................................................................................................. 138
Overview ........................................................................................................... 138
Members ........................................................................................................... 139
Properties.......................................................................................................... 140
Item Property ................................................................................................ 141
Gradient ................................................................................................................ 141
Overview ........................................................................................................... 142
Members ........................................................................................................... 143
Properties.......................................................................................................... 144
BackColor2 Property ..................................................................................... 144
Blend Property .............................................................................................. 145
Center Property ............................................................................................ 146
GammaCorrection Property.......................................................................... 146
Mode Property .............................................................................................. 147

Grid........................................................................................................................ 147
Overview ........................................................................................................... 148
Members ........................................................................................................... 149
Methods ............................................................................................................ 150
AutoGenerate Method ................................................................................. 150
Clear Method ................................................................................................ 151
Properties.......................................................................................................... 151
Columns Property ......................................................................................... 152
DraggingSplitter Property ............................................................................. 153
Rows Property ............................................................................................... 153
SelectedObjects Property ............................................................................. 154
Sizer Property ................................................................................................ 154
Row ....................................................................................................................... 155
Overview ........................................................................................................... 156
Members ........................................................................................................... 156
Methods ............................................................................................................ 157
ToString Method ........................................................................................... 158
Properties.......................................................................................................... 158
Size Property ................................................................................................. 159
RowCollection ....................................................................................................... 160
Overview ........................................................................................................... 161
Members ........................................................................................................... 162
Properties.......................................................................................................... 162
Item Property ................................................................................................ 163
Strings ................................................................................................................... 164
Overview ........................................................................................................... 165
Members ........................................................................................................... 165
Properties.......................................................................................................... 166
CannotInsertBand Property .......................................................................... 167
CannotRemoveBand Property ...................................................................... 167
Column Property ........................................................................................... 168
ConfirmClearGrid Property ........................................................................... 168
DesignTimeMessage Property ...................................................................... 169
ResourceManager Property .......................................................................... 169

Row Property ................................................................................................ 170
UICulture Property ........................................................................................ 170
Strings.BlendErrors ............................................................................................... 171
Overview ........................................................................................................... 172
Members ........................................................................................................... 172
Properties.......................................................................................................... 173
BadFormat Property ..................................................................................... 174
BadPosition Property .................................................................................... 174
BadPositionOrFactor Property ...................................................................... 175
CannotParseFloats Property ......................................................................... 175
NonAscendingPositions Property ................................................................. 176
Enumerations ............................................................................................................ 176
AutoSizeEnum ....................................................................................................... 176
GradientMode....................................................................................................... 177
ImageAlignment .................................................................................................... 178
ImageScaling ......................................................................................................... 180
Structures .................................................................................................................. 181
Corners .................................................................................................................. 181
Overview ........................................................................................................... 182
Members ........................................................................................................... 183
Corners Constructor .......................................................................................... 184
Corners Constructor(Int32,Int32,Int32,Int32) .............................................. 185
Corners Constructor(Int32) ........................................................................... 186
Methods ............................................................................................................ 187
Equals Method .............................................................................................. 187
GetHashCode Method .................................................................................. 188
Properties.......................................................................................................... 189
Empty Property ............................................................................................. 190
IsEmpty Property .......................................................................................... 190
LeftBottom Property ..................................................................................... 191
LeftTop Property ........................................................................................... 191
RightBottom Property ................................................................................... 192
RightTop Property ......................................................................................... 192
Operators .......................................................................................................... 193

Equality Operator .......................................................................................... 193
Implicit Type Conversion Operator ............................................................... 194
Inequality Operator....................................................................................... 195
Delegates .................................................................................................................. 196
C1SizerEventHandler............................................................................................. 196
C1SizerLightEventHandler..................................................................................... 197
Sizer for WinForms Overview

Create resolution-independent applications without having to write any code with Sizer for
WinForms. The powerful C1Sizer and C1SizerLight components, provided with Sizer for
WinForms, make this possible. Now you can resize all contained controls proportionally, so
your Windows Form retains its appearance at any resolution.
C1Sizer is a container control with a powerful grid layout manager that extends the basic layout
capabilities provided by the .NET Framework (Dock and Anchor properties). The C1Sizer control
allows you to define a grid made up of bands and then add controls that snap to these bands.
When the C1Sizer control is resized, the bands are automatically recalculated, and contained
controls move automatically to their new positions. You can set up bands at design time and
configure them to act as splitters or to keep their size constant when the control is resized.
See Also
Help with WinForms Edition
Migrating a C1Sizer Project to Visual Studio 2005
Help with WinForms Edition

Getting Started
For information on installing ComponentOne Studio WinForms Edition, licensing, technical
support, namespaces and creating a project with the control, please visit Getting Started with
WinForms Edition.
See Also
Migrating a C1Sizer Project to Visual Studio 2005
Migrating a C1Sizer Project to Visual

Studio 2005
To migrate a project using ComponentOne components to Visual Studio 2005, there are two
main steps that must be performed. First, you must convert your project to Visual Studio 2005,
which includes removing any references to a previous assembly and adding a reference to the
new assembly. Secondly, the .licx file, or licensing file, must be updated in order for the project
to run correctly.
To convert the project:

1.
Open Visual Studio 2005 and select File, Open Project.
2.
Locate the .sln file for the project that you wish to convert to Visual Studio 2005. Select
it and click Open. The Visual Studio Conversion Wizard appears.
3.
4.
Click Next.
Select Yes, create a backup before converting to create a backup of your current
project and click Next.
5.
Click Finish to convert your project to Visual Studio 2005. The Conversion Complete
window appears.
6.
Click Show the conversion log when the wizard is closed if you want to view the
conversion log.
7.
Click Close. The project opens. Now you must remove references to any of the previous
ComponentOne .dlls and add references to the new ones.
Go to the Solution Explorer (View | Solution Explorer), select the project, and click the
Show All Files button.
8.
Note: The Show All Files button does not appear in the Solution Explorer toolbar if the
Solution project node is selected.
9.
Expand the References node, right-click C1.Win.C1Sizer and select Remove.
10
10.
11.
12.
13.
Right-click the References node and select Add Reference.

Locate and select C1.Win.C1Sizer.2.dll. Click OK to add it to the project.
To update the .licx file:
In the Solution Explorer, right-click the licenses.licx file and select Delete.
14. Click OK to permanently delete licenses.licx. The project must be rebuilt to create a
new, updated version of the .licx file.
15. Click the Start Debugging button to compile and run the project. The new .licx file may
not be visible in the Solution Explorer.
16. Select File | Close to close the form and then double-click the Form.vb or Form.cs file
in the Solution Explorer to reopen it. The new licenses.licx file appears in the list of
11
files.
The migration process is complete.
See Also
Key Features
Key Features
Sizer for WinForms includes the following features:
Create a Gradient Background

With the easy-to-use C1Sizer Gradient Editor that is accessible from the "Edit Gradient"
Smart Tag, you can quickly add a gradient to the sizer panel and customize the gradient
settings.
Update your Form with Rounded Corners
The new Border property gives you the flexibility to add rounded corners to the sizer
and modify the color, thickness, and more.
Flexibility when Adding Images to the Background
With the new image properties you have more power and flexibility for using images as
part of the background. You can now control the alignment and scale of the images.
Arrange Controls on the Form with Ease
The C1Sizer control act like a piece of graph paper where each control will occupy one
or more of the grid boxes on the form. The graph allows you to neatly layout the
controls on the form. You have the flexibility to set up the grid before or after you
create the child controls.
12
Resize all Contained Controls Proportionally

The C1SizerLight component is a non-visual component that keeps track of a form's
size and position When the form is resized, the C1SizerLight component resizes all
contained controls proportionally, so the form retains its appearance at any resolution.
C1SizerLight can also resize the fonts on all or some of the contained controls.
Easy-to-use Grid Editor
Efficiently set up your form with the Grid Editor. Simply add one or more C1Sizer
controls to the form, and set their Dock property to fill the form. Then use the Grid
Editor to set up a grid layout, and add controls which will snap to the grid. You can also
set the number and dimension of the grid's bands (rows and columns), and also specify
which bands should act as splitters, and which should have fixed dimensions.
See Also
Design-Time Support
Design-Time Support
C1Sizer provides customized context menus, smart tags, and a designer that offers rich designtime support and simplifies working with the object model.
The following sections describe how to use C1Sizer's design-time environment to configure
C1Sizer's controls/components.
See Also
C1Sizer Smart Tag
C1SizerLight Smart Tag
C1Sizer Context Menus
C1Sizer Grid Editor
C1Sizer Gradient Editor
C1Sizer Smart Tag

In Visual Studio, the C1Sizer control includes a smart tag. A smart tag represents a short-cut
tasks menu that provides the most commonly used properties in each component/command.
The C1Sizer control provides quick and easy access to the C1Sizer Grid Editor and common
properties through its smart tag.
To access the C1Sizer Tasks menu, click on the smart tag ( ) in the upper-right corner of the
C1Sizer control. This will open the C1Sizer Tasks menu.
13
The C1Sizer Tasks menu operates as follows:
About C1Sizer
Clicking on the About item displays the About C1Sizer dialog box, which is helpful in finding
the version number of C1Sizer and online resources.
Edit Gradient
Clicking on the Edit Gradient item opens the C1Sizer Grid Editor. For more information about
the C1Sizer Gradient Editor's elements, see C1Sizer Gradient Editor.
Edit Grid
Clicking on the Edit Grid item opens the C1Sizer Grid Editor. For more information about the
C1Sizer Grid Editor's elements, see C1Sizer Grid Editor.
Auto Grid
Clicking on the Auto Grid item clears all unused bands in the grid that don't have any controls
attached to them.
Clear Grid
Clicking on the Clear Grid item removes the bands from the grid.
Dock in parent container

Clicking on the Dock in parent container link docks the C1Sizer control inside its parent
container.
See Also

The C1SizerLight component provides quick and easy access to the About C1Sizer dialog box
through its smart tag.
14
To access the C1SizerLight Tasks menu, click on the smart tag ( ) in the upper right corner of
the C1SizerLight component. This will open the C1SizerLight Tasks menu.
The C1SizerLight Tasks menu operates as follows:
About C1Sizer
Clicking on the About item displays the About C1Sizer dialog box, which is helpful in finding
the version number of C1Sizer and online resources.
See Also

C1Sizer has additional commands with each context menu that Visual Studio provides for all
.NET controls.
C1Sizer Context Menu

Right-click anywhere on the list to display the C1Sizer context menu.
The following table provides a brief description of the custom commands added by C1Sizer:
Commands
Description
About
Displays the About C1Sizer dialog box, which is helpful in finding the version
C1Sizer
number of C1Sizer and online resources.
Edit Grid
Opens the C1Sizer Grid Editor.
Edit Gradient Opens the C1Sizer Gradient Editor.

Auto Grid
Clears all unused bands in the grid that don't have any controls attached to
them.
Clear Grid
Removes the bands from the grid.
C1SizerLight Context Menu
15
Right-click anywhere on the C1SizerLight component to display the C1SizerLight context

menu.
The following table provides a brief description of the custom commands added by
C1SizerLight:
Commands
Description
About
Displays the About C1Sizer dialog box, which is helpful in finding the version
C1Sizer
number of C1Sizer and online resources.
See Also
C1Sizer Grid Editor
C1Sizer Grid Editor

C1Sizer has a Grid Editor to edit or add bands to rows and columns of the grid at design time.
To access the C1Sizer Grid Editor:

Open the C1Sizer Tasks menu and click on the Edit Grid item or right-click the C1Sizer control
and select Edit Grid from its context menu.
16
Tabs
C1Sizer Grid Editor consist of two important tabs: Rows and Columns. Both tabs share the
same command buttons and properties. Click the Columns tab to create or modify the bands in
the Columns of the grid. Click the Rows tab to create or modify the bands in the Rows of the
grid.
Command Buttons
The following command buttons are available in both tabs:
Command
Description
Insert
Inserts a new band at the selection.
Add
Adds a new band to the collection.
Delete
Deletes the selected bands.
Even
Makes all bands the same size.
Clear
Removes all bands.
17
Auto
Creates bands based on child control.
OK
Updates the changes and closes the C1Sizer Grid Editor.
Properties
The following properties are available in both tabs:
Property
Description
IsFixedSize Determines whether the band should keep its size constant when the control is
resized. The default value is False.
IsSplitter
Determines whether the band acts like a splitter (can be resized with the mouse at
run time). The default value is False.
Size
Gets or sets the row height or column width in pixels.
See Also

C1Sizer has a Gradient Editor to add gradients to the C1Sizer grid at design time.
To access the C1Sizer Gradient Editor:

Open the C1Sizer Tasks menu and click on the Edit Gradient item or right-click the C1Sizer
control and select Edit Gradient from its context menu.
18
Gradient Group
C1Sizer Gradient Editor consist of two important groups: Gradient and Blend. The Gradient
group consist of BackColor and Gradient properties and a Preview window so you can preview
the gradient updates you make to the C1Sizer control.
The Gradient group consists of the following properties:
Property
Description
C1Sizer.BackColor
Gets or sets the Drawing.Color used to paint the background.
Gradient.BackColor2
Gets or sets the secondary color used to build the background

gradient.
GradientMode
Specifies the background gradient mode.
Gradient.GammaCorrection Gets or sets whether to apply gamma correction to the

background gradient.
Blend Group
The Blend group enables you to choose from a stock blend and customize the blend by flipping
the blend colors horizontally or vertically.
19
See Also
Using the C1SizerLight Component
Using the C1SizerLight Component

C1SizerLight is a non-visual component. When you add it to a form, it keeps track of the form's
size and position. When the form is resized, C1SizerLight resizes all contained controls
proportionally, so the form retains its appearance at any resolution. C1SizerLight can also
resize the fonts on all or some of the contained controls.
Using the C1SizerLight component is extremely easy. Start by creating a Windows Form as
usual (or open an existing one), and simply add a C1SizerLight component to it. Then run the
project and resize the form. All controls on the form will be automatically resized with the form
(including their fonts).
See Also
Quick Start Tutorial
Quick Start Tutorial

This Quick Start tutorial shows how the C1SizerLight component functions. It also demonstrates
how the C1SizerLight.ResizeFonts property and C1SizerLight.ResizingFont event work. To
experiment with the C1SizerLight component, open Visual Studio and create a new .NET
project, add the C1SizerLight component to the form, then add the buttons and list box on the
form so it looks like the following:
Now run the project and resize the form. If you make it smaller, parts of the controls will be
clipped.
20
If you make it bigger, you will see an empty gray area.
You could improve the controls' appearance on the form using the Dock and Align properties
on the controls, but there is no combination of these two properties that will prevent the
controls from overlapping each other or leaving blank areas on the form. Also, depending on
your monitor's resolution, the fonts may appear very small when you enlarge the form.
Instead of making the form size fixed and giving up the resize feature, add a C1SizerLight
component to the form. C1SizerLight is a non-visual component, so it will appear in the tray
area below the form.
21
You do not have to set any properties or write any code, just run the project again and resize
the form. All contained controls will automatically resize and the form will retain its aspect:
Resizing Fonts
Notice that when you resized the form, the fonts in the button controls were resized to
accommodate the new size. This is the default behavior provided by C1SizerLight.In some cases,
you may want to prevent that and keep all the original font sizes. You can do this using the
C1SizerLight.ResizeFonts property. Set C1SizerLight.ResizeFonts to False and the fonts will not
resize.
To set the C1SizerLight.ResizeFonts to False at design-time use the following steps:
22
1.
2.
Select C1SizerLight in the Properties sheet.

Set the C1SizerLight.ResizeFonts to False.
You may also want to prevent font resizing in specific controls. For example, it would probably
be a good idea to keep the font size constant for the list control on our sample form, and
update the fonts on the buttons only. (In general, controls that can scroll their contents do not
need the font resizing feature). To do this, you need to handle the C1SizerLight.ResizingFont
event and cancel it for some controls. For example, the following event handler will cause the
component to resize fonts in button controls only:
To write code in Visual Basic
Visual Basic
Copy Code
Private Sub C1SizerLight1_ResizingFont(ByVal sender As Object, _

ByVal e As C1.Win.C1Sizer.C1SizerLightEventArgs) Handles _
C1SizerLight1.ResizingFont
If Not (e.Control.GetType() Is GetType(Button)) Then
e.Cancel = True
End If
End Sub
To write code in C#
C#
Copy Code
private void c1SizerLight1_ResizingFont(object sender,
23
C1.Win.C1Sizer.C1SizerLightEventArgs e)
{
if (!(e.Control is Button))
e.Cancel = true;
}
If you run the project again, you will notice that the ListBox control retains the original font
when the form is resized.
Docked and Nested Controls

Although C1SizerLight provides easy-to-use power, you may still want to use the native layout
capabilities in the .NET framework. For example, if you add a ToolBar or StatusBar control to
the form, you probably want those controls docked to the top or bottom of the form, and
C1SizerLight should not change their dimensions.
That is why C1SizerLight will not resize any docked controls. It will take into account the fact
that they are docked and will reduce the form's client area accordingly, so all non-docked
controls will still be resized correctly.
This makes it easy to use C1SizerLight and still takes advantage of the layout capabilities built
into the .NET framework.
MDI Forms
C1SizerLight also works with MDI child forms. Simply add a C1SizerLight component to each
child form and they will be resized proportionally, just like any regular form.
See Also
Using the C1Sizer Control
Using the C1Sizer Control

C1Sizer is a container control with a powerful grid layout manager that extends the basic layout
capabilities provided by the .NET framework (Dock and Anchor properties). The C1Sizer control
24
allows you to define a grid made up of bands, then add controls that snap to these bands.
When the C1Sizer control is resized, the bands are automatically recalculated, and contained
controls move automatically to their new positions. You can set up bands at design time and
configure them to act as splitters, or to keep their size constant when the control is resized.
Think of C1Sizer as a piece of graph paper. Each component will occupy one or more of the
little boxes on the paper. This is similar to tables in word processors such as Microsoft Word,
where you can merge adjacent cells, and to Java's Grid Bag Layout, which works in a similar way.
There are two basic approaches to using the C1Sizer control in your projects: You can set up
the grid before or after you create the child controls. For more information how to set up the
grid before you create the child controls, see Tutorial 1: Set up the grid, then add the controls
or how to set up the grid after you create the controls, see Tutorial 2: Add the controls, then set
up the grid.
The following table lists the controls that require an additional property other than the
Band.Bounds property:
Control
Property Setting
TextBox
The TextBox control allows you to set its height only if MultiLine = True. Otherwise
the height is set automatically based on the Font.
ComboBox The ComboBox control allows you to set its height only if DrawMode =
OwnerDraw.
ListBox
The ListBox control allows you to set its height (exactly) only if IntegralHeight =
False.
The next section includes two tutorials that that illustrate some of the main features in the
C1Sizer control. The tutorials walk you through the creation of several simple projects,
describing each step in detail. The distribution CD contains more sophisticated samples that can
be used as a reference.
Here is a brief overview of the tutorials that follow:
Name
Description
Tutorial This tutorial provides a thorough introduction to the primary features of the C1Sizer
1
control. It shows how to set up the grid by inserting columns and rows, adding labels
and data entry controls to the grid, cleaning up unused bands, setting up the splitters,
and creating fix-sized bands.
Tutorial This tutorial also provides an introduction to the typical usage of the C1Sizer control.
25
It shows how to add the controls and then set up the grid.
See Also
Tutorial 1: Set up the grid, then add the controls
Tutorial 2: Add the controls, then set up the grid
Tutorial 1: Set up the grid, then add the

controls
In this tutorial you'll learn how to use elements and properties in the C1Sizer Grid Editor to set
up a grid. This tutorial demonstrates the following C1Sizer features:
Inserting/deleting rows and columns

Arranging controls on the grid
Settingthe C1Sizer.SplitterWidth and C1Sizer.BorderWidth properties
Applying AutoGrid to clean up unused bands
Setting the Band.IsFixedSize and Band.IsSplitter properties
To set up the grid for C1Sizer, complete the following steps:

1.
2.
Open Visual Studio and create a new project, then add a C1Sizer control to the form
and set its Dock property to DockStyle.Fill so it takes up the whole form. At this point,
the C1Sizer does not have a grid layout set up yet, or any child controls, so it will
display a message with brief instructions on how to use the control, but this can be
ignored for now.
Now, right-click the C1Sizer control and select the Edit Grid option from the menu.
This will bring up the C1Sizer Grid Editor dialog box so you can set up the grid layout.
26
The C1Sizer Grid Editor appears like the following:
3.
Position the editor next to the grid so you can see the effect of the changes on the
control. Next, click the Insert button until the grid has eight rows. Then, click the
Columns tab and click Insert again until the grid has eight columns. This is what the
control will look like at design time:
The grid is displayed at design time as a series of indented rectangles. Click OK to

dismiss the editor, and add some controls to the form. Notice how the controls snap to
27
the grid layout. You can resize any control and make it span any number of rows and
columns.
4.
To follow the tutorial, add eight text boxes and eight label controls, and arrange them
so the form looks like the following:
Note: Remember to set the MultiLine property of the textbox controls to True, or they will
not resize vertically. Also, when you place a text box control on the form it automatically
expands to three columns.
5.
Select the cursor over the second column and drag it to the left so there is enough
space for the labels, then select the cursor over each row and drag it upward to make
the height of each row smaller. The following picture illustrates this effect:
28
6.
Change each label's AutoSize property to False, then change each label's TextAlign
property to TopRight. The labels will appear like the following:
If you think the controls are too close to each other or too far apart, change the
C1Sizer.SplitterWidth and C1Sizer.BorderWidth properties to achieve the effect you
want.
If you run the project now, you will see that when you resize the form, the text boxes
and labels are automatically resized.
Cleaning up the grid

Right now the grid has eight rows and eight columns. Most of these bands are being used
(controls are attached to them), but not all. To clean up the layout and get rid of unused bands,
right click the C1Sizer control and select the AutoGrid option from the menu. This will clear
any bands that have no controls attached to them.
29
The C1Sizer appears like the following:
Deleting columns and rows

To remove the first column, Column 0, from the C1Sizer Grid Editor, right-click the C1Sizer
control and select the Edit Grid option from the menu. The C1Sizer Grid Editor appears. Select
the Columns tab and click on the Delete button and click OK.
The C1Sizer grid appears like the following image at design time.
30
Setting up a splitter
Each band (row or column) on the grid can be configured to act as a splitter. For example, if you
wanted to allow users to control the size of the label area on the left, you would bring up the
grid editor, select the first column and set the Band.IsSplitter property to True, as shown below:
Note: A splitter can also be added by right-clicking the band and selecting Splitter from
the context menu.
31
Notice the dark gray bar to the right of the first column. This indicates that the user will be able
to drag that splitter at run time, automatically resizing the labels and text boxes on the first two
columns of the grid.
Setting up a fixed-size band

When the control is resized, the grid layout is adjusted to keep the proportion between the
bands. You can designate certain bands as fixed size, and they will not be resized.
For example, we might want to allow only the bottom text box to be resized vertically, and keep
the height of all others constant. To do this, bring up the grid editor, select the first six rows and
set the Band.IsFixedSize property to True.
Note: A fixed-sized band can also be configured by right-clicking the band and selecting
Fixed Size from the context menu.
Click the OK button. The C1Sizer appears with red markers on the first six rows. This indicates
that those rows will not be resized with the form (the last two will).
32
Run the program and observe the following:

Use the splitter to adjust the size of the labels and text boxes, then resize the form and notice
how the top text boxes retain their height.
This concludes Tutorial 1. The following tutorial provides more detail about adding controls to
the form and setting up the C1Sizer grid.
See Also
Tutorial 2: Add the controls, then set up the grid
Tutorial 2: Add the controls, then set up

the grid
In the previous tutorial, we started with the grid and then added controls. You may prefer to
work the other way around. Forget about the grid initially, and design your form the normal
way. Then, when you are done, let C1Sizer create the grid for you automatically. (Of course,
33
once the grid is created you may still modify it with the design time commands we used earlier
to tweak the grid's appearance and behavior.)
1.
2.
Open Visual Studio and create a new project, then add a C1Sizer control to the form
and set its Dock property to DockStyle.Fill so it takes up the whole form.
Now add the following controls so the form looks like a FileOpen dialog box:
o 3 Labels
o 2 ComboBoxes
o 1 TextBox
o 7 Buttons
o 1 ListBox
You can use all the layout commands available in Visual Studio to set up this new form.
There is nothing new so far.
3.
4.
Next, change the C1Sizer.SplitterWidth property on the C1Sizer control to a small value,
one or two pixels. This is recommended because the form has some buttons that are
very close together, and we want them to stay that way when we create the grid.
To create the grid, right-click the C1Sizer control and select the AutoGrid option from
the context menu. The control will create a grid based on the position of the child
controls. The grid will look like this:
34
5.
6.
If you run the project now, you will see that when you resize the form, the contained
controls are resized proportionally.
In this case, however, you probably do not want the buttons and text boxes stretched
vertically, only the list box. In this case, bring up the grid editor, select all rows except
the one that contains the ListBox, and set the Band.IsFixedSize property to True, as
shown below (note the fixed rows are highlighted in red in the designer):
Select OK.
The designer highlights the fixed rows in red.
35
Run the program and observe the following:

Resize the form to see how the controls snap to the grid and adjust the layout automatically.
See Also
Sizer for WinForms Samples
36
Sizer for WinForms Samples

Please be advised that this ComponentOne software tool is accompanied by various sample
projects and/or demos which may make use of other development tools included with
ComponentOne Studio.
Please refer to the pre-installed product samples through the following path:
Documents\ComponentOne Samples\WinForms
The following examples are included for the C1Sizer control:
Visual Basic Samples

C1Sizer includes the following Visual Basic samples:
Sample
Description
SizerTutorial1 Demonstrates how to set up the grid and add controls. This sample uses the
C1Sizer control.
SizerTutorial2 Demonstrates how to add controls and set up the grid. This sample uses the
C1Sizer control.
C# Samples
C1Sizer includes the following C# samples:
Sample
Description
AddControls
Shows how to add child controls to a C1Sizer using code. This sample uses the
C1Sizer control.
CustomSplitters Use the OnPaint event to customize the appearance of the splitter bars. This
sample uses the C1Sizer control.
FakeOutlook
Create a user interface that looks like OutlookExpress. This sample uses the
C1Sizer control.
FakeStudio
Create a user interface that looks like Visual Studio. This sample uses the
C1Sizer control.
37
FindCell
Shows how to determine which cell is at a given point. This sample uses the
C1Sizer control.
FindControl
Shows how to determine which control is at a given grid cell. This sample uses
the C1Sizer control.
Light_MDI
Use the C1SizerLight with MDI forms. This sample uses the C1SizerLight
component.
Light_Nested
Use C1SizerLight in forms with docked and nested controls. This sample uses
the C1SizerLight component.
Light_Runtime
Control the C1SizerLight at run time. This sample uses the C1SizerLight
component.
Light_Toolbar
Automatically resize controls with a wrapping toolbar. The samples shows how
the C1SizerLight component works when the form has a wrapping toolbar
docked to the top. This sample uses the C1SizerLight component.
RowHeaders
Demonstrates how to combine the .NET Dock property and panel controls to
provide areas with headers. This sample uses the C1Sizer control.
SizerDesigner
Shows how to display the C1Sizer grid and implement the drag-and-drop
operations between grid cells. This sample uses the C1Sizer control.
See Also
Sizer for WinForms Task-Based Help
Sizer for WinForms Task-Based Help

The task-based help section assumes that you are familiar with programming in the Visual
Studio environment, and know how to use the C1Sizer and C1SizerLight controls/components
in general. If you are a novice to the C1Sizer for .NET product, please see Using the C1Sizer
Control first.
Each topic provides a solution for specific tasks using the Sizer for .NET product.
Each task-based help topic also assumes that you have created a new .NET project. For
additional information on this topic, see Creating a .NET 2.0 Project.
38
See Also
Add a C1SizerLight Component to a Form in code
Position Controls on the C1Sizer Grid at Run Time
Create a Three Dimensional Border for the Rows and Columns
Store Layout Information for the C1Sizer Control
Add a C1SizerLight Component to a Form

in code
To programmatically add a C1SizerLight component to a form, use the following code:
Visual Basic
Copy Code
If Me.components Is Nothing Then

Me.components = New System.ComponentModel.Container
End If
Dim szl As C1SizerLight = New C1SizerLight(components)
szl.SetAutoResize(Me, True)
To write code in C#
C#
Copy Code
if (this.components == null)
this.components = new System.ComponentModel.Container();
C1SizerLight szl = new C1SizerLight(components);
szl.SetAutoResize(this, true);
To programmatically create a generic form start-up procedure which every form will call, use
the following code:
Visual Basic
Copy Code
39
Dim c As Container = New System.ComponentModel.Container

For Each f As Form In myFormList
Dim szl As C1SizerLight = New C1SizerLight(c)
szl.SetAutoResize(f, True)
Next
To write code in C#
C#
Copy Code
Container c = new System.ComponentModel.Container();

foreach (Form f in myFormList)
{
C1SizerLight szl = new C1SizerLight(c);
szl.SetAutoResize(f, true);
}
See Also
Position Controls on the C1Sizer Grid at Run Time
Position Controls on the C1Sizer Grid at

Run Time
To position controls on the C1Sizer grid at run time, simply move the control to the area where
you want it to be located. The C1Sizer will snap the control to the nearest position on the grid,
and will automatically resize the control when the form is resized. The control can be positioned
over a single grid cell or it may span multiple cells.
1.
2.
3.
Add the C1Sizer control to your form.

Right-click on the C1Sizer control and select Edit Grid.
In the C1Sizer Grid Editor add three rows and three columns and then click OK.
To use the Band.Bounds property to determine the position of a grid cell, and the
Control.Bounds property to move the control, use the following code:
Visual Basic
Copy Code
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs)
40
Dim b1 As Button = New Button

c1Sizer1.Controls.Add(b1)
b1.Visible = True
b1.Bounds = GetCellRectangle(0, 0)
Dim rc As Rectangle = GetCellRectangle(1, 1)
rc = Rectangle.Union(rc, GetCellRectangle(2, 2))
Dim b2 As Button = New Button
c1Sizer1.Controls.Add(b2)
b2.Visible = True
b2.Bounds = rc
End Sub
Private Function GetCellRectangle(ByVal row As Integer, ByVal col As Integer)
As Rectangle
Return Rectangle.Intersect(c1Sizer1.Grid.Rows(row).Bounds,
c1Sizer1.Grid.Columns(col).Bounds)
End Function
To write code in C#
C#
Copy Code
private void Form1_Load(object sender, System.EventArgs e)

{
// Create a button and position it over cell (0,0)
Button b1 = new Button();
c1Sizer1.Controls.Add(b1);
b1.Visible = true;
b1.Bounds = GetCellRectangle(0,0);
// Calculate position of range (1,1)-(2,2)
Rectangle rc = GetCellRectangle(1,1);
rc = Rectangle.Union(rc, GetCellRectangle(2,2));
// Create a button and position it over cell range (1,1)-(2,2)
Button b2 = new Button();
c1Sizer1.Controls.Add(b2);
b2.Visible = true;
b2.Bounds = rc;
}
private Rectangle GetCellRectangle(int row, int col)
{
return Rectangle.Intersect(
41
c1Sizer1.Grid.Rows[row].Bounds,
c1Sizer1.Grid.Columns[col].Bounds);
}
See Also
Create a Three Dimensional Border for the Rows and Columns
Create a Three Dimensional Border for

the Rows and Columns
The following steps show you how to create a styled border for the rows and columns of the
C1Sizer control by using the C1Sizer.Paint event to repaint the control's rows and columns and
the DrawBorder3D method to draw an etched three dimensional border around the rows and
columns of the C1Sizer control:
1.
2.
3.
4.
Add the C1Sizer control to your form and set its Dock property to DockStyle.Fill so it
takes up the whole form.
Add some controls to C1Sizer's panel, for example two button controls.
Right-click the panel and select Auto Grid to create and activate the grid layout.
Add the following code to the C1Sizer1_Paint event to repaint its rows and columns
with a three dimensional border style:
Visual Basic
Copy Code
Private Sub C1Sizer1_Paint(ByVal sender As Object, ByVal e As PaintEventArgs)

For Each row As Band In Me.c1Sizer1.Grid.Rows
Dim rcrow As Rectangle = row.Bounds
For Each col As Band In Me.c1Sizer1.Grid.Columns
Dim rccol As Rectangle = col.Bounds
Dim rccel As Rectangle = Rectangle.Intersect(rcrow, rccol)
ControlPaint.DrawBorder3D(e.Graphics, rccel, Border3DStyle.Etched)
Next
Next
End Sub
To write code in C#
C#
Copy Code
42
private void c1Sizer1_Paint(object sender, PaintEventArgs e)

{
// Paint sizer grid
foreach (Band row in this.c1Sizer1.Grid.Rows)
{
Rectangle rcrow = row.Bounds;
foreach (Band col in this.c1Sizer1.Grid.Columns)
{
Rectangle rccol = col.Bounds;
Rectangle rccel = Rectangle.Intersect(rcrow, rccol);
ControlPaint.DrawBorder3D(e.Graphics, rccel,
Border3DStyle.Etched);
}
}
}
See Also
Store Layout Information for the C1Sizer Control
Store Layout Information for the C1Sizer

Control
To store layout information for the C1Sizer control, use the GridDefinition property that gets or
sets a string containing the grid information. This property is non-browsable, but can be used
as any other property.
This example assumes that you have imported the C1.Win.C1Sizer and System.Collections
namespaces to your source code. To implement two buttons that save and restore the grid
definition and control positions, use the following code:
Visual Basic
Copy Code
Private _gridDefinition As String

Private _ctlPositions As ArrayList
Private Sub btnSaveGrid_Click(ByVal sender As Object, ByVal e As
System.EventArgs)
_gridDefinition = C1Sizer1.GridDefinition
_ctlPositions = New ArrayList
43
For Each ctl As Control In C1Sizer1.Controls

_ctlPositions.Add(ctl.Bounds)
Next
End Sub
Private Sub btnRestoreGrid_Click(ByVal sender As Object, ByVal e As
System.EventArgs)
If Not (_gridDefinition Is Nothing) Then
c1Sizer1.GridDefinition = _gridDefinition
Dim i As Integer = 0
While i < c1Sizer1.Controls.Count
c1Sizer1.Controls(i).Bounds = CType(_ctlPositions(i), Rectangle)
System.Math.Min(System.Threading.Interlocked.Increment(i),i-1)
End While
End If
End Sub
To write code in C#
C#
Copy Code
string _gridDefinition;
ArrayList _ctlPositions;
private void btnSaveGrid_Click(object sender, System.EventArgs e)
{
// Save grid definition
_gridDefinition = c1Sizer1.GridDefinition;
// Save control positions
_ctlPositions = new ArrayList();
foreach (Control ctl in c1Sizer1.Controls)
{
_ctlPositions.Add(ctl.Bounds);
}
}
private void btnRestoreGrid_Click(object sender, System.EventArgs e)
{
if (_gridDefinition != null)
{
// Restore grid definition
c1Sizer1.GridDefinition = _gridDefinition;
// Restore control positions
for (int i = 0; i < c1Sizer1.Controls.Count; i++)
44
{
c1Sizer1.Controls[i].Bounds =
(Rectangle)_ctlPositions[i];
}
}
}
API Reference
The following topics contain the API reference for Sizer for WinForms.
See Also
C1.Win.C1Sizer.4 Assembly
Namespaces
C1.Win.C1Sizer Namespace
Overview
Classes
Class
Description
Band
Abstract class that serves as a base for the Row and Column classes.
BandCollection
Abstract class that serves as a base for the RowCollection and

ColumnCollection classes.
Border
Class that implements rounded borders and exposes properties that

control the appearance of the border.
C1Sizer
A container control with a powerful grid layout manager that

extends the basic layout capabilities provided by the .NET
45
framework (Dock and Anchor properties).

C1SizerEventArgs
Provides data for the C1Sizer.SplitterMoving and

C1Sizer.SplitterMoved events of a C1Sizer control.
C1SizerLight
Component that resizes all controls on a form when the form is

resized.
C1SizerLightEventArgs Provides data for the C1SizerLight.ResizingFont event of a

C1SizerLight component.
Column
Represents a column in the Sizer grid.
ColumnCollection
Collection of Column objects.
Gradient
Class that implements gradient backgrounds and exposes

properties that control the appearance of the gradient.
Grid
Summary description for Grid.
Row
Represents a row in the Sizer grid.
RowCollection
Collection of Row objects.
Strings
Static class containing UI strings.
Strings.BlendErrors
Structures
Structure
Description
Corners
Represents corners associated with a user interface (UI) element.
Delegates
Delegate
Description
46
C1SizerEventHandler
Represents the methods that will handle the

C1Sizer.SplitterMoving and C1Sizer.SplitterMoved events of a
C1Sizer control.
C1SizerLightEventHandler Represents the method that will handle the

C1SizerLight.ResizingFont and C1SizerLight.ResizingControl
events of a C1SizerLight component.
Enumerations
Enumeration
Description
AutoSizeEnum
Represents the possible sizing modes.
GradientMode
ImageAlignment Specifies the image alignment.

ImageScaling
Specifies the image scaling.
See Also
Reference
Classes
Band
Object Model
Syntax
Visual Basic (Declaration)
Public MustInherit Class Band
47
C#
public abstract class Band
Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Column
C1.Win.C1Sizer.Row
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server
2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or
later), Windows Server 2003 SP2
See Also
Reference
Band Members
Overview
Object Model
Syntax
Public MustInherit Class Band
C#
public abstract class Band
System.Object
C1.Win.C1Sizer.Band
48
C1.Win.C1Sizer.Row
Requirements
See Also
Reference
Band Members
Members
Properties
The following tables list the members exposed by Band.
Public Properties
Name
Description
Bounds
Gets a System.Drawing.Rectangle that represents the size and location of

the band within the parent C1Sizer control.
Index
Gets the index of the Band in the owner collection.
IsFixedSize
Determines whether the Band should retain its size when the control is
resized.
IsSplitter
Determines whether the band acts like a splitter (can be resized with the
mouse at run time).
Size
Gets or sets the size of this Band object.
Top
See Also
Reference
49
Band Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Band members.
Public Properties
Name
Description
Bounds

the band within the parent C1Sizer control.
Index
IsFixedSize
resized.
IsSplitter
mouse at run time).
Size
Top
See Also
Reference
Band Class
Bounds Property
Gets a System.Drawing.Rectangle that represents the size and location of the band within the
parent C1Sizer control.
Syntax
50
Public ReadOnly Property Bounds As Rectangle

C#
public Rectangle Bounds {get;}
Remarks
You can use the Bounds property to determine the position of specific grid cells. For example,
the code below moves a button control into cell 1,1 of the layout grid: Rectangle bounds =
Rectangle.Intersect(g.Rows[1].Bounds, g.Columns[1].Bounds);
button1.Bounds = bounds;
Requirements
See Also
Reference
Band Class
Band Members
Index Property
Syntax
Public ReadOnly Property Index As Integer
C#
public int Index {get;}
Requirements
See Also
Reference
51
Band Class
Band Members
IsFixedSize Property
Determines whether the Band should retain its size when the control is resized.
Syntax
Public Property IsFixedSize As Boolean
C#
public bool IsFixedSize {get; set;}
Remarks
When the control is resized, it updates the layout grid so it always fills the control's client area.
Normally, this is done by scaling every band and keeping their proportion constant.
In some cases, however, you may want to keep the size of a band constant, and let the other
bands shrink or expand to accommodate the new control dimensions. For example, you may
have a row that contains constant-size headings, and should not be resized with the control. In
these cases, set the IsFixedSize property to true and the band will not be resized when the
control dimensions change.
The IsFixedSize property prevents the control from resizing the band when the control is
resized. It does not prevent the user from resizing the band with the mouse if the IsSplitter
property is set to true.
Requirements
See Also
Reference
Band Class
Band Members
IsSplitter Property
Determines whether the band acts like a splitter (can be resized with the mouse at run time).
52
Syntax
Public Property IsSplitter As Boolean
C#
public bool IsSplitter {get; set;}
Remarks
The IsSplitter property controls the splitter bar below each row and to the right of each column.
IsSplitter has no effect on the last band in a collection, because the last band always ends at the
edge of the control and thus cannot be resized with the mouse.
Requirements
See Also
Reference
Band Class
Band Members
Size Property
Syntax
Public MustOverride Property Size As Integer
C#
public abstract int Size {get; set;}
Remarks
If the Band is a Row object, the size represents the row height in pixels.
If the Band is a Column object, the size represents the column width in pixels.
53
Requirements
See Also
Reference
Band Class
Band Members
BandCollection
Abstract class that serves as a base for the RowCollection and ColumnCollection classes.
Object Model
Syntax
Public MustInherit Class BandCollection
C#
public abstract class BandCollection
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.ColumnCollection
C1.Win.C1Sizer.RowCollection
Requirements
See Also
Reference
54
BandCollection Members
Overview
Abstract class that serves as a base for the RowCollection and ColumnCollection classes.
Object Model
Syntax
Public MustInherit Class BandCollection
C#
public abstract class BandCollection
System.Object
Requirements
See Also
Reference
Members
Properties Methods
The following tables list the members exposed by BandCollection.
Public Properties
55
Name
Description
Count
Gets or sets the number of bands in the collection.
Top
Public Methods
Name
Description
Insert
Inserts a new Band at a specified position in the collection.
Remove
Removes a Band from the collection.
SetSizes
Sets the size of multiple bands in the collection.
Top
See Also
Reference
BandCollection Class
Methods
%%scrap%%
" -->
For a list of all members of this type, see BandCollection members.
Public Methods
Name
Description
Insert
Remove
SetSizes
Top
56
See Also
Reference
Insert Method
Position where the new band will be inserted.
Syntax
Public Sub Insert( _
ByVal index As Integer _
)
C#
public void Insert(
int index
)
Parameters
index
Position where the new band will be inserted.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows
Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported
with SP1 or later), Windows Server 2003 SP2
See Also
Reference
Remove Method
Index of the band that will be removed from the collection.
57
Syntax
Public Sub Remove( _
)
C#
public void Remove(
int index
)
Parameters
index
Index of the band that will be removed from the collection.
Requirements
See Also
Reference
SetSizes Method
A vector containing the new sizes for each band in the collection.
Syntax
Public Sub SetSizes( _
ByVal sizes() As Integer _
)
58
C#
public void SetSizes(
int[] sizes
)
Parameters
sizes
A vector containing the new sizes for each band in the collection.
Remarks
You can set the size of a Band object by setting its Band.Size property. However, this will
cause other bands to resize immediately, so the collection always fills the client area of the
C1Sizer control.
This method allows you to set the size of multiple bands simultaneously, with a single call.
Any negative dimensions in the sizes array will be ignored, and the corresponding bands
will retain their current dimension.
Requirements
See Also
Reference
Properties
%%scrap%%
" -->
For a list of all members of this type, see BandCollection members.
Public Properties
Name
Description
59
Count
Top
See Also
Reference
Count Property
Syntax
Public Property Count As Integer
C#
public int Count {get; set;}
Requirements
See Also
Reference
Border
Class that implements rounded borders and exposes properties that control the appearance of
the border.
Object Model
Syntax
60

Public Class Border
C#
public class Border
System.Object
C1.Win.C1Sizer.Border
Requirements
See Also
Reference
Border Members
Overview
Class that implements rounded borders and exposes properties that control the appearance of
the border.
Object Model
Syntax
Public Class Border
C#
public class Border
61
System.Object
C1.Win.C1Sizer.Border
Requirements
See Also
Reference
Border Members
Members
Properties
The following tables list the members exposed by Border.
Public Properties
Name
Description
Color
Gets or sets the Color used to draw the border around the control.
Corners
Gets or sets the radii of the control corners.
Thickness
Gets or sets the thickness of the border around the control.
Top
See Also
Reference
Border Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Border members.
62
Public Properties
Name
Description
Color
Corners
Thickness
Top
See Also
Reference
Border Class
Color Property
Syntax
Public Property Color As Color
C#
public Color Color {get; set;}
Requirements
See Also
Reference
Border Class
Border Members
63
Corners Property
Syntax
Public Property Corners As Corners
C#
public Corners Corners {get; set;}
Requirements
See Also
Reference
Border Class
Border Members
Thickness Property
Syntax
Public Property Thickness As Padding
C#
public Padding Thickness {get; set;}
Requirements
See Also
64
Reference
Border Class
Border Members
C1Sizer
A container control with a powerful grid layout manager that extends the basic layout
capabilities provided by the .NET framework (Dock and Anchor properties).
Object Model
Syntax
Public Class C1Sizer
Inherits System.Windows.Forms.Control
C#
public class C1Sizer : System.Windows.Forms.Control
Remarks
The C1Sizer control allows you to define a grid made up of bands, then add controls that snap
to these bands. When the C1Sizer control is resized, the bands are automatically recalculated,
and contained controls move automatically to their new positions.
You can set up bands at design time and configure them to act as splitters or to keep their size
constant when the control is resized.
You will rarely have to write any code in order to use the C1Sizer component. In most
applications, you will follow these steps:
1) Add one or more C1Sizer controls to the form, and set their Dock property to fill the form,
2) Use the Grid Editor to set up a grid layout at design time, and add controls which will snap to
the grid.
You can use the Grid Editor to set the number and dimension of the grid's bands (rows and
columns), and also to specify which bands should act as splitters, and which should have fixed
dimensions.
65
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1Sizer.C1Sizer
Requirements
See Also
Reference
C1Sizer Members
Overview
A container control with a powerful grid layout manager that extends the basic layout
capabilities provided by the .NET framework (Dock and Anchor properties).
Object Model
Syntax
Public Class C1Sizer
Inherits System.Windows.Forms.Control
C#
public class C1Sizer : System.Windows.Forms.Control
Remarks
The C1Sizer control allows you to define a grid made up of bands, then add controls that snap
to these bands. When the C1Sizer control is resized, the bands are automatically recalculated,
and contained controls move automatically to their new positions.
You can set up bands at design time and configure them to act as splitters or to keep their size
constant when the control is resized.
66
You will rarely have to write any code in order to use the C1Sizer component. In most
applications, you will follow these steps:
1) Add one or more C1Sizer controls to the form, and set their Dock property to fill the form,
2) Use the Grid Editor to set up a grid layout at design time, and add controls which will snap to
the grid.
You can use the Grid Editor to set the number and dimension of the grid's bands (rows and
columns), and also to specify which bands should act as splitters, and which should have fixed
dimensions.
System.Object
System.Windows.Forms.Control
C1.Win.C1Sizer.C1Sizer
Requirements
See Also
Reference
C1Sizer Members
Members
Properties Methods Events
The following tables list the members exposed by C1Sizer.
Public Constructors
Name
Description
C1Sizer Constructor Initializes a new instance of the C1Sizer control.

Top
Public Properties
67
Name
Description
AccessibilityObject
(Inherited from System.Windows.Forms.Control)
AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)

AccessibleDescription
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
AutoSizeMode
Gets or sets the layout mode for the C1Sizer control.
BackColor
Gets or sets the System.Drawing.Color used to paint

the background.
BackgroundImage
BackgroundImageLayout
BindingContext
Border
Gets the Border object that controls border thickness,

color, and corner radii.
Bottom
Bounds
CanFocus
68
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CompanyName
Container
(Inherited from System.ComponentModel.Component)
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
Overridden. Gets or sets the cursor that is displayed

when the mouse pointer is over the control.
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
Focused
69
Gradient
Gets the Gradient object that controls gradient color,

mode, blend, and gamma correction.
Grid
Returns a reference to a Grid object that contains the

layout information for the C1Sizer control.
Handle
HasChildren
Height
Image
Gets or sets the image displayed in the control.
ImageAlignment
Gets or sets the alignment used to render the image.
ImageScaling
Gets or sets the scaling used to render the image.
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
70
MaximumSize
MinimumSize
Name
Padding
Gets or sets the padding between the control border

and its content.
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
Site
Size
SplitterWidth
Gets or sets the width of the area between grid bands,

in pixels.
TabIndex
TabStop
Tag
71
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
Public Methods
Name
Description
AddControl
Overloaded. Adds a child control to the C1Sizer and positions it

at a given cell on the grid.
BeginInvoke
Overloaded. (Inherited from System.Windows.Forms.Control)
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
(Inherited from System.MarshalByRefObject)
Dispose
DoDragDrop
DrawToBitmap
72
EndInvoke
FindForm
Focus
GetCellAtPoint
Overloaded. Gets the cell at a given point on the control's

client area.
GetCellBounds
Overloaded. Gets the bounds of a cell range within the grid.
GetChildAtPoint
GetContainerControl
GetControlAtCell
Gets the first control at a given grid cell.
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
PreProcessControlMessage (Inherited from System.Windows.Forms.Control)
73
PreProcessMessage
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Overloaded. Resumes normal layout logic.
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
Temporarily suspends the layout logic for the control.
ToString
Update
Top
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
74
BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)

BindingContextChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
75
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
HandleCreated
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
76
MouseClick
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
77
SizeChanged
SplitterMoved
Fired when the user finishes resizing a band (row or

column) by dragging a splitter bar.
SplitterMoving
Fired when the user clicks a splitter and starts resizing a

band (row or column) on the layout grid.
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextChanged
Validated
Validating
VisibleChanged
Top
See Also
Reference
C1Sizer Class
C1Sizer Constructor
Initializes a new instance of the C1Sizer control.
Syntax
Public Function New()
78
C#
public C1Sizer()
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Methods
%%scrap%%
" -->
For a list of all members of this type, see C1Sizer members.
Public Methods
Name
Description
AddControl
Overloaded. Adds a child control to the C1Sizer and positions it

BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
79
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetCellAtPoint
Overloaded. Gets the cell at a given point on the control's

client area.
GetCellBounds
Overloaded. Gets the bounds of a cell range within the grid.
GetChildAtPoint
GetContainerControl
GetControlAtCell
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
80
PointToClient
PointToScreen
PreProcessControlMessage (Inherited from System.Windows.Forms.Control)

PreProcessMessage
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Overloaded. Resumes normal layout logic.
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
Top
See Also
81
Reference
C1Sizer Class
AddControl Method
Adds a child control to the C1Sizer and positions it at a given cell on the grid.
Overload List
Overload
Description
AddControl(Control,Int32,Int32,Int32,Int32) Adds a child control to the C1Sizer and positions it

AddControl(Control,Int32,Int32)
Adds a child control to the C1Sizer and positions it

Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
AddControl(Control,Int32,Int32,Int32,Int32) Method
Child System.Windows.Forms.Control to add.
Index of the row where the child control will be positioned.
Index of the column where the child control will be positioned.
Number of rows the child control should span.
Number of columns the child control should span.
Syntax
82

Public Overloads Sub AddControl( _
ByVal ctl As Control, _
ByVal row As Integer, _
ByVal col As Integer, _
ByVal rowSpan As Integer, _
ByVal colSpan As Integer _
)
C#
public void AddControl(
Control ctl,
int row,
int col,
int rowSpan,
int colSpan
)
Parameters
ctl
row
col
rowSpan
Number of rows the child control should span.
colSpan
Number of columns the child control should span.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows
XP SP3, Windows Server 2008 (Server Core not supported), Windows
Server 2008 R2 (Server Core supported with SP1 or later), Windows
Server 2003 SP2
83
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
AddControl(Control,Int32,Int32) Method
Syntax
Public Overloads Sub AddControl( _
ByVal ctl As Control, _
ByVal col As Integer _
)
C#
public void AddControl(
Control ctl,
int row,
int col
)
Parameters
ctl
row
col
84
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3,
Windows Server 2008 (Server Core not supported), Windows Server 2008 R2
(Server Core supported with SP1 or later), Windows Server 2003 SP2
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetCellAtPoint Method
Gets the cell at a given point on the control's client area.
Overload List
Overload
Description
GetCellAtPoint(Point)
GetCellAtPoint(Int32,Int32) Gets the cell at a given point on the control's client area.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
GetCellAtPoint(Point) Method
System.Drawing.Point that specifies the cell position.
Syntax
85

Public Overloads Function GetCellAtPoint( _
ByVal pt As Point _
) As Point
C#
public Point GetCellAtPoint(
Point pt
)
Parameters
pt
System.Drawing.Point that specifies the cell position.
Return Value
A System.Drawing.Point where the X and Y properties correspond to the column row
indices of the cell at the given point.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetCellAtPoint(Int32,Int32) Method
X coordinate of the point.
Y coordinate of the point.
Syntax
86
Public Overloads Function GetCellAtPoint( _

ByVal x As Integer, _
ByVal y As Integer _
) As Point
C#
public Point GetCellAtPoint(
int x,
int y
)
Parameters
x
X coordinate of the point.
y
Y coordinate of the point.
Return Value
A System.Drawing.Point where the X and Y properties correspond to the column row
indices of the cell at the given point.
Requirements
Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server
Core supported with SP1 or later), Windows Server 2003 SP2
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetCellBounds Method
Gets the bounds of a cell range within the grid.
Overload List
Overload
Description
87
GetCellBounds(Int32,Int32,Int32,Int32) Gets the bounds of a cell range within the grid.

GetCellBounds(Int32,Int32)
Gets the bounds of a cell within the grid.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
GetCellBounds(Int32,Int32,Int32,Int32) Method
Index of the first row in the range.
Index of the first column in the range.
Number or rows in the range.
Number or columns in the range.
Gets the bounds of a cell range within the grid.
Syntax
Public Overloads Function GetCellBounds( _
ByVal col As Integer, _
ByVal rowSpan As Integer, _
ByVal colSpan As Integer _
) As Rectangle
C#
public Rectangle GetCellBounds(
int row,
int col,
int rowSpan,
int colSpan
88
Parameters
row
Index of the first row in the range.
col
Index of the first column in the range.
rowSpan
Number or rows in the range.
colSpan
Number or columns in the range.
Return Value
A System.Drawing.Rectangle that contains the bounds of the cell range.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP
SP3, Windows Server 2008 (Server Core not supported), Windows Server
2008 R2 (Server Core supported with SP1 or later), Windows Server 2003
SP2
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetCellBounds(Int32,Int32) Method
Index of the row that contains the cell.
Index of the column that contains the cell.
Gets the bounds of a cell within the grid.
Syntax
89
Public Overloads Function GetCellBounds( _

) As Rectangle
C#
public Rectangle GetCellBounds(
int row,
int col
)
Parameters
row
col
Return Value
A System.Drawing.Rectangle that contains the bounds of the cell.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetControlAtCell Method
Syntax
90

Public Function GetControlAtCell( _
) As Control
C#
public Control GetControlAtCell(
int row,
int col
)
Parameters
row
col
Return Value
The first control at the cell, or null if the cell is empty.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
ResumeLayout Method
Resumes normal layout logic.
Overload List
Overload
Description
91
ResumeLayout()
ResumeLayout(Boolean) Resumes normal layout logic. Optionally forces an immediate layout

of pending layout requests.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
ResumeLayout() Method
Syntax
Public Overloads Shadows Sub ResumeLayout()
C#
public new void ResumeLayout()
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
92
ResumeLayout(Boolean) Method
True to execute pending layout requests; otherwise, False.
Resumes normal layout logic. Optionally forces an immediate layout of pending layout requests.
Syntax
Public Overloads Shadows Sub ResumeLayout( _
ByVal performLayout As Boolean _
)
C#
public new void ResumeLayout(
bool performLayout
)
Parameters
performLayout
True to execute pending layout requests; otherwise, False.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
SuspendLayout Method
Syntax
Public Shadows Sub SuspendLayout()
93
C#
public new void SuspendLayout()
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Properties
%%scrap%%
" -->
Public Properties
Name
Description
AccessibilityObject
AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)

AccessibleDescription
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
94
AutoSizeMode
BackColor
Gets or sets the System.Drawing.Color used to paint

the background.
BackgroundImage
BackgroundImageLayout
BindingContext
Border
Gets the Border object that controls border thickness,

color, and corner radii.
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CompanyName
Container
ContainsFocus
ContextMenu
95
ContextMenuStrip
Controls
Created
Cursor
Overridden. Gets or sets the cursor that is displayed

when the mouse pointer is over the control.
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
Focused
Gradient
Gets the Gradient object that controls gradient color,

mode, blend, and gamma correction.
Grid
Returns a reference to a Grid object that contains the

layout information for the C1Sizer control.
Handle
HasChildren
Height
Image
ImageAlignment
ImageScaling
96
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Gets or sets the padding between the control border

and its content.
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
97
Region
Right
RightToLeft
Site
Size
SplitterWidth
Gets or sets the width of the area between grid bands,

in pixels.
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
See Also
Reference
C1Sizer Class
98
AutoSizeMode Property
Syntax
Public Property AutoSizeMode As AutoSizeEnum
C#
public AutoSizeEnum AutoSizeMode {get; set;}
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
BackColor Property
Gets or sets the System.Drawing.Color used to paint the background.
Syntax
Public Shadows Property BackColor As Color
C#
public new Color BackColor {get; set;}
Requirements
See Also
99
Reference
C1Sizer Class
C1Sizer Members
Border Property
Gets the Border object that controls border thickness, color, and corner radii.
Syntax
Public ReadOnly Property Border As Border
C#
public Border Border {get;}
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Cursor Property
Gets or sets the cursor that is displayed when the mouse pointer is over the control.
Syntax
Public Overrides Property Cursor As Cursor
C#
public override Cursor Cursor {get; set;}
Requirements
100
See Also
Reference
C1Sizer Class
C1Sizer Members
Gradient Property
Gets the Gradient object that controls gradient color, mode, blend, and gamma correction.
Syntax
Public ReadOnly Property Gradient As Gradient
C#
public Gradient Gradient {get;}
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Grid Property
Returns a reference to a Grid object that contains the layout information for the C1Sizer control.
Syntax
Public ReadOnly Property Grid As Grid
101
C#
public Grid Grid {get;}
Remarks
The Grid object contains collections of bands (Row and Column objects) that determine how
the control adjusts its internal layout when it is resized.
All controls contained in a C1Sizer control are attached to specific bands in the Grid object.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Image Property
Syntax
Public Property Image As Image
C#
public Image Image {get; set;}
Requirements
See Also
Reference
102
C1Sizer Class
C1Sizer Members
ImageAlignment Property
Syntax
Public Property ImageAlignment As ImageAlignment
C#
public ImageAlignment ImageAlignment {get; set;}
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
ImageScaling Property
Syntax
Public Property ImageScaling As ImageScaling
C#
public ImageScaling ImageScaling {get; set;}
Requirements
103
See Also
Reference
C1Sizer Class
C1Sizer Members
Padding Property
Gets or sets the padding between the control border and its content.
Syntax
Public Shadows Property Padding As Padding
C#
public new Padding Padding {get; set;}
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
SplitterWidth Property
Gets or sets the width of the area between grid bands, in pixels.
Syntax
Public Property SplitterWidth As Integer
C#
public int SplitterWidth {get; set;}
Remarks
104
The splitter width determines the area between adjacent controls contained in the C1Sizer
control.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
Events
%%scrap%%
" -->
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)

BindingContextChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
105
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
HandleCreated
106
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
MouseClick
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
107
MouseMove
MouseUp
MouseWheel
Move
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
SizeChanged
SplitterMoved
Fired when the user finishes resizing a band (row or

column) by dragging a splitter bar.
SplitterMoving
Fired when the user clicks a splitter and starts resizing a

band (row or column) on the layout grid.
StyleChanged
SystemColorsChanged
108
TabIndexChanged
TabStopChanged
TextChanged
Validated
Validating
VisibleChanged
Top
See Also
Reference
C1Sizer Class
SplitterMoved Event
Fired when the user finishes resizing a band (row or column) by dragging a splitter bar.
Syntax
Public Event SplitterMoved As C1SizerEventHandler
C#
public event C1SizerEventHandler SplitterMoved
Event Data
The event handler receives an argument of type C1SizerEventArgs containing data related to
this event. The following C1SizerEventArgs properties provide information specific to this
event.
Property
Description
Band
Gets a reference to the band (row or column) that caused the event.
109
Gets the X coordinate of the mouse when the event is fired.
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
SplitterMoving Event
Fired when the user clicks a splitter and starts resizing a band (row or column) on the layout
grid.
Syntax
Public Event SplitterMoving As C1SizerEventHandler
C#
public event C1SizerEventHandler SplitterMoving
Event Data
The event handler receives an argument of type C1SizerEventArgs containing data related to
this event. The following C1SizerEventArgs properties provide information specific to this
event.
Property
Description
Band
110
Requirements
See Also
Reference
C1Sizer Class
C1Sizer Members
C1SizerEventArgs
Provides data for the C1Sizer.SplitterMoving and C1Sizer.SplitterMoved events of a C1Sizer
control.
Object Model
Syntax
Public Class C1SizerEventArgs
Inherits System.EventArgs
C#
public class C1SizerEventArgs : System.EventArgs
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerEventArgs
Requirements
See Also
111
Reference
C1SizerEventArgs Members
Overview
Provides data for the C1Sizer.SplitterMoving and C1Sizer.SplitterMoved events of a C1Sizer
control.
Object Model
Syntax
Public Class C1SizerEventArgs
C#
public class C1SizerEventArgs : System.EventArgs
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerEventArgs
Requirements
See Also
Reference
Members
Properties
The following tables list the members exposed by C1SizerEventArgs.
112
Public Properties
Name
Description
Band
Top
See Also
Reference
C1SizerEventArgs Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see C1SizerEventArgs members.
Public Properties
Name
Description
Band
Top
See Also
Reference
113
Band Property
Syntax
Public ReadOnly Property Band As Band
C#
public Band Band {get;}
Requirements
See Also
Reference
X Property
Syntax
Public ReadOnly Property X As Integer
C#
public int X {get;}
Requirements
See Also
114
Reference
Y Property
Syntax
Public ReadOnly Property Y As Integer
C#
public int Y {get;}
Requirements
See Also
Reference
C1SizerLight
Component that resizes all controls on a form when the form is resized.
Object Model
Syntax
Public Class C1SizerLight
Inherits System.ComponentModel.Component
115
C#
public class C1SizerLight : System.ComponentModel.Component
Remarks
When you add a C1SizerLight component to a form, it keeps track of the forms' size and
position. When the form is resized, C1SizerLight resizes all contained controls proportionally, so
the form retains its appearance at any resolution.
You will rarely have to write any code in order to use the C1SizerLight component. In most
applications, you will simply design forms as usual, then add a C1SizerLight component to the
form and let it resize all controls on the form automatically, when the form is resized.
In some cases, you may want to control how fonts are resized when the form dimensions
change. You can prevent all font resizing by setting the ResizeFonts property to false. Or you
can keep the font size constant for certain controls by handling the ResizingFont event.
Note that the C1SizerLight component does not work at design time. This allows you to resize
your form without affecting the layout of the controls on the form.
System.Object
C1.Win.C1Sizer.C1SizerLight
Requirements
See Also
Reference
C1SizerLight Members
Overview
Component that resizes all controls on a form when the form is resized.
Object Model
116
Syntax
Public Class C1SizerLight
Inherits System.ComponentModel.Component
C#
public class C1SizerLight : System.ComponentModel.Component
Remarks
When you add a C1SizerLight component to a form, it keeps track of the forms' size and
position. When the form is resized, C1SizerLight resizes all contained controls proportionally, so
the form retains its appearance at any resolution.
You will rarely have to write any code in order to use the C1SizerLight component. In most
applications, you will simply design forms as usual, then add a C1SizerLight component to the
form and let it resize all controls on the form automatically, when the form is resized.
In some cases, you may want to control how fonts are resized when the form dimensions
change. You can prevent all font resizing by setting the ResizeFonts property to false. Or you
can keep the font size constant for certain controls by handling the ResizingFont event.
Note that the C1SizerLight component does not work at design time. This allows you to resize
your form without affecting the layout of the controls on the form.
System.Object
C1.Win.C1Sizer.C1SizerLight
Requirements
See Also
117
Reference
Members
Properties Methods Events
The following tables list the members exposed by C1SizerLight.
Public Constructors
Name
Description
C1SizerLight Constructor Overloaded.

Top
Public Properties
Name
Description
Container
Enabled
Determines whether the C1SizerLight should resize the controls on the

form when the form is resized.
ResizeFonts
Determines whether the C1SizerLight should resize control fonts in

addition to the controls themselves.
Site
Top
Public Methods
Name
Description
CreateObjRef
Dispose()
118
GetAutoResize
For internal use.
GetLifetimeService
InitializeLifetimeService (Inherited from System.MarshalByRefObject)

SetAutoResize
For internal use.
ToString
Top
Public Events
Name
Description
Disposed
ResizingControl Fires before the C1SizerLight resizes a control in response to the form
being resized.
ResizingFont
Fires before the C1SizerLight resizes the font in a control in response to

the form being resized.
Top
See Also
Reference
C1SizerLight Class
C1SizerLight Constructor
Overload List
Overload
Description
C1SizerLight Constructor(IContainer) Initializes a new instance of a C1SizerLight component in

a given System.ComponentModel.IContainer.
119
C1SizerLight Constructor()
Initializes a new instance of a C1SizerLight.
Requirements
See Also
Reference
C1SizerLight Class
C1SizerLight Constructor(IContainer)
The IContainer that contains the component.
Initializes a new instance of a C1SizerLight component in a given
System.ComponentModel.IContainer.
Syntax
Public Function New( _
ByVal container As IContainer _
)
C#
public C1SizerLight(
IContainer container
)
Parameters
container
The IContainer that contains the component.
Requirements
120
See Also
Reference
C1SizerLight Class
Overload List
C1SizerLight Constructor()
Initializes a new instance of a C1SizerLight.
Syntax
Public Function New()
C#
public C1SizerLight()
Requirements
See Also
Reference
C1SizerLight Class
Overload List
Methods
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLight members.
Public Methods
Name
Description
121
CreateObjRef
Dispose()
GetAutoResize
For internal use.
GetLifetimeService
InitializeLifetimeService (Inherited from System.MarshalByRefObject)

SetAutoResize
For internal use.
ToString
Top
See Also
Reference
C1SizerLight Class
GetAutoResize Method
For internal use.
Syntax
Public Function GetAutoResize( _
ByVal frm As Form _
) As Boolean
C#
public bool GetAutoResize(
Form frm
)
Parameters
frm
122
Requirements
See Also
Reference
C1SizerLight Class
SetAutoResize Method
For internal use.
Syntax
Public Sub SetAutoResize( _
ByVal frm As Form, _
ByVal value As Boolean _
)
C#
public void SetAutoResize(
Form frm,
bool value
)
Parameters
frm
value
Requirements
See Also
Reference
123
C1SizerLight Class
Properties
%%scrap%%
" -->
Public Properties
Name
Description
Container
Enabled
Determines whether the C1SizerLight should resize the controls on the

form when the form is resized.
ResizeFonts
Determines whether the C1SizerLight should resize control fonts in

addition to the controls themselves.
Site
Top
See Also
Reference
C1SizerLight Class
Enabled Property
Determines whether the C1SizerLight should resize the controls on the form when the form is
resized.
Syntax
Public Property Enabled As Boolean
C#
124
public bool Enabled {get; set;}
Remarks
This property has no effect at design time. Child controls are automatically resized at run time
only.
If you need to create controls at run time, you should set the Enabled property to false, create
the controls, then set it back to true. This will allow C1SizerLight to update its internal layout
information.
Requirements
See Also
Reference
C1SizerLight Class
ResizeFonts Property
Determines whether the C1SizerLight should resize control fonts in addition to the controls
themselves.
Syntax
Public Property ResizeFonts As Boolean
C#
public bool ResizeFonts {get; set;}
Requirements
See Also
Reference
125
C1SizerLight Class
Events
%%scrap%%
" -->
Public Events
Name
Description
Disposed
ResizingControl Fires before the C1SizerLight resizes a control in response to the form
being resized.
ResizingFont
Fires before the C1SizerLight resizes the font in a control in response to

the form being resized.
Top
See Also
Reference
C1SizerLight Class
ResizingControl Event
Fires before the C1SizerLight resizes a control in response to the form being resized.
Syntax
Public Event ResizingControl As C1SizerLightEventHandler
C#
public event C1SizerLightEventHandler ResizingControl
Event Data
126
The event handler receives an argument of type C1SizerLightEventArgs containing data related
to this event. The following C1SizerLightEventArgs properties provide information specific to
this event.
Property
Description
Cancel
Determines whether the font for this control should be resized.
Control
Gets a reference to the control whose font is about to be resized by the

Remarks
By default, C1SizerLight will resize all child controls on a form when the form is resized (except
controls that are docked or contained in a C1Sizer control).
In some cases, you may want to prevent the C1SizerLight from resizing certain controls on the
form. For example, you may have a an event handler that takes care of resizing specific controls
on the form using specialized logic.
Requirements
See Also
Reference
C1SizerLight Class
ResizingFont Event
Example
Fires before the C1SizerLight resizes the font in a control in response to the form being resized.
Syntax
Public Event ResizingFont As C1SizerLightEventHandler
C#
127
public event C1SizerLightEventHandler ResizingFont
Event Data
The event handler receives an argument of type C1SizerLightEventArgs containing data related
to this event. The following C1SizerLightEventArgs properties provide information specific to
this event.
Property
Description
Cancel
Control

Remarks
By default, C1SizerLight will resize all child controls on a form and will also update their fonts
when the form is resized.
In some cases, you may want to prevent the C1SizerLight from resizing the font for certain
controls on the form. For example, scrollable controls often don't need font resizing. When their
dimensions change, the user can still scroll to view their contents.
Example
For example, the code below prevents the C1SizerLight from resizing the font on any controls
that are not Buttons:
C#
void c1SizerLight1_ResizingFont(object sender, C1SizerLightEventArgs e)

{
if (!(e.Control is Button))
e.Cancel = true;
}
Requirements
See Also
Reference
128
C1SizerLight Class
C1SizerLightEventArgs
Provides data for the C1SizerLight.ResizingFont event of a C1SizerLight component.
Object Model
Syntax
Public Class C1SizerLightEventArgs
C#
public class C1SizerLightEventArgs : System.EventArgs
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerLightEventArgs
Requirements
See Also
Reference
C1SizerLightEventArgs Members
Overview
Provides data for the C1SizerLight.ResizingFont event of a C1SizerLight component.
Object Model
129
Syntax
Public Class C1SizerLightEventArgs
C#
public class C1SizerLightEventArgs : System.EventArgs
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerLightEventArgs
Requirements
See Also
Reference
Members
Properties
The following tables list the members exposed by C1SizerLightEventArgs.
Public Properties
Name
Description
Cancel
Control

Top
130
See Also
Reference
C1SizerLightEventArgs Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLightEventArgs members.
Public Properties
Name
Description
Cancel
Control

Top
See Also
Reference
Cancel Property
Syntax
Public Property Cancel As Boolean
C#
public bool Cancel {get; set;}
Requirements
131
See Also
Reference
Control Property
Gets a reference to the control whose font is about to be resized by the C1SizerLight
component.
Syntax
Public ReadOnly Property Control As Control
C#
public Control Control {get;}
Requirements
See Also
Reference
Column
Object Model
Syntax
132

Public Class Column
Inherits Band
C#
public class Column : Band
System.Object
C1.Win.C1Sizer.Band
Requirements
See Also
Reference
Column Members
Overview
Object Model
Syntax
Public Class Column
Inherits Band
C#
public class Column : Band
133
System.Object
C1.Win.C1Sizer.Band
Requirements
See Also
Reference
Column Members
Members
Properties Methods
The following tables list the members exposed by Column.
Public Properties
Name
Description
Bounds

the band within the parent C1Sizer control. (Inherited from
C1.Win.C1Sizer.Band)
Index
Gets the index of the Band in the owner collection. (Inherited from
IsFixedSize
resized. (Inherited from C1.Win.C1Sizer.Band)
IsSplitter
mouse at run time). (Inherited from C1.Win.C1Sizer.Band)
Size
Overridden. Gets or sets the width of the Column in pixels.
134
Top
Public Methods
Name
Description
ToString
Returns a string representation of the Column object.
Top
See Also
Reference
Column Class
Methods
%%scrap%%
" -->
For a list of all members of this type, see Column members.
Public Methods
Name
Description
ToString
Top
See Also
Reference
Column Class
ToString Method
Syntax
135
Public Overrides Function ToString() As String

C#
public override string ToString()
Return Value
A string representation of the Column object
Requirements
See Also
Reference
Column Class
Column Members
Properties
%%scrap%%
" -->
For a list of all members of this type, see Column members.
Public Properties
Name
Description
Bounds

Index
IsFixedSize
136
IsSplitter
Size
Overridden. Gets or sets the width of the Column in pixels.
Top
See Also
Reference
Column Class
Size Property
Gets or sets the width of the Column in pixels.
Syntax
Public Overrides Property Size As Integer
C#
public override int Size {get; set;}
Remarks
The Size property is updated whenever the control is resized, so that the columns take up the
entire width of the control.
You can prevent specific columns from being resized with the form by setting their
Band.IsFixedSize property. You can also set the size of multiple columns with a single call using
the BandCollection.SetSizes method in the ColumnCollection class.
When entering row heights or column widths into the PropertyGrid, you may also specify values
as percentages of the control size (e.g. "25%").
Requirements
See Also
137
Reference
Column Class
Column Members
ColumnCollection
Object Model
Syntax
Public Class ColumnCollection
Inherits BandCollection
C#
public class ColumnCollection : BandCollection
System.Object
Requirements
See Also
Reference
ColumnCollection Members
Overview
Object Model
138
Syntax
Public Class ColumnCollection
C#
public class ColumnCollection : BandCollection
System.Object
Requirements
See Also
Reference
Members
Properties Methods
The following tables list the members exposed by ColumnCollection.
Public Properties
Name
Description
Count
Gets or sets the number of bands in the collection. (Inherited from

C1.Win.C1Sizer.BandCollection)
139
Item
Gets the Column object at a given index in the collection.
Top
Public Methods
Name
Description
Insert
Inserts a new Band at a specified position in the collection. (Inherited

from C1.Win.C1Sizer.BandCollection)
Remove
Removes a Band from the collection. (Inherited from

SetSizes
Sets the size of multiple bands in the collection. (Inherited from

Top
See Also
Reference
ColumnCollection Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see ColumnCollection members.
Public Properties
Name
Description
Count

Item
Top
140
See Also
Reference
Item Property
Syntax
Public ReadOnly Default Property Item( _
) As Column
C#
public Column this[
int index
]; {get;}
Parameters
index
Requirements
See Also
Reference
Gradient
Class that implements gradient backgrounds and exposes properties that control the
appearance of the gradient.
Object Model
141
Syntax
Public Class Gradient
C#
public class Gradient
System.Object
C1.Win.C1Sizer.Gradient
Requirements
See Also
Reference
Gradient Members
Overview
Class that implements gradient backgrounds and exposes properties that control the
appearance of the gradient.
Object Model
Syntax
Public Class Gradient
C#
142
public class Gradient
System.Object
C1.Win.C1Sizer.Gradient
Requirements
See Also
Reference
Gradient Members
Members
Properties
The following tables list the members exposed by Gradient.
Public Properties
Name
Description
BackColor2

gradient.
Blend
Gets or sets the Blend used to paint the background gradient.
Center
Gets or sets the System.Drawing.Point that represents the center of a

radial gradient background in percentage units.
GammaCorrection Gets or sets whether to apply gamma correction to the background

gradient.
Mode
Gets or sets the GradientMode used to paint the background.
Top
143
See Also
Reference
Gradient Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Gradient members.
Public Properties
Name
Description
BackColor2

gradient.
Blend
Center
Gets or sets the System.Drawing.Point that represents the center of a

radial gradient background in percentage units.
GammaCorrection Gets or sets whether to apply gamma correction to the background

gradient.
Mode
Top
See Also
Reference
Gradient Class
BackColor2 Property
Gets or sets the secondary color used to build the background gradient.
Syntax
144

Public Property BackColor2 As Color
C#
public Color BackColor2 {get; set;}
Requirements
See Also
Reference
Gradient Class
Gradient Members
Blend Property
Syntax
Public Property Blend As Blend
C#
public Blend Blend {get; set;}
Requirements
See Also
Reference
Gradient Class
Gradient Members
145
Center Property
Gets or sets the System.Drawing.Point that represents the center of a radial gradient
background in percentage units.
Syntax
Public Property Center As Point
C#
public Point Center {get; set;}
Requirements
See Also
Reference
Gradient Class
Gradient Members
GammaCorrection Property
Gets or sets whether to apply gamma correction to the background gradient.
Syntax
Public Property GammaCorrection As Boolean
C#
public bool GammaCorrection {get; set;}
Requirements
See Also
146
Reference
Gradient Class
Gradient Members
Mode Property
Syntax
Public Property Mode As GradientMode
C#
public GradientMode Mode {get; set;}
Requirements
See Also
Reference
Gradient Class
Gradient Members
Grid
Object Model
Syntax
Public Class Grid
C#
147
public class Grid
System.Object
C1.Win.C1Sizer.Grid
Requirements
See Also
Reference
Grid Members
Overview
Object Model
Syntax
Public Class Grid
C#
public class Grid
System.Object
C1.Win.C1Sizer.Grid
Requirements
148
See Also
Reference
Grid Members
Members
Properties Methods
The following tables list the members exposed by Grid.
Public Properties
Name
Description
Columns
Gets a reference to the ColumnCollection that contains the columns in

the layout grid.
DraggingSplitter
Rows
Gets a reference to the RowCollection that contains the rows in the layout
grid.
SelectedObjects
Sizer
Gets a reference to the C1Sizer control that owns this Grid.
Top
Public Methods
Name
Description
AutoGenerate
Resets the Grid object and creates new rows and columns based on the
child controls within the C1Sizer.
Clear
Resets the Grid object so it contains one row and one column.
Top
See Also
149
Reference
Grid Class
Methods
%%scrap%%
" -->
For a list of all members of this type, see Grid members.
Public Methods
Name
Description
AutoGenerate
Resets the Grid object and creates new rows and columns based on the
child controls within the C1Sizer.
Clear
Top
See Also
Reference
Grid Class
AutoGenerate Method
Resets the Grid object and creates new rows and columns based on the child controls within the
C1Sizer.
Syntax
Public Sub AutoGenerate()
C#
public void AutoGenerate()
Remarks
150
You will rarely have to call this method from your code. It is more commonly used internally (at
design time) by the grid designer.
Requirements
See Also
Reference
Grid Class
Grid Members
Clear Method
Syntax
Public Sub Clear()
C#
public void Clear()
Requirements
See Also
Reference
Grid Class
Grid Members
Properties
%%scrap%%
" -->
For a list of all members of this type, see Grid members.
151
Public Properties
Name
Description
Columns
Gets a reference to the ColumnCollection that contains the columns in

the layout grid.
DraggingSplitter
Rows
Gets a reference to the RowCollection that contains the rows in the layout
grid.
SelectedObjects
Sizer
Top
See Also
Reference
Grid Class
Columns Property
Gets a reference to the ColumnCollection that contains the columns in the layout grid.
Syntax
Public ReadOnly Property Columns As ColumnCollection
C#
public ColumnCollection Columns {get;}
Requirements
152
See Also
Reference
Grid Class
Grid Members
DraggingSplitter Property
Syntax
Public ReadOnly Property DraggingSplitter As Splitter
C#
public Splitter DraggingSplitter {get;}
Requirements
See Also
Reference
Grid Class
Grid Members
Rows Property
Gets a reference to the RowCollection that contains the rows in the layout grid.
Syntax
Public ReadOnly Property Rows As RowCollection
C#
public RowCollection Rows {get;}
Requirements
153
See Also
Reference
Grid Class
Grid Members
SelectedObjects Property
Syntax
Public Property SelectedObjects As Object()
C#
public object[] SelectedObjects {get; set;}
Requirements
See Also
Reference
Grid Class
Grid Members
Sizer Property
Syntax
Public ReadOnly Property Sizer As C1Sizer
C#
public C1Sizer Sizer {get;}
154
Requirements
See Also
Reference
Grid Class
Grid Members
Row
Object Model
Syntax
Public Class Row
Inherits Band
C#
public class Row : Band
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Row
Requirements
See Also
Reference
155
Row Members
Overview
Object Model
Syntax
Public Class Row
Inherits Band
C#
public class Row : Band
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Row
Requirements
See Also
Reference
Row Members
Members
Properties Methods
The following tables list the members exposed by Row.
Public Properties
156
Name
Description
Bounds

Index
IsFixedSize
IsSplitter
Size
Overridden. Gets or sets the height of the Row in pixels.
Top
Public Methods
Name
Description
ToString
Returns a string representation of the Row object.
Top
See Also
Reference
Row Class
Methods
%%scrap%%
" -->
For a list of all members of this type, see Row members.
Public Methods
157
Name
Description
ToString
Top
See Also
Reference
Row Class
ToString Method
Syntax
Public Overrides Function ToString() As String
C#
public override string ToString()
Return Value
A string representation of the Row object
Requirements
See Also
Reference
Row Class
Row Members
Properties
%%scrap%%
" -->
158
For a list of all members of this type, see Row members.
Public Properties
Name
Description
Bounds

Index
IsFixedSize
IsSplitter
Size
Overridden. Gets or sets the height of the Row in pixels.
Top
See Also
Reference
Row Class
Size Property
Gets or sets the height of the Row in pixels.
Syntax
Public Overrides Property Size As Integer
C#
public override int Size {get; set;}
Remarks
159
The Size property is updated whenever the control is resized, so that the rows take up the entire
height of the control.
You can prevent specific rows from being resized with the form by setting their Band.IsFixedSize
property. You can also set the size of multiple rows with a single call using the
BandCollection.SetSizes method in the RowCollection class.
When entering row heights or column widths into the PropertyGrid, you may also specify values
as percentages of the control size (e.g. "25%").
Requirements
See Also
Reference
Row Class
Row Members
RowCollection
Object Model
Syntax
Public Class RowCollection
C#
public class RowCollection : BandCollection
System.Object
160
Requirements
See Also
Reference
RowCollection Members
Overview
Object Model
Syntax
Public Class RowCollection
C#
public class RowCollection : BandCollection
System.Object
Requirements
See Also
Reference
161
Members
Properties Methods
The following tables list the members exposed by RowCollection.
Public Properties
Name
Description
Count

Item
Gets the Row object at a given index in the collection.
Top
Public Methods
Name
Description
Insert
Inserts a new Band at a specified position in the collection. (Inherited

from C1.Win.C1Sizer.BandCollection)
Remove
Removes a Band from the collection. (Inherited from

SetSizes
Sets the size of multiple bands in the collection. (Inherited from

Top
See Also
Reference
RowCollection Class
Properties
%%scrap%%
162
" -->
For a list of all members of this type, see RowCollection members.
Public Properties
Name
Description
Count

Item
Top
See Also
Reference
RowCollection Class
Item Property
Syntax
Public ReadOnly Default Property Item( _
) As Row
C#
public Row this[
int index
]; {get;}
Parameters
index
Requirements
163
See Also
Reference
RowCollection Class
Strings
Object Model
Syntax
Public MustInherit NotInheritable Class Strings
C#
public static class Strings
System.Object
C1.Win.C1Sizer.Strings
Requirements
See Also
Reference
Strings Members
164
Overview
Object Model
Syntax
Public MustInherit NotInheritable Class Strings
C#
public static class Strings
System.Object
C1.Win.C1Sizer.Strings
Requirements
See Also
Reference
Strings Members
Members
Properties
The following tables list the members exposed by Strings.
Public Properties
Name
Description
CannotInsertBand
165
CannotRemoveBand
Column
ConfirmClearGrid
DesignTimeMessage
ResourceManager
Row
UICulture
Top
See Also
Reference
Strings Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Strings members.
Public Properties
Name
Description
CannotInsertBand
CannotRemoveBand
Column
ConfirmClearGrid
166
DesignTimeMessage
ResourceManager
Row
UICulture
Top
See Also
Reference
Strings Class
CannotInsertBand Property
Syntax
Public Shared ReadOnly Property CannotInsertBand As String
C#
public static string CannotInsertBand {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
CannotRemoveBand Property
Syntax
167

Public Shared ReadOnly Property CannotRemoveBand As String
C#
public static string CannotRemoveBand {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
Column Property
Syntax
Public Shared ReadOnly Property Column As String
C#
public static string Column {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
ConfirmClearGrid Property
Syntax
168

Public Shared ReadOnly Property ConfirmClearGrid As String
C#
public static string ConfirmClearGrid {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
DesignTimeMessage Property
Syntax
Public Shared ReadOnly Property DesignTimeMessage As String
C#
public static string DesignTimeMessage {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
ResourceManager Property
Syntax
169

Public Shared Property ResourceManager As ResourceManager
C#
public static ResourceManager ResourceManager {get; set;}
Requirements
See Also
Reference
Strings Class
Strings Members
Row Property
Syntax
Public Shared ReadOnly Property Row As String
C#
public static string Row {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
UICulture Property
Syntax
170

Public Shared ReadOnly Property UICulture As CultureInfo
C#
public static CultureInfo UICulture {get;}
Requirements
See Also
Reference
Strings Class
Strings Members
Strings.BlendErrors
Object Model
Syntax
Public MustInherit NotInheritable Class Strings.BlendErrors
C#
public static class Strings.BlendErrors
System.Object
C1.Win.C1Sizer.Strings.BlendErrors
Requirements
171
See Also
Reference
Strings.BlendErrors Members
Overview
Object Model
Syntax
Public MustInherit NotInheritable Class Strings.BlendErrors
C#
public static class Strings.BlendErrors
System.Object
C1.Win.C1Sizer.Strings.BlendErrors
Requirements
See Also
Reference
Members
Properties
The following tables list the members exposed by Strings.BlendErrors.
Public Properties
172
Name
Description
BadFormat
BadPosition
BadPositionOrFactor
CannotParseFloats
NonAscendingPositions
Top
See Also
Reference
Strings.BlendErrors Class
Properties
%%scrap%%
" -->
For a list of all members of this type, see Strings.BlendErrors members.
Public Properties
Name
Description
BadFormat
BadPosition
BadPositionOrFactor
CannotParseFloats
NonAscendingPositions
Top
173
See Also
Reference
BadFormat Property
Syntax
Public Shared ReadOnly Property BadFormat As String
C#
public static string BadFormat {get;}
Requirements
See Also
Reference
BadPosition Property
Syntax
Public Shared ReadOnly Property BadPosition As String
C#
public static string BadPosition {get;}
Requirements
174
See Also
Reference
BadPositionOrFactor Property
Syntax
Public Shared ReadOnly Property BadPositionOrFactor As String
C#
public static string BadPositionOrFactor {get;}
Requirements
See Also
Reference
CannotParseFloats Property
Syntax
Public Shared ReadOnly Property CannotParseFloats As String
C#
public static string CannotParseFloats {get;}
Requirements
175
See Also
Reference
NonAscendingPositions Property
Syntax
Public Shared ReadOnly Property NonAscendingPositions As String
C#
public static string NonAscendingPositions {get;}
Requirements
See Also
Reference
Enumerations
AutoSizeEnum
Represents the possible sizing modes.
Syntax
Public Enum AutoSizeEnum
Inherits System.Enum
C#
176
public enum AutoSizeEnum : System.Enum
Members
Member
Description
Grid
Size child controls to snap to the sizer's Grid.
None
No resizing.
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.AutoSizeEnum
Requirements
See Also
Reference
GradientMode
Syntax
Public Enum GradientMode
C#
public enum GradientMode : System.Enum
Members
177
Member
Description
DiagonalDown
Diagonal gradient (from BackColor on the left-top to BackColor2 on the

right-bottom).
DiagonalUp
Diagonal gradient (from BackColor on the left-bottom to BackColor2 on the

right-top).
Horizontal
Horizontal gradient (from BackColor on the left to BackColor2 on the right).
None
No gradient.
Radial
Radial gradient (from BackColor on the edges to BackColor2 on the center).
Vertical
Vertical gradient (from BackColor on the top to BackColor2 on the bottom).
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.GradientMode
Requirements
See Also
Reference
ImageAlignment
Specifies the image alignment.
Syntax
178
Public Enum ImageAlignment

C#
public enum ImageAlignment : System.Enum
Members
Member
Description
CenterBottom
Image is vertically aligned at the bottom and horizontally aligned at the

center.
CenterCenter
Image is vertically aligned in the middle and horizontally aligned at the

center.
CenterTop
Image is vertically aligned at the top and horizontally aligned at the center.
LeftBottom
Image is vertically aligned at the bottom and horizontally aligned on the left.
LeftCenter
Image is vertically aligned in the middle and horizontally aligned on the left.
LeftTop
Image is vertically aligned at the top and horizontally aligned on the left.
RightBottom
Image is vertically aligned at the bottom and horizontally aligned on the

right.
RightCenter
Image is vertically aligned in the middle and horizontally aligned on the

right.
RightTop
Image is vertically aligned at the top and horizontally aligned on the right.
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.ImageAlignment
Requirements
179
See Also
Reference
ImageScaling
Specifies the image scaling.
Syntax
Public Enum ImageScaling
C#
public enum ImageScaling : System.Enum
Members
Member
Description
Clip
Use the image's original size, clipping it to the display area if necessary.
Hide
Hide the image.
Scale
Scale the image to fit the display area. This mode may increase or
reduce the size of the image while maintaining its aspect ratio.
Stretch
Stretch the image to fill the display area. This mode will usually change
the image's aspect ratio.
Tile
Tile the image to fill the display area.
TileStretch
Tile the image into a 3x3 matrix and stretch it to fill the display area.
This mode preserves the size of the four corners of the image.
180
TileStretchHorizontal Tile the image into a row of 3 images and stretch it to fill the display
area. This mode preserves the size of the left and right parts of the
image.
TileStretchVertical
Tile the image into a column of 3 images and stretch it to fill the display
area. This mode preserves the size of the top and bottom parts of the
image.
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.ImageScaling
Requirements
See Also
Reference
Structures
Corners
Object Model
Syntax
Public Structure Corners
Inherits System.ValueType
181
C#
public struct Corners : System.ValueType
System.Object
System.ValueType
C1.Win.C1Sizer.Corners
Requirements
See Also
Reference
Corners Members
Overview
Object Model
Syntax
Public Structure Corners
Inherits System.ValueType
C#
public struct Corners : System.ValueType
System.Object
System.ValueType
C1.Win.C1Sizer.Corners
182
Requirements
See Also
Reference
Corners Members
Members
Properties Methods
The following tables list the members exposed by Corners.
Public Constructors
Name
Description
Corners Constructor Overloaded.

Top
Public Properties
Name
Description
Empty
Provides a Corners object with no thickness.
IsEmpty
Returns true if the Corners object is empty.
LeftBottom
Gets or sets the radius for the left bottom corner.
LeftTop
Gets or sets the radius for the left top corner.
RightBottom
Gets or sets the radius for the right bottom corner.
RightTop
Gets or sets the radius for the right top corner.
Top
183
Public Methods
Name
Description
Equals
Determines whether the value of the specified object is equivalent to the

current Corners.
GetHashCode
Generates a hash code for the current Corners.
Top
Public Operators
Equality
Tests whether two specified Corners objects are equivalent.
Implicit Type Conversion

Inequality
Tests whether two specified Corners objects are not equivalent.
Top
See Also
Reference
Corners Structure
Corners Constructor
Overload List
Overload
Description
Corners Constructor(Int32,Int32,Int32,Int32) Initializes a new instance of a Corners object.

Corners Constructor(Int32)
Initializes a new instance of a Corners object.
Requirements
184
See Also
Reference
Corners Structure
Corners Members
Corners Constructor(Int32,Int32,Int32,Int32)
Radius of the left top corner, in pixels.
Radius of the right top corner, in pixels.
Radius of the left bottom corner, in pixels.
Radius of the right bottom corner, in pixels.
Syntax
ByVal leftTop As Integer, _
ByVal rightTop As Integer, _
ByVal leftBottom As Integer, _
ByVal rightBottom As Integer _
)
C#
public Corners(
int leftTop,
int rightTop,
int leftBottom,
int rightBottom
)
Parameters
leftTop
Radius of the left top corner, in pixels.
rightTop
Radius of the right top corner, in pixels.
leftBottom
185
Radius of the left bottom corner, in pixels.

rightBottom
Radius of the right bottom corner, in pixels.
Requirements
Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP
SP3, Windows Server 2008 (Server Core not supported), Windows Server
2008 R2 (Server Core supported with SP1 or later), Windows Server 2003
SP2
See Also
Reference
Corners Structure
Corners Members
Overload List
Corners Constructor(Int32)
Radius of all corners, in pixels.
Syntax
ByVal radius As Integer _
)
C#
public Corners(
int radius
)
Parameters
radius
Radius of all corners, in pixels.
Requirements
186
See Also
Reference
Corners Structure
Corners Members
Overload List
Methods
%%scrap%%
" -->
For a list of all members of this type, see Corners members.
Public Methods
Name
Description
Equals
Determines whether the value of the specified object is equivalent to the

current Corners.
GetHashCode
Top
See Also
Reference
Corners Structure
Equals Method
The object to compare to the current Corners.
Determines whether the value of the specified object is equivalent to the current Corners.
Syntax
187
Public Overrides Function Equals( _

ByVal obj As Object _
) As Boolean
C#
public override bool Equals(
object obj
)
Parameters
obj
The object to compare to the current Corners.
Return Value
true if the two Corners objects are equal; otherwise, false.
Requirements
See Also
Reference
Corners Structure
Corners Members
GetHashCode Method
Syntax
Public Overrides Function GetHashCode() As Integer
C#
public override int GetHashCode()
Return Value
A 32-bit signed integer hash code.
188
Requirements
See Also
Reference
Corners Structure
Corners Members
Properties
%%scrap%%
" -->
For a list of all members of this type, see Corners members.
Public Properties
Name
Description
Empty
IsEmpty
LeftBottom
LeftTop
RightBottom
RightTop
Top
See Also
Reference
Corners Structure
189
Empty Property
Syntax
Public Shared ReadOnly Property Empty As Corners
C#
public static Corners Empty {get;}
Requirements
See Also
Reference
Corners Structure
Corners Members
IsEmpty Property
Syntax
Public ReadOnly Property IsEmpty As Boolean
C#
public bool IsEmpty {get;}
Requirements
See Also
190
Reference
Corners Structure
Corners Members
LeftBottom Property
Syntax
Public Property LeftBottom As Integer
C#
public int LeftBottom {get; set;}
Requirements
See Also
Reference
Corners Structure
Corners Members
LeftTop Property
Syntax
Public Property LeftTop As Integer
C#
public int LeftTop {get; set;}
Requirements
191
See Also
Reference
Corners Structure
Corners Members
RightBottom Property
Syntax
Public Property RightBottom As Integer
C#
public int RightBottom {get; set;}
Requirements
See Also
Reference
Corners Structure
Corners Members
RightTop Property
Syntax
Public Property RightTop As Integer
192
C#
public int RightTop {get; set;}
Requirements
See Also
Reference
Corners Structure
Corners Members
Operators
Equality Operator
A Corners to test.
A Corners to test.
Tests whether two specified Corners objects are equivalent.
Syntax
Public Operator =( _
ByVal c1 As Corners, _
ByVal c2 As Corners _
) As Boolean
C#
public bool operator ==(
Corners c1,
Corners c2
)
Parameters
c1
A Corners to test.
193
c2
A Corners to test.
Return Value
true if the two Corners objects are equal; otherwise, false.
Requirements
See Also
Reference
Corners Structure
Corners Members
Implicit Type Conversion Operator
Syntax
Public Operator Widening CType( _
ByVal radii As Integer _
) As Corners
C#
public Corners operator implicit(
int radii
)
Parameters
radii
Requirements
See Also
194
Reference
Corners Structure
Corners Members
Inequality Operator
A Corners to test.
A Corners to test.
Tests whether two specified Corners objects are not equivalent.
Syntax
Public Operator <>( _
ByVal c1 As Corners, _
ByVal c2 As Corners _
) As Boolean
C#
public bool operator !=(
Corners c1,
Corners c2
)
Parameters
c1
A Corners to test.
c2
A Corners to test.
Return Value
True if the two Corners objects are different; otherwise, false.
Requirements
See Also
195
Reference
Corners Structure
Corners Members
Delegates
C1SizerEventHandler
Represents the methods that will handle the C1Sizer.SplitterMoving and C1Sizer.SplitterMoved
events of a C1Sizer control.
Syntax
Public Delegate Sub C1SizerEventHandler( _
ByVal sender As Object, _
ByVal e As C1SizerEventArgs _
)
C#
public delegate void C1SizerEventHandler(
object sender,
C1SizerEventArgs e
)
Parameters
sender
e
Requirements
See Also
Reference
C1SizerEventHandler Members
196
C1SizerLightEventHandler
Represents the method that will handle the C1SizerLight.ResizingFont and
C1SizerLight.ResizingControl events of a C1SizerLight component.
Syntax
Public Delegate Sub C1SizerLightEventHandler( _
ByVal sender As Object, _
ByVal e As C1SizerLightEventArgs _
)
C#
public delegate void C1SizerLightEventHandler(
object sender,
C1SizerLightEventArgs e
)
Parameters
sender
e
Requirements
See Also
Reference
C1SizerLightEventHandler Members
197

WinForms Sizer

Uploaded by

Copyright:

Available Formats

WinForms Sizer

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

WinForms Sizer

Uploaded by

Copyright:

Available Formats

ComponentOne

Sizer for WinForms

Copyright 1987-2015 GrapeCity, Inc. All rights reserved.

ComponentOne, a division of GrapeCity

Copying and Distribution

Index Property ................................................................................................ 51

GetControlAtCell Method ............................................................................... 90

GetAutoResize Method ................................................................................. 122

Mode Property .............................................................................................. 147

ResourceManager Property .......................................................................... 169

Operators .......................................................................................................... 193

Sizer for WinForms Overview

Help with WinForms Edition

Migrating a C1Sizer Project to Visual

To convert the project:

Open Visual Studio 2005 and select File, Open Project.

Expand the References node, right-click C1.Win.C1Sizer and select Remove.

Right-click the References node and select Add Reference.

The migration process is complete.

Create a Gradient Background

Resize all Contained Controls Proportionally

C1Sizer Smart Tag

The C1Sizer Tasks menu operates as follows:

Dock in parent container

C1SizerLight Smart Tag

The C1SizerLight Tasks menu operates as follows:

C1Sizer Context Menus

C1Sizer Context Menu

number of C1Sizer and online resources.

Opens the C1Sizer Grid Editor.

Edit Gradient Opens the C1Sizer Gradient Editor.

Removes the bands from the grid.

C1SizerLight Context Menu

Right-click anywhere on the C1SizerLight component to display the C1SizerLight context

number of C1Sizer and online resources.

C1Sizer Grid Editor

To access the C1Sizer Grid Editor:

Inserts a new band at the selection.

Adds a new band to the collection.

Deletes the selected bands.

Makes all bands the same size.

Removes all bands.

Creates bands based on child control.

Updates the changes and closes the C1Sizer Grid Editor.

Gets or sets the row height or column width in pixels.

C1Sizer Gradient Editor

To access the C1Sizer Gradient Editor:

Gets or sets the Drawing.Color used to paint the background.

Gets or sets the secondary color used to build the background

Specifies the background gradient mode.

Gradient.GammaCorrection Gets or sets whether to apply gamma correction to the

Using the C1SizerLight Component

Quick Start Tutorial

If you make it bigger, you will see an empty gray area.

Select C1SizerLight in the Properties sheet.

Private Sub C1SizerLight1_ResizingFont(ByVal sender As Object, _

private void c1SizerLight1_ResizingFont(object sender,

Docked and Nested Controls

Using the C1Sizer Control