Vous êtes sur la page 1sur 199

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
C1SizerLight Smart Tag

C1SizerLight Smart Tag


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 Context Menus

C1Sizer Context Menus


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 Gradient Editor

C1Sizer Gradient Editor


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:
To write code in Visual Basic
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:
To write code in Visual Basic
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:
To write code in Visual Basic
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:
To write code in Visual Basic
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:
To write code in Visual Basic
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

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

Specifies the background gradient mode.

ImageAlignment Specifies the image alignment.


ImageScaling

Specifies the image scaling.

See Also
Reference
C1.Win.C1Sizer.4 Assembly

Classes
Band
Abstract class that serves as a base for the Row and Column classes.

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
C1.Win.C1Sizer Namespace

Overview
Abstract class that serves as a base for the Row and Column classes.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit Class Band
C#
public abstract class Band

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band

48

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
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see Band members.

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
Band Class
C1.Win.C1Sizer Namespace

Bounds Property
Gets a System.Drawing.Rectangle that represents the size and location of the band within the
parent C1Sizer control.

Syntax
Visual Basic (Declaration)

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
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 Class
Band Members

Index Property
Gets the index of the Band in the owner collection.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Index As Integer
C#
public int Index {get;}

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
51

Band Class
Band Members

IsFixedSize Property
Determines whether the Band should retain its size when the control is resized.

Syntax
Visual Basic (Declaration)
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
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 Class
Band Members

IsSplitter Property
Determines whether the band acts like a splitter (can be resized with the mouse at run time).

52

Syntax
Visual Basic (Declaration)
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
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 Class
Band Members

Size Property
Gets or sets the size of this Band object.

Syntax
Visual Basic (Declaration)
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
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 Class
Band Members

BandCollection
Abstract class that serves as a base for the RowCollection and ColumnCollection classes.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit Class BandCollection
C#
public abstract class BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.ColumnCollection
C1.Win.C1Sizer.RowCollection

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
54

BandCollection Members
C1.Win.C1Sizer Namespace

Overview
Abstract class that serves as a base for the RowCollection and ColumnCollection classes.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit Class BandCollection
C#
public abstract class BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.ColumnCollection
C1.Win.C1Sizer.RowCollection

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
BandCollection Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

Methods
%%scrap%%
" -->
For a list of all members of this type, see BandCollection members.

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

56

See Also
Reference
BandCollection Class
C1.Win.C1Sizer Namespace

Insert Method
Position where the new band will be inserted.
Inserts a new Band at a specified position in the collection.

Syntax
Visual Basic (Declaration)
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
BandCollection Class
BandCollection Members

Remove Method
Index of the band that will be removed from the collection.

57

Removes a Band from the collection.

Syntax
Visual Basic (Declaration)
Public Sub Remove( _
ByVal index As Integer _
)
C#
public void Remove(
int index
)

Parameters
index
Index of the band that will be removed from the collection.

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
BandCollection Class
BandCollection Members

SetSizes Method
A vector containing the new sizes for each band in the collection.
Sets the size of multiple bands in the collection.

Syntax
Visual Basic (Declaration)
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
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
BandCollection Class
BandCollection Members

Properties
%%scrap%%
" -->
For a list of all members of this type, see BandCollection members.

Public Properties
Name

Description

59

Count

Gets or sets the number of bands in the collection.

Top

See Also
Reference
BandCollection Class
C1.Win.C1Sizer Namespace

Count Property
Gets or sets the number of bands in the collection.

Syntax
Visual Basic (Declaration)
Public Property Count As Integer
C#
public int Count {get; set;}

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
BandCollection Class
BandCollection Members

Border
Class that implements rounded borders and exposes properties that control the appearance of
the border.

Object Model

Syntax
60

Visual Basic (Declaration)


Public Class Border
C#
public class Border

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Border

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
Border Members
C1.Win.C1Sizer Namespace

Overview
Class that implements rounded borders and exposes properties that control the appearance of
the border.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Border
C#
public class Border

Inheritance Hierarchy

61

System.Object
C1.Win.C1Sizer.Border

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
Border Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see Border members.

62

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
C1.Win.C1Sizer Namespace

Color Property
Gets or sets the Color used to draw the border around the control.

Syntax
Visual Basic (Declaration)
Public Property Color As Color
C#
public Color Color {get; set;}

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
Border Class
Border Members

63

Corners Property
Gets or sets the radii of the control corners.

Syntax
Visual Basic (Declaration)
Public Property Corners As Corners
C#
public Corners Corners {get; set;}

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
Border Class
Border Members

Thickness Property
Gets or sets the thickness of the border around the control.

Syntax
Visual Basic (Declaration)
Public Property Thickness As Padding
C#
public Padding Thickness {get; set;}

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

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
Visual Basic (Declaration)
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.

Inheritance Hierarchy

65

System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1Sizer.C1Sizer

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 Members
C1.Win.C1Sizer Namespace

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
Visual Basic (Declaration)
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.

Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
C1.Win.C1Sizer.C1Sizer

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 Members
C1.Win.C1Sizer Namespace

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

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BindingContext

(Inherited from System.Windows.Forms.Control)

Border

Gets the Border object that controls border thickness,


color, and corner radii.

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

68

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

Overridden. Gets or sets the cursor that is displayed


when the mouse pointer is over the control.

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

Focused

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

70

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

Gets or sets the padding between the control border


and its content.

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SplitterWidth

Gets or sets the width of the area between grid bands,


in pixels.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

71

Text

(Inherited from System.Windows.Forms.Control)

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

72

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

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

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetControlAtCell

Gets the first control at a given grid cell.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)

73

PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. Resumes normal layout logic.

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

Temporarily suspends the layout logic for the control.

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

Public Events
Name

Description

BackColorChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageChanged

(Inherited from System.Windows.Forms.Control)

74

BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)


BindingContextChanged

(Inherited from System.Windows.Forms.Control)

CausesValidationChanged

(Inherited from System.Windows.Forms.Control)

ChangeUICues

(Inherited from System.Windows.Forms.Control)

Click

(Inherited from System.Windows.Forms.Control)

ClientSizeChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuStripChanged

(Inherited from System.Windows.Forms.Control)

ControlAdded

(Inherited from System.Windows.Forms.Control)

ControlRemoved

(Inherited from System.Windows.Forms.Control)

CursorChanged

(Inherited from System.Windows.Forms.Control)

Disposed

(Inherited from System.ComponentModel.Component)

DockChanged

(Inherited from System.Windows.Forms.Control)

DoubleClick

(Inherited from System.Windows.Forms.Control)

DragDrop

(Inherited from System.Windows.Forms.Control)

DragEnter

(Inherited from System.Windows.Forms.Control)

DragLeave

(Inherited from System.Windows.Forms.Control)

DragOver

(Inherited from System.Windows.Forms.Control)

EnabledChanged

(Inherited from System.Windows.Forms.Control)

75

Enter

(Inherited from System.Windows.Forms.Control)

FontChanged

(Inherited from System.Windows.Forms.Control)

ForeColorChanged

(Inherited from System.Windows.Forms.Control)

GiveFeedback

(Inherited from System.Windows.Forms.Control)

GotFocus

(Inherited from System.Windows.Forms.Control)

HandleCreated

(Inherited from System.Windows.Forms.Control)

HandleDestroyed

(Inherited from System.Windows.Forms.Control)

HelpRequested

(Inherited from System.Windows.Forms.Control)

ImeModeChanged

(Inherited from System.Windows.Forms.Control)

Invalidated

(Inherited from System.Windows.Forms.Control)

KeyDown

(Inherited from System.Windows.Forms.Control)

KeyPress

(Inherited from System.Windows.Forms.Control)

KeyUp

(Inherited from System.Windows.Forms.Control)

Layout

(Inherited from System.Windows.Forms.Control)

Leave

(Inherited from System.Windows.Forms.Control)

LocationChanged

(Inherited from System.Windows.Forms.Control)

LostFocus

(Inherited from System.Windows.Forms.Control)

MarginChanged

(Inherited from System.Windows.Forms.Control)

MouseCaptureChanged

(Inherited from System.Windows.Forms.Control)

76

MouseClick

(Inherited from System.Windows.Forms.Control)

MouseDoubleClick

(Inherited from System.Windows.Forms.Control)

MouseDown

(Inherited from System.Windows.Forms.Control)

MouseEnter

(Inherited from System.Windows.Forms.Control)

MouseHover

(Inherited from System.Windows.Forms.Control)

MouseLeave

(Inherited from System.Windows.Forms.Control)

MouseMove

(Inherited from System.Windows.Forms.Control)

MouseUp

(Inherited from System.Windows.Forms.Control)

MouseWheel

(Inherited from System.Windows.Forms.Control)

Move

(Inherited from System.Windows.Forms.Control)

PaddingChanged

(Inherited from System.Windows.Forms.Control)

Paint

(Inherited from System.Windows.Forms.Control)

ParentChanged

(Inherited from System.Windows.Forms.Control)

PreviewKeyDown

(Inherited from System.Windows.Forms.Control)

QueryAccessibilityHelp

(Inherited from System.Windows.Forms.Control)

QueryContinueDrag

(Inherited from System.Windows.Forms.Control)

RegionChanged

(Inherited from System.Windows.Forms.Control)

Resize

(Inherited from System.Windows.Forms.Control)

RightToLeftChanged

(Inherited from System.Windows.Forms.Control)

77

SizeChanged

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

SystemColorsChanged

(Inherited from System.Windows.Forms.Control)

TabIndexChanged

(Inherited from System.Windows.Forms.Control)

TabStopChanged

(Inherited from System.Windows.Forms.Control)

TextChanged

(Inherited from System.Windows.Forms.Control)

Validated

(Inherited from System.Windows.Forms.Control)

Validating

(Inherited from System.Windows.Forms.Control)

VisibleChanged

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1Sizer Class
C1.Win.C1Sizer Namespace

C1Sizer Constructor
Initializes a new instance of the C1Sizer control.

Syntax
Visual Basic (Declaration)
Public Function New()

78

C#
public C1Sizer()

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

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


at a given cell on the grid.

BeginInvoke

Overloaded. (Inherited from System.Windows.Forms.Control)

BringToFront

(Inherited from System.Windows.Forms.Control)

Contains

(Inherited from System.Windows.Forms.Control)

CreateControl

(Inherited from System.Windows.Forms.Control)

CreateGraphics

(Inherited from System.Windows.Forms.Control)

CreateObjRef

(Inherited from System.MarshalByRefObject)

79

Dispose

(Inherited from System.ComponentModel.Component)

DoDragDrop

(Inherited from System.Windows.Forms.Control)

DrawToBitmap

(Inherited from System.Windows.Forms.Control)

EndInvoke

(Inherited from System.Windows.Forms.Control)

FindForm

(Inherited from System.Windows.Forms.Control)

Focus

(Inherited from System.Windows.Forms.Control)

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

Overloaded. (Inherited from System.Windows.Forms.Control)

GetContainerControl

(Inherited from System.Windows.Forms.Control)

GetControlAtCell

Gets the first control at a given grid cell.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

GetNextControl

(Inherited from System.Windows.Forms.Control)

GetPreferredSize

(Inherited from System.Windows.Forms.Control)

Hide

(Inherited from System.Windows.Forms.Control)

InitializeLifetimeService

(Inherited from System.MarshalByRefObject)

Invalidate

Overloaded. (Inherited from System.Windows.Forms.Control)

Invoke

Overloaded. (Inherited from System.Windows.Forms.Control)

PerformLayout

Overloaded. (Inherited from System.Windows.Forms.Control)

80

PointToClient

(Inherited from System.Windows.Forms.Control)

PointToScreen

(Inherited from System.Windows.Forms.Control)

PreProcessControlMessage (Inherited from System.Windows.Forms.Control)


PreProcessMessage

(Inherited from System.Windows.Forms.Control)

RectangleToClient

(Inherited from System.Windows.Forms.Control)

RectangleToScreen

(Inherited from System.Windows.Forms.Control)

Refresh

(Inherited from System.Windows.Forms.Control)

ResetText

(Inherited from System.Windows.Forms.Control)

ResumeLayout

Overloaded. Resumes normal layout logic.

Scale

(Inherited from System.Windows.Forms.Control)

Select

(Inherited from System.Windows.Forms.Control)

SelectNextControl

(Inherited from System.Windows.Forms.Control)

SendToBack

(Inherited from System.Windows.Forms.Control)

SetBounds

Overloaded. (Inherited from System.Windows.Forms.Control)

Show

(Inherited from System.Windows.Forms.Control)

SuspendLayout

Temporarily suspends the layout logic for the control.

ToString

(Inherited from System.ComponentModel.Component)

Update

(Inherited from System.Windows.Forms.Control)

Top

See Also

81

Reference
C1Sizer Class
C1.Win.C1Sizer Namespace

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


at a given cell on the grid.
AddControl(Control,Int32,Int32)

Adds a child control to the C1Sizer and positions it


at a given cell on the grid.

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

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.
Adds a child control to the C1Sizer and positions it at a given cell on the grid.

Syntax

82

Visual Basic (Declaration)


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
Child System.Windows.Forms.Control to add.
row
Index of the row where the child control will be positioned.
col
Index of the column where the child control will be positioned.
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
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.
Adds a child control to the C1Sizer and positions it at a given cell on the grid.

Syntax
Visual Basic (Declaration)
Public Overloads Sub AddControl( _
ByVal ctl As Control, _
ByVal row As Integer, _
ByVal col As Integer _
)
C#
public void AddControl(
Control ctl,
int row,
int col
)

Parameters
ctl
Child System.Windows.Forms.Control to add.
row
Index of the row where the child control will be positioned.
col
Index of the column where the child control will be positioned.

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)

Gets the cell at a given point on the control's client area.

GetCellAtPoint(Int32,Int32) Gets the cell at a given point on the control's client area.

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

GetCellAtPoint(Point) Method
System.Drawing.Point that specifies the cell position.
Gets the cell at a given point on the control's client area.

Syntax

85

Visual Basic (Declaration)


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
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(Int32,Int32) Method
X coordinate of the point.
Y coordinate of the point.
Gets the cell at a given point on the control's client area.

Syntax
Visual Basic (Declaration)

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
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 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
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

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
Visual Basic (Declaration)
Public Overloads Function GetCellBounds( _
ByVal row As Integer, _
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
Visual Basic (Declaration)

89

Public Overloads Function GetCellBounds( _


ByVal row As Integer, _
ByVal col As Integer _
) As Rectangle
C#
public Rectangle GetCellBounds(
int row,
int col
)

Parameters
row
Index of the row that contains the cell.
col
Index of the column that contains the cell.

Return Value
A System.Drawing.Rectangle that contains the bounds of the cell.

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

GetControlAtCell Method
Index of the row that contains the cell.
Index of the column that contains the cell.
Gets the first control at a given grid cell.

Syntax

90

Visual Basic (Declaration)


Public Function GetControlAtCell( _
ByVal row As Integer, _
ByVal col As Integer _
) As Control
C#
public Control GetControlAtCell(
int row,
int col
)

Parameters
row
Index of the row that contains the cell.
col
Index of the column that contains the cell.

Return Value
The first control at the cell, or null if the cell is empty.

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

ResumeLayout Method
Resumes normal layout logic.

Overload List
Overload

Description

91

ResumeLayout()

Resumes normal layout logic.

ResumeLayout(Boolean) Resumes normal layout logic. Optionally forces an immediate layout


of pending layout requests.

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

ResumeLayout() Method
Resumes normal layout logic.

Syntax
Visual Basic (Declaration)
Public Overloads Shadows Sub ResumeLayout()
C#
public new void ResumeLayout()

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

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
Visual Basic (Declaration)
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
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

SuspendLayout Method
Temporarily suspends the layout logic for the control.

Syntax
Visual Basic (Declaration)
Public Shadows Sub SuspendLayout()

93

C#
public new void SuspendLayout()

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

Properties
%%scrap%%
" -->
For a list of all members of this type, see C1Sizer members.

Public Properties
Name

Description

AccessibilityObject

(Inherited from System.Windows.Forms.Control)

AccessibleDefaultActionDescription (Inherited from System.Windows.Forms.Control)


AccessibleDescription

(Inherited from System.Windows.Forms.Control)

AccessibleName

(Inherited from System.Windows.Forms.Control)

AccessibleRole

(Inherited from System.Windows.Forms.Control)

AllowDrop

(Inherited from System.Windows.Forms.Control)

Anchor

(Inherited from System.Windows.Forms.Control)

AutoScrollOffset

(Inherited from System.Windows.Forms.Control)

94

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

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayout

(Inherited from System.Windows.Forms.Control)

BindingContext

(Inherited from System.Windows.Forms.Control)

Border

Gets the Border object that controls border thickness,


color, and corner radii.

Bottom

(Inherited from System.Windows.Forms.Control)

Bounds

(Inherited from System.Windows.Forms.Control)

CanFocus

(Inherited from System.Windows.Forms.Control)

CanSelect

(Inherited from System.Windows.Forms.Control)

Capture

(Inherited from System.Windows.Forms.Control)

CausesValidation

(Inherited from System.Windows.Forms.Control)

ClientRectangle

(Inherited from System.Windows.Forms.Control)

ClientSize

(Inherited from System.Windows.Forms.Control)

CompanyName

(Inherited from System.Windows.Forms.Control)

Container

(Inherited from System.ComponentModel.Component)

ContainsFocus

(Inherited from System.Windows.Forms.Control)

ContextMenu

(Inherited from System.Windows.Forms.Control)

95

ContextMenuStrip

(Inherited from System.Windows.Forms.Control)

Controls

(Inherited from System.Windows.Forms.Control)

Created

(Inherited from System.Windows.Forms.Control)

Cursor

Overridden. Gets or sets the cursor that is displayed


when the mouse pointer is over the control.

DataBindings

(Inherited from System.Windows.Forms.Control)

DisplayRectangle

(Inherited from System.Windows.Forms.Control)

Disposing

(Inherited from System.Windows.Forms.Control)

Dock

(Inherited from System.Windows.Forms.Control)

Enabled

(Inherited from System.Windows.Forms.Control)

Focused

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

HasChildren

(Inherited from System.Windows.Forms.Control)

Height

(Inherited from System.Windows.Forms.Control)

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.

96

ImeMode

(Inherited from System.Windows.Forms.Control)

InvokeRequired

(Inherited from System.Windows.Forms.Control)

IsAccessible

(Inherited from System.Windows.Forms.Control)

IsDisposed

(Inherited from System.Windows.Forms.Control)

IsHandleCreated

(Inherited from System.Windows.Forms.Control)

IsMirrored

(Inherited from System.Windows.Forms.Control)

LayoutEngine

(Inherited from System.Windows.Forms.Control)

Left

(Inherited from System.Windows.Forms.Control)

Location

(Inherited from System.Windows.Forms.Control)

Margin

(Inherited from System.Windows.Forms.Control)

MaximumSize

(Inherited from System.Windows.Forms.Control)

MinimumSize

(Inherited from System.Windows.Forms.Control)

Name

(Inherited from System.Windows.Forms.Control)

Padding

Gets or sets the padding between the control border


and its content.

Parent

(Inherited from System.Windows.Forms.Control)

PreferredSize

(Inherited from System.Windows.Forms.Control)

ProductName

(Inherited from System.Windows.Forms.Control)

ProductVersion

(Inherited from System.Windows.Forms.Control)

RecreatingHandle

(Inherited from System.Windows.Forms.Control)

97

Region

(Inherited from System.Windows.Forms.Control)

Right

(Inherited from System.Windows.Forms.Control)

RightToLeft

(Inherited from System.Windows.Forms.Control)

Site

(Inherited from System.Windows.Forms.Control)

Size

(Inherited from System.Windows.Forms.Control)

SplitterWidth

Gets or sets the width of the area between grid bands,


in pixels.

TabIndex

(Inherited from System.Windows.Forms.Control)

TabStop

(Inherited from System.Windows.Forms.Control)

Tag

(Inherited from System.Windows.Forms.Control)

Text

(Inherited from System.Windows.Forms.Control)

Top

(Inherited from System.Windows.Forms.Control)

TopLevelControl

(Inherited from System.Windows.Forms.Control)

UseWaitCursor

(Inherited from System.Windows.Forms.Control)

Visible

(Inherited from System.Windows.Forms.Control)

Width

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1Sizer Class
C1.Win.C1Sizer Namespace

98

AutoSizeMode Property
Gets or sets the layout mode for the C1Sizer control.

Syntax
Visual Basic (Declaration)
Public Property AutoSizeMode As AutoSizeEnum
C#
public AutoSizeEnum AutoSizeMode {get; set;}

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

BackColor Property
Gets or sets the System.Drawing.Color used to paint the background.

Syntax
Visual Basic (Declaration)
Public Shadows Property BackColor As Color
C#
public new Color BackColor {get; set;}

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

99

Reference
C1Sizer Class
C1Sizer Members

Border Property
Gets the Border object that controls border thickness, color, and corner radii.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Border As Border
C#
public Border Border {get;}

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

Cursor Property
Gets or sets the cursor that is displayed when the mouse pointer is over the control.

Syntax
Visual Basic (Declaration)
Public Overrides Property Cursor As Cursor
C#
public override Cursor Cursor {get; set;}

Requirements

100

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

Gradient Property
Gets the Gradient object that controls gradient color, mode, blend, and gamma correction.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Gradient As Gradient
C#
public Gradient Gradient {get;}

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

Grid Property
Returns a reference to a Grid object that contains the layout information for the C1Sizer control.

Syntax
Visual Basic (Declaration)
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
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

Image Property
Gets or sets the image displayed in the control.

Syntax
Visual Basic (Declaration)
Public Property Image As Image
C#
public Image Image {get; set;}

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

102

C1Sizer Class
C1Sizer Members

ImageAlignment Property
Gets or sets the alignment used to render the image.

Syntax
Visual Basic (Declaration)
Public Property ImageAlignment As ImageAlignment
C#
public ImageAlignment ImageAlignment {get; set;}

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

ImageScaling Property
Gets or sets the scaling used to render the image.

Syntax
Visual Basic (Declaration)
Public Property ImageScaling As ImageScaling
C#
public ImageScaling ImageScaling {get; set;}

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

103

See Also
Reference
C1Sizer Class
C1Sizer Members

Padding Property
Gets or sets the padding between the control border and its content.

Syntax
Visual Basic (Declaration)
Public Shadows Property Padding As Padding
C#
public new Padding Padding {get; set;}

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

SplitterWidth Property
Gets or sets the width of the area between grid bands, in pixels.

Syntax
Visual Basic (Declaration)
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
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

Events
%%scrap%%
" -->
For a list of all members of this type, see C1Sizer members.

Public Events
Name

Description

BackColorChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageChanged

(Inherited from System.Windows.Forms.Control)

BackgroundImageLayoutChanged (Inherited from System.Windows.Forms.Control)


BindingContextChanged

(Inherited from System.Windows.Forms.Control)

CausesValidationChanged

(Inherited from System.Windows.Forms.Control)

ChangeUICues

(Inherited from System.Windows.Forms.Control)

Click

(Inherited from System.Windows.Forms.Control)

ClientSizeChanged

(Inherited from System.Windows.Forms.Control)

105

ContextMenuChanged

(Inherited from System.Windows.Forms.Control)

ContextMenuStripChanged

(Inherited from System.Windows.Forms.Control)

ControlAdded

(Inherited from System.Windows.Forms.Control)

ControlRemoved

(Inherited from System.Windows.Forms.Control)

CursorChanged

(Inherited from System.Windows.Forms.Control)

Disposed

(Inherited from System.ComponentModel.Component)

DockChanged

(Inherited from System.Windows.Forms.Control)

DoubleClick

(Inherited from System.Windows.Forms.Control)

DragDrop

(Inherited from System.Windows.Forms.Control)

DragEnter

(Inherited from System.Windows.Forms.Control)

DragLeave

(Inherited from System.Windows.Forms.Control)

DragOver

(Inherited from System.Windows.Forms.Control)

EnabledChanged

(Inherited from System.Windows.Forms.Control)

Enter

(Inherited from System.Windows.Forms.Control)

FontChanged

(Inherited from System.Windows.Forms.Control)

ForeColorChanged

(Inherited from System.Windows.Forms.Control)

GiveFeedback

(Inherited from System.Windows.Forms.Control)

GotFocus

(Inherited from System.Windows.Forms.Control)

HandleCreated

(Inherited from System.Windows.Forms.Control)

106

HandleDestroyed

(Inherited from System.Windows.Forms.Control)

HelpRequested

(Inherited from System.Windows.Forms.Control)

ImeModeChanged

(Inherited from System.Windows.Forms.Control)

Invalidated

(Inherited from System.Windows.Forms.Control)

KeyDown

(Inherited from System.Windows.Forms.Control)

KeyPress

(Inherited from System.Windows.Forms.Control)

KeyUp

(Inherited from System.Windows.Forms.Control)

Layout

(Inherited from System.Windows.Forms.Control)

Leave

(Inherited from System.Windows.Forms.Control)

LocationChanged

(Inherited from System.Windows.Forms.Control)

LostFocus

(Inherited from System.Windows.Forms.Control)

MarginChanged

(Inherited from System.Windows.Forms.Control)

MouseCaptureChanged

(Inherited from System.Windows.Forms.Control)

MouseClick

(Inherited from System.Windows.Forms.Control)

MouseDoubleClick

(Inherited from System.Windows.Forms.Control)

MouseDown

(Inherited from System.Windows.Forms.Control)

MouseEnter

(Inherited from System.Windows.Forms.Control)

MouseHover

(Inherited from System.Windows.Forms.Control)

MouseLeave

(Inherited from System.Windows.Forms.Control)

107

MouseMove

(Inherited from System.Windows.Forms.Control)

MouseUp

(Inherited from System.Windows.Forms.Control)

MouseWheel

(Inherited from System.Windows.Forms.Control)

Move

(Inherited from System.Windows.Forms.Control)

PaddingChanged

(Inherited from System.Windows.Forms.Control)

Paint

(Inherited from System.Windows.Forms.Control)

ParentChanged

(Inherited from System.Windows.Forms.Control)

PreviewKeyDown

(Inherited from System.Windows.Forms.Control)

QueryAccessibilityHelp

(Inherited from System.Windows.Forms.Control)

QueryContinueDrag

(Inherited from System.Windows.Forms.Control)

RegionChanged

(Inherited from System.Windows.Forms.Control)

Resize

(Inherited from System.Windows.Forms.Control)

RightToLeftChanged

(Inherited from System.Windows.Forms.Control)

SizeChanged

(Inherited from System.Windows.Forms.Control)

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

(Inherited from System.Windows.Forms.Control)

SystemColorsChanged

(Inherited from System.Windows.Forms.Control)

108

TabIndexChanged

(Inherited from System.Windows.Forms.Control)

TabStopChanged

(Inherited from System.Windows.Forms.Control)

TextChanged

(Inherited from System.Windows.Forms.Control)

Validated

(Inherited from System.Windows.Forms.Control)

Validating

(Inherited from System.Windows.Forms.Control)

VisibleChanged

(Inherited from System.Windows.Forms.Control)

Top

See Also
Reference
C1Sizer Class
C1.Win.C1Sizer Namespace

SplitterMoved Event
Fired when the user finishes resizing a band (row or column) by dragging a splitter bar.

Syntax
Visual Basic (Declaration)
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.

Gets the X coordinate of the mouse when the event is fired.

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

SplitterMoving Event
Fired when the user clicks a splitter and starts resizing a band (row or column) on the layout
grid.

Syntax
Visual Basic (Declaration)
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

Gets a reference to the band (row or column) that caused the event.

Gets the X coordinate of the mouse when the event is fired.

Gets the X coordinate of the mouse when the event is fired.

110

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

C1SizerEventArgs
Provides data for the C1Sizer.SplitterMoving and C1Sizer.SplitterMoved events of a C1Sizer
control.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1SizerEventArgs
Inherits System.EventArgs
C#
public class C1SizerEventArgs : System.EventArgs

Inheritance Hierarchy
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerEventArgs

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

111

Reference
C1SizerEventArgs Members
C1.Win.C1Sizer Namespace

Overview
Provides data for the C1Sizer.SplitterMoving and C1Sizer.SplitterMoved events of a C1Sizer
control.

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1SizerEventArgs
Inherits System.EventArgs
C#
public class C1SizerEventArgs : System.EventArgs

Inheritance Hierarchy
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerEventArgs

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
C1SizerEventArgs Members
C1.Win.C1Sizer Namespace

Members
Properties

The following tables list the members exposed by C1SizerEventArgs.

112

Public Properties
Name

Description

Band

Gets a reference to the band (row or column) that caused the event.

Gets the X coordinate of the mouse when the event is fired.

Gets the X coordinate of the mouse when the event is fired.

Top

See Also
Reference
C1SizerEventArgs Class
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see C1SizerEventArgs members.

Public Properties
Name

Description

Band

Gets a reference to the band (row or column) that caused the event.

Gets the X coordinate of the mouse when the event is fired.

Gets the X coordinate of the mouse when the event is fired.

Top

See Also
Reference
C1SizerEventArgs Class
C1.Win.C1Sizer Namespace

113

Band Property
Gets a reference to the band (row or column) that caused the event.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Band As Band
C#
public Band Band {get;}

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
C1SizerEventArgs Class
C1SizerEventArgs Members

X Property
Gets the X coordinate of the mouse when the event is fired.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property X As Integer
C#
public int X {get;}

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

114

Reference
C1SizerEventArgs Class
C1SizerEventArgs Members

Y Property
Gets the X coordinate of the mouse when the event is fired.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Y As Integer
C#
public int Y {get;}

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
C1SizerEventArgs Class
C1SizerEventArgs Members

C1SizerLight
Component that resizes all controls on a form when the form is resized.

Object Model

Syntax
Visual Basic (Declaration)
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.
C1SizerLight can also resize the fonts on all or some of the contained controls.
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.

Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
C1.Win.C1Sizer.C1SizerLight

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
C1SizerLight Members
C1.Win.C1Sizer Namespace

Overview
Component that resizes all controls on a form when the form is resized.

Object Model
116

Syntax
Visual Basic (Declaration)
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.
C1SizerLight can also resize the fonts on all or some of the contained controls.
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.

Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
C1.Win.C1Sizer.C1SizerLight

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

117

Reference
C1SizerLight Members
C1.Win.C1Sizer Namespace

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

(Inherited from System.ComponentModel.Component)

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

(Inherited from System.ComponentModel.Component)

Top

Public Methods
Name

Description

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose()

(Inherited from System.ComponentModel.Component)

118

GetAutoResize

For internal use.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

InitializeLifetimeService (Inherited from System.MarshalByRefObject)


SetAutoResize

For internal use.

ToString

(Inherited from System.ComponentModel.Component)

Top

Public Events
Name

Description

Disposed

(Inherited from System.ComponentModel.Component)

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
C1.Win.C1Sizer Namespace

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
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
C1SizerLight Class
C1SizerLight Members

C1SizerLight Constructor(IContainer)
The IContainer that contains the component.
Initializes a new instance of a C1SizerLight component in a given
System.ComponentModel.IContainer.

Syntax
Visual Basic (Declaration)
Public Function New( _
ByVal container As IContainer _
)
C#
public C1SizerLight(
IContainer container
)

Parameters
container
The IContainer that contains the component.

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

120

See Also
Reference
C1SizerLight Class
C1SizerLight Members
Overload List

C1SizerLight Constructor()
Initializes a new instance of a C1SizerLight.

Syntax
Visual Basic (Declaration)
Public Function New()
C#
public C1SizerLight()

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
C1SizerLight Class
C1SizerLight Members
Overload List

Methods
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLight members.

Public Methods
Name

Description

121

CreateObjRef

(Inherited from System.MarshalByRefObject)

Dispose()

(Inherited from System.ComponentModel.Component)

GetAutoResize

For internal use.

GetLifetimeService

(Inherited from System.MarshalByRefObject)

InitializeLifetimeService (Inherited from System.MarshalByRefObject)


SetAutoResize

For internal use.

ToString

(Inherited from System.ComponentModel.Component)

Top

See Also
Reference
C1SizerLight Class
C1.Win.C1Sizer Namespace

GetAutoResize Method
For internal use.

Syntax
Visual Basic (Declaration)
Public Function GetAutoResize( _
ByVal frm As Form _
) As Boolean
C#
public bool GetAutoResize(
Form frm
)

Parameters
frm

122

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
C1SizerLight Class
C1SizerLight Members

SetAutoResize Method
For internal use.

Syntax
Visual Basic (Declaration)
Public Sub SetAutoResize( _
ByVal frm As Form, _
ByVal value As Boolean _
)
C#
public void SetAutoResize(
Form frm,
bool value
)

Parameters
frm
value

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

123

C1SizerLight Class
C1SizerLight Members

Properties
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLight members.

Public Properties
Name

Description

Container

(Inherited from System.ComponentModel.Component)

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

(Inherited from System.ComponentModel.Component)

Top

See Also
Reference
C1SizerLight Class
C1.Win.C1Sizer Namespace

Enabled Property
Determines whether the C1SizerLight should resize the controls on the form when the form is
resized.

Syntax
Visual Basic (Declaration)
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
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
C1SizerLight Class
C1SizerLight Members

ResizeFonts Property
Determines whether the C1SizerLight should resize control fonts in addition to the controls
themselves.

Syntax
Visual Basic (Declaration)
Public Property ResizeFonts As Boolean
C#
public bool ResizeFonts {get; set;}

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

125

C1SizerLight Class
C1SizerLight Members

Events
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLight members.

Public Events
Name

Description

Disposed

(Inherited from System.ComponentModel.Component)

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
C1.Win.C1Sizer Namespace

ResizingControl Event
Fires before the C1SizerLight resizes a control in response to the form being resized.

Syntax
Visual Basic (Declaration)
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


C1SizerLight component.

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
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
C1SizerLight Class
C1SizerLight Members

ResizingFont Event
Example

Fires before the C1SizerLight resizes the font in a control in response to the form being resized.

Syntax
Visual Basic (Declaration)
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

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


C1SizerLight component.

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

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

128

C1SizerLight Class
C1SizerLight Members

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

Object Model

Syntax
Visual Basic (Declaration)
Public Class C1SizerLightEventArgs
Inherits System.EventArgs
C#
public class C1SizerLightEventArgs : System.EventArgs

Inheritance Hierarchy
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerLightEventArgs

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
C1SizerLightEventArgs Members
C1.Win.C1Sizer Namespace

Overview
Provides data for the C1SizerLight.ResizingFont event of a C1SizerLight component.

Object Model

129

Syntax
Visual Basic (Declaration)
Public Class C1SizerLightEventArgs
Inherits System.EventArgs
C#
public class C1SizerLightEventArgs : System.EventArgs

Inheritance Hierarchy
System.Object
System.EventArgs
C1.Win.C1Sizer.C1SizerLightEventArgs

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
C1SizerLightEventArgs Members
C1.Win.C1Sizer Namespace

Members
Properties

The following tables list the members exposed by C1SizerLightEventArgs.

Public Properties
Name

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


C1SizerLight component.

Top

130

See Also
Reference
C1SizerLightEventArgs Class
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see C1SizerLightEventArgs members.

Public Properties
Name

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


C1SizerLight component.

Top

See Also
Reference
C1SizerLightEventArgs Class
C1.Win.C1Sizer Namespace

Cancel Property
Determines whether the font for this control should be resized.

Syntax
Visual Basic (Declaration)
Public Property Cancel As Boolean
C#
public bool Cancel {get; set;}

Requirements
131

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
C1SizerLightEventArgs Class
C1SizerLightEventArgs Members

Control Property
Gets a reference to the control whose font is about to be resized by the C1SizerLight
component.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Control As Control
C#
public Control Control {get;}

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
C1SizerLightEventArgs Class
C1SizerLightEventArgs Members

Column
Represents a column in the Sizer grid.

Object Model

Syntax
132

Visual Basic (Declaration)


Public Class Column
Inherits Band
C#
public class Column : Band

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Column

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
Column Members
C1.Win.C1Sizer Namespace

Overview
Represents a column in the Sizer grid.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Column
Inherits Band
C#
public class Column : Band

133

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Column

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
Column Members
C1.Win.C1Sizer Namespace

Members
Properties Methods

The following tables list the members exposed by Column.

Public Properties
Name

Description

Bounds

Gets a System.Drawing.Rectangle that represents the size and location of


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
C1.Win.C1Sizer.Band)

IsFixedSize

Determines whether the Band should retain its size when the control is
resized. (Inherited from C1.Win.C1Sizer.Band)

IsSplitter

Determines whether the band acts like a splitter (can be resized with the
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
C1.Win.C1Sizer Namespace

Methods
%%scrap%%
" -->
For a list of all members of this type, see Column members.

Public Methods
Name

Description

ToString

Returns a string representation of the Column object.

Top

See Also
Reference
Column Class
C1.Win.C1Sizer Namespace

ToString Method
Returns a string representation of the Column object.

Syntax
Visual Basic (Declaration)

135

Public Overrides Function ToString() As String


C#
public override string ToString()

Return Value
A string representation of the Column object

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
Column Class
Column Members

Properties
%%scrap%%
" -->
For a list of all members of this type, see Column members.

Public Properties
Name

Description

Bounds

Gets a System.Drawing.Rectangle that represents the size and location of


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
C1.Win.C1Sizer.Band)

IsFixedSize

Determines whether the Band should retain its size when the control is
resized. (Inherited from C1.Win.C1Sizer.Band)

136

IsSplitter

Determines whether the band acts like a splitter (can be resized with the
mouse at run time). (Inherited from C1.Win.C1Sizer.Band)

Size

Overridden. Gets or sets the width of the Column in pixels.

Top

See Also
Reference
Column Class
C1.Win.C1Sizer Namespace

Size Property
Gets or sets the width of the Column in pixels.

Syntax
Visual Basic (Declaration)
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
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
137

Reference
Column Class
Column Members

ColumnCollection
Collection of Column objects.

Object Model

Syntax
Visual Basic (Declaration)
Public Class ColumnCollection
Inherits BandCollection
C#
public class ColumnCollection : BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.ColumnCollection

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
ColumnCollection Members
C1.Win.C1Sizer Namespace

Overview
Collection of Column objects.

Object Model
138

Syntax
Visual Basic (Declaration)
Public Class ColumnCollection
Inherits BandCollection
C#
public class ColumnCollection : BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.ColumnCollection

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
ColumnCollection Members
C1.Win.C1Sizer Namespace

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


C1.Win.C1Sizer.BandCollection)

SetSizes

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


C1.Win.C1Sizer.BandCollection)

Top

See Also
Reference
ColumnCollection Class
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see ColumnCollection members.

Public Properties
Name

Description

Count

Gets or sets the number of bands in the collection. (Inherited from


C1.Win.C1Sizer.BandCollection)

Item

Gets the Column object at a given index in the collection.

Top

140

See Also
Reference
ColumnCollection Class
C1.Win.C1Sizer Namespace

Item Property
Gets the Column object at a given index in the collection.

Syntax
Visual Basic (Declaration)
Public ReadOnly Default Property Item( _
ByVal index As Integer _
) As Column
C#
public Column this[
int index
]; {get;}

Parameters
index

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
ColumnCollection Class
ColumnCollection Members

Gradient
Class that implements gradient backgrounds and exposes properties that control the
appearance of the gradient.

Object Model

141

Syntax
Visual Basic (Declaration)
Public Class Gradient
C#
public class Gradient

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Gradient

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
Gradient Members
C1.Win.C1Sizer Namespace

Overview
Class that implements gradient backgrounds and exposes properties that control the
appearance of the gradient.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Gradient
C#

142

public class Gradient

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Gradient

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
Gradient Members
C1.Win.C1Sizer Namespace

Members
Properties

The following tables list the members exposed by Gradient.

Public Properties
Name

Description

BackColor2

Gets or sets the secondary color used to build the background


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
C1.Win.C1Sizer Namespace

Properties
%%scrap%%
" -->
For a list of all members of this type, see Gradient members.

Public Properties
Name

Description

BackColor2

Gets or sets the secondary color used to build the background


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

See Also
Reference
Gradient Class
C1.Win.C1Sizer Namespace

BackColor2 Property
Gets or sets the secondary color used to build the background gradient.

Syntax
144

Visual Basic (Declaration)


Public Property BackColor2 As Color
C#
public Color BackColor2 {get; set;}

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
Gradient Class
Gradient Members

Blend Property
Gets or sets the Blend used to paint the background gradient.

Syntax
Visual Basic (Declaration)
Public Property Blend As Blend
C#
public Blend Blend {get; set;}

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
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
Visual Basic (Declaration)
Public Property Center As Point
C#
public Point Center {get; set;}

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
Gradient Class
Gradient Members

GammaCorrection Property
Gets or sets whether to apply gamma correction to the background gradient.

Syntax
Visual Basic (Declaration)
Public Property GammaCorrection As Boolean
C#
public bool GammaCorrection {get; set;}

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
146

Reference
Gradient Class
Gradient Members

Mode Property
Gets or sets the GradientMode used to paint the background.

Syntax
Visual Basic (Declaration)
Public Property Mode As GradientMode
C#
public GradientMode Mode {get; set;}

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
Gradient Class
Gradient Members

Grid
Summary description for Grid.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Grid
C#

147

public class Grid

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Grid

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
Grid Members
C1.Win.C1Sizer Namespace

Overview
Summary description for Grid.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Grid
C#
public class Grid

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Grid

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

148

See Also
Reference
Grid Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

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

Resets the Grid object so it contains one row and one column.

Top

See Also
Reference
Grid Class
C1.Win.C1Sizer Namespace

AutoGenerate Method
Resets the Grid object and creates new rows and columns based on the child controls within the
C1Sizer.

Syntax
Visual Basic (Declaration)
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
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
Grid Class
Grid Members

Clear Method
Resets the Grid object so it contains one row and one column.

Syntax
Visual Basic (Declaration)
Public Sub Clear()
C#
public void Clear()

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
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

Gets a reference to the C1Sizer control that owns this Grid.

Top

See Also
Reference
Grid Class
C1.Win.C1Sizer Namespace

Columns Property
Gets a reference to the ColumnCollection that contains the columns in the layout grid.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Columns As ColumnCollection
C#
public ColumnCollection Columns {get;}

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

152

See Also
Reference
Grid Class
Grid Members

DraggingSplitter Property

Syntax
Visual Basic (Declaration)
Public ReadOnly Property DraggingSplitter As Splitter
C#
public Splitter DraggingSplitter {get;}

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
Grid Class
Grid Members

Rows Property
Gets a reference to the RowCollection that contains the rows in the layout grid.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Rows As RowCollection
C#
public RowCollection Rows {get;}

Requirements

153

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
Grid Class
Grid Members

SelectedObjects Property

Syntax
Visual Basic (Declaration)
Public Property SelectedObjects As Object()
C#
public object[] SelectedObjects {get; set;}

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
Grid Class
Grid Members

Sizer Property
Gets a reference to the C1Sizer control that owns this Grid.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property Sizer As C1Sizer
C#
public C1Sizer Sizer {get;}

154

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
Grid Class
Grid Members

Row
Represents a row in the Sizer grid.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Row
Inherits Band
C#
public class Row : Band

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
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
155

Row Members
C1.Win.C1Sizer Namespace

Overview
Represents a row in the Sizer grid.

Object Model

Syntax
Visual Basic (Declaration)
Public Class Row
Inherits Band
C#
public class Row : Band

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
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
Row Members
C1.Win.C1Sizer Namespace

Members
Properties Methods

The following tables list the members exposed by Row.

Public Properties
156

Name

Description

Bounds

Gets a System.Drawing.Rectangle that represents the size and location of


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
C1.Win.C1Sizer.Band)

IsFixedSize

Determines whether the Band should retain its size when the control is
resized. (Inherited from C1.Win.C1Sizer.Band)

IsSplitter

Determines whether the band acts like a splitter (can be resized with the
mouse at run time). (Inherited from C1.Win.C1Sizer.Band)

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
C1.Win.C1Sizer Namespace

Methods
%%scrap%%
" -->
For a list of all members of this type, see Row members.

Public Methods

157

Name

Description

ToString

Returns a string representation of the Row object.

Top

See Also
Reference
Row Class
C1.Win.C1Sizer Namespace

ToString Method
Returns a string representation of the Row object.

Syntax
Visual Basic (Declaration)
Public Overrides Function ToString() As String
C#
public override string ToString()

Return Value
A string representation of the Row object

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
Row Class
Row Members

Properties
%%scrap%%
" -->

158

For a list of all members of this type, see Row members.

Public Properties
Name

Description

Bounds

Gets a System.Drawing.Rectangle that represents the size and location of


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
C1.Win.C1Sizer.Band)

IsFixedSize

Determines whether the Band should retain its size when the control is
resized. (Inherited from C1.Win.C1Sizer.Band)

IsSplitter

Determines whether the band acts like a splitter (can be resized with the
mouse at run time). (Inherited from C1.Win.C1Sizer.Band)

Size

Overridden. Gets or sets the height of the Row in pixels.

Top

See Also
Reference
Row Class
C1.Win.C1Sizer Namespace

Size Property
Gets or sets the height of the Row in pixels.

Syntax
Visual Basic (Declaration)
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
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
Row Class
Row Members

RowCollection
Collection of Row objects.

Object Model

Syntax
Visual Basic (Declaration)
Public Class RowCollection
Inherits BandCollection
C#
public class RowCollection : BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.RowCollection

160

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
RowCollection Members
C1.Win.C1Sizer Namespace

Overview
Collection of Row objects.

Object Model

Syntax
Visual Basic (Declaration)
Public Class RowCollection
Inherits BandCollection
C#
public class RowCollection : BandCollection

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.BandCollection
C1.Win.C1Sizer.RowCollection

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

161

RowCollection Members
C1.Win.C1Sizer Namespace

Members
Properties Methods

The following tables list the members exposed by RowCollection.

Public Properties
Name

Description

Count

Gets or sets the number of bands in the collection. (Inherited from


C1.Win.C1Sizer.BandCollection)

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


C1.Win.C1Sizer.BandCollection)

SetSizes

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


C1.Win.C1Sizer.BandCollection)

Top

See Also
Reference
RowCollection Class
C1.Win.C1Sizer Namespace

Properties
%%scrap%%

162

" -->
For a list of all members of this type, see RowCollection members.

Public Properties
Name

Description

Count

Gets or sets the number of bands in the collection. (Inherited from


C1.Win.C1Sizer.BandCollection)

Item

Gets the Row object at a given index in the collection.

Top

See Also
Reference
RowCollection Class
C1.Win.C1Sizer Namespace

Item Property
Gets the Row object at a given index in the collection.

Syntax
Visual Basic (Declaration)
Public ReadOnly Default Property Item( _
ByVal index As Integer _
) As Row
C#
public Row this[
int index
]; {get;}

Parameters
index

Requirements

163

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
RowCollection Class
RowCollection Members

Strings
Static class containing UI strings.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings
C#
public static class Strings

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Strings

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
Strings Members
C1.Win.C1Sizer Namespace

164

Overview
Static class containing UI strings.

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings
C#
public static class Strings

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Strings

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
Strings Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

CannotInsertBand Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property CannotInsertBand As String
C#
public static string CannotInsertBand {get;}

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
Strings Class
Strings Members

CannotRemoveBand Property

Syntax

167

Visual Basic (Declaration)


Public Shared ReadOnly Property CannotRemoveBand As String
C#
public static string CannotRemoveBand {get;}

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
Strings Class
Strings Members

Column Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property Column As String
C#
public static string Column {get;}

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
Strings Class
Strings Members

ConfirmClearGrid Property

Syntax
168

Visual Basic (Declaration)


Public Shared ReadOnly Property ConfirmClearGrid As String
C#
public static string ConfirmClearGrid {get;}

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
Strings Class
Strings Members

DesignTimeMessage Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property DesignTimeMessage As String
C#
public static string DesignTimeMessage {get;}

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
Strings Class
Strings Members

ResourceManager Property

Syntax
169

Visual Basic (Declaration)


Public Shared Property ResourceManager As ResourceManager
C#
public static ResourceManager ResourceManager {get; set;}

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
Strings Class
Strings Members

Row Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property Row As String
C#
public static string Row {get;}

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
Strings Class
Strings Members

UICulture Property

Syntax
170

Visual Basic (Declaration)


Public Shared ReadOnly Property UICulture As CultureInfo
C#
public static CultureInfo UICulture {get;}

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
Strings Class
Strings Members

Strings.BlendErrors
Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings.BlendErrors
C#
public static class Strings.BlendErrors

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Strings.BlendErrors

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

171

See Also
Reference
Strings.BlendErrors Members
C1.Win.C1Sizer Namespace

Overview

Object Model

Syntax
Visual Basic (Declaration)
Public MustInherit NotInheritable Class Strings.BlendErrors
C#
public static class Strings.BlendErrors

Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Strings.BlendErrors

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
Strings.BlendErrors Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

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
Strings.BlendErrors Class
C1.Win.C1Sizer Namespace

BadFormat Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BadFormat As String
C#
public static string BadFormat {get;}

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
Strings.BlendErrors Class
Strings.BlendErrors Members

BadPosition Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BadPosition As String
C#
public static string BadPosition {get;}

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

174

See Also
Reference
Strings.BlendErrors Class
Strings.BlendErrors Members

BadPositionOrFactor Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property BadPositionOrFactor As String
C#
public static string BadPositionOrFactor {get;}

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
Strings.BlendErrors Class
Strings.BlendErrors Members

CannotParseFloats Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property CannotParseFloats As String
C#
public static string CannotParseFloats {get;}

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

175

See Also
Reference
Strings.BlendErrors Class
Strings.BlendErrors Members

NonAscendingPositions Property

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property NonAscendingPositions As String
C#
public static string NonAscendingPositions {get;}

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
Strings.BlendErrors Class
Strings.BlendErrors Members

Enumerations
AutoSizeEnum
Represents the possible sizing modes.

Syntax
Visual Basic (Declaration)
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.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.AutoSizeEnum

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
C1.Win.C1Sizer Namespace

GradientMode
Specifies the background gradient mode.

Syntax
Visual Basic (Declaration)
Public Enum GradientMode
Inherits System.Enum
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).

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.GradientMode

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
C1.Win.C1Sizer Namespace

ImageAlignment
Specifies the image alignment.

Syntax
Visual Basic (Declaration)

178

Public Enum ImageAlignment


Inherits System.Enum
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.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.ImageAlignment

Requirements

179

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
C1.Win.C1Sizer Namespace

ImageScaling
Specifies the image scaling.

Syntax
Visual Basic (Declaration)
Public Enum ImageScaling
Inherits System.Enum
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.

Inheritance Hierarchy
System.Object
System.ValueType
System.Enum
C1.Win.C1Sizer.ImageScaling

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
C1.Win.C1Sizer Namespace

Structures
Corners
Represents corners associated with a user interface (UI) element.

Object Model

Syntax
Visual Basic (Declaration)
Public Structure Corners
Inherits System.ValueType

181

C#
public struct Corners : System.ValueType

Inheritance Hierarchy
System.Object
System.ValueType
C1.Win.C1Sizer.Corners

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 Members
C1.Win.C1Sizer Namespace

Overview
Represents corners associated with a user interface (UI) element.

Object Model

Syntax
Visual Basic (Declaration)
Public Structure Corners
Inherits System.ValueType
C#
public struct Corners : System.ValueType

Inheritance Hierarchy
System.Object
System.ValueType
C1.Win.C1Sizer.Corners

182

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 Members
C1.Win.C1Sizer Namespace

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
C1.Win.C1Sizer Namespace

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
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

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.
Initializes a new instance of a Corners object.

Syntax
Visual Basic (Declaration)
Public Function New( _
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.
Initializes a new instance of a Corners object.

Syntax
Visual Basic (Declaration)
Public Function New( _
ByVal radius As Integer _
)
C#
public Corners(
int radius
)

Parameters
radius
Radius of all corners, in pixels.

Requirements

186

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

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

Generates a hash code for the current Corners.

Top

See Also
Reference
Corners Structure
C1.Win.C1Sizer Namespace

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
Visual Basic (Declaration)

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
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

GetHashCode Method
Generates a hash code for the current Corners.

Syntax
Visual Basic (Declaration)
Public Overrides Function GetHashCode() As Integer
C#
public override int GetHashCode()

Return Value
A 32-bit signed integer hash code.

188

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

Properties
%%scrap%%
" -->
For a list of all members of this type, see Corners members.

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

See Also
Reference
Corners Structure
C1.Win.C1Sizer Namespace

189

Empty Property
Provides a Corners object with no thickness.

Syntax
Visual Basic (Declaration)
Public Shared ReadOnly Property Empty As Corners
C#
public static Corners Empty {get;}

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

IsEmpty Property
Returns true if the Corners object is empty.

Syntax
Visual Basic (Declaration)
Public ReadOnly Property IsEmpty As Boolean
C#
public bool IsEmpty {get;}

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

190

Reference
Corners Structure
Corners Members

LeftBottom Property
Gets or sets the radius for the left bottom corner.

Syntax
Visual Basic (Declaration)
Public Property LeftBottom As Integer
C#
public int LeftBottom {get; set;}

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

LeftTop Property
Gets or sets the radius for the left top corner.

Syntax
Visual Basic (Declaration)
Public Property LeftTop As Integer
C#
public int LeftTop {get; set;}

Requirements

191

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

RightBottom Property
Gets or sets the radius for the right bottom corner.

Syntax
Visual Basic (Declaration)
Public Property RightBottom As Integer
C#
public int RightBottom {get; set;}

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

RightTop Property
Gets or sets the radius for the right top corner.

Syntax
Visual Basic (Declaration)
Public Property RightTop As Integer

192

C#
public int RightTop {get; set;}

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

Operators
Equality Operator
A Corners to test.
A Corners to test.
Tests whether two specified Corners objects are equivalent.

Syntax
Visual Basic (Declaration)
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
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

Implicit Type Conversion Operator

Syntax
Visual Basic (Declaration)
Public Operator Widening CType( _
ByVal radii As Integer _
) As Corners
C#
public Corners operator implicit(
int radii
)

Parameters
radii

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

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
Visual Basic (Declaration)
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
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
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
Visual Basic (Declaration)
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
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
C1SizerEventHandler Members
C1.Win.C1Sizer Namespace

196

C1SizerLightEventHandler
Represents the method that will handle the C1SizerLight.ResizingFont and
C1SizerLight.ResizingControl events of a C1SizerLight component.

Syntax
Visual Basic (Declaration)
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
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
C1SizerLightEventHandler Members
C1.Win.C1Sizer Namespace

197