Professional Documents
Culture Documents
Internet:
info@ComponentOne.com
Web site:
http://www.componentone.com
Sales
E-mail: sales@componentone.com
Telephone: 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 original CD (or diskettes) are 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
CD (or disk) 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 a defective CD (or disk) by sending it and a check for $25 (to cover postage and
handling) to ComponentOne.
Except for the express warranty of the original CD (or disks) 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. We are 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
ComponentOne Sizer for WinForms Overview ............................................................................... 3
Help with ComponentOne Studio for WinForms ........................................................................ 3
Migrating a C1Sizer Project to Visual Studio 2005 ...................................................................... 3
Key Features .................................................................................................................................. 8
Design-Time Support ..................................................................................................................... 9
C1Sizer Smart Tag ...................................................................................................................... 9
C1SizerLight Smart Tag............................................................................................................. 11
C1Sizer Context Menus ............................................................................................................ 11
C1Sizer Grid Editor ................................................................................................................... 12
C1Sizer Gradient Editor ............................................................................................................ 14
Using the C1SizerLight Component .............................................................................................. 16
Quick Start Tutorial .................................................................................................................. 16
Using the C1Sizer Control ............................................................................................................ 22
Tutorial 1: Set up the grid, then add the controls ..................................................................... 23
Tutorial 2: Add the controls, then set up the grid ..................................................................... 31
Sizer for WinForms Samples ........................................................................................................ 34
Sizer for WinForms Task-Based Help ............................................................................................ 36
Add a C1SizerLight Component to a Form in code .................................................................... 36
Position Controls on the C1Sizer Grid at Run Time ................................................................... 38
Create a Three Dimensional Border for the Rows and Columns ................................................ 39
Store Layout Information for the C1Sizer Control ..................................................................... 41
C1.Win.C1Sizer.4 Assembly.......................................................................................................... 43
Overview ................................................................................................................................. 43
Namespaces ............................................................................................................................ 43
C1.Win.C1Sizer Namespace.................................................................................................. 43
Overview ......................................................................................................................... 43
Classes ............................................................................................................................. 45
Enumerations................................................................................................................. 167
Structures ...................................................................................................................... 172
See Also
Help with ComponentOne Studio for WinForms
Migrating a C1Sizer Project to Visual Studio 2005
Getting Started
For information on installing ComponentOne Studio for WinForms, licensing, technical support,
namespaces and creating a project with the control, please visit Getting Started with Studio for
WinForms.
What's New
For a list of the latest features added to ComponentOne Studio for WinForms, visit What's New in
Studio for WinForms.
See Also
Migrating a C1Sizer Project to Visual Studio 2005
3.
Click Next.
4.
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
9.
10.
11.
12.
13.
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 files.
See Also
Key Features
Key Features
ComponentOne Sizer for WinForms includes the following features:
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.
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 design-time
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
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.
About C1Sizer
Clicking on the About item displays the About ComponentOne 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.
See Also
C1SizerLight Smart Tag
10
About C1Sizer
Clicking on the About item displays the About ComponentOne C1Sizer dialog box, which is
helpful in finding the version number of C1Sizer and online resources.
See Also
C1Sizer Context Menus
Description
About
Displays the About ComponentOne C1Sizer dialog box, which is helpful in finding
C1Sizer
Edit Grid
Edit
Gradient
11
Auto Grid
Clears all unused bands in the grid that don't have any controls attached to them.
Clear Grid
The following table provides a brief description of the custom commands added by C1SizerLight:
Commands
Description
About
Displays the About ComponentOne C1Sizer dialog box, which is helpful in finding
C1Sizer
See Also
C1Sizer Grid Editor
12
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
Add
Delete
Even
13
Clear
Auto
OK
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
See Also
C1Sizer Gradient Editor
14
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
Gradient.BackColor2
GradientMode
15
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.
See Also
Using the C1SizerLight Component
See Also
Quick Start Tutorial
16
Now run the project and resize the form. If you make it smaller, parts of the controls will be clipped.
17
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.
18
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:
1.
19
2.
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
Copy Code
20
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
21
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
22
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
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. The
23
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:
24
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 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
25
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.
26
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.
Setting up a splitter
28
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.
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.
29
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).
30
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
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
31
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.
5.
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:
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
32
below (note the fixed rows are highlighted in red in the designer):
6.
Select OK.
The designer highlights the fixed rows in red.
33
See Also
Sizer for WinForms Samples
Description
SizerTutorial1 Demonstrates how to set up the grid and add controls. This sample uses the C1Sizer
34
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.
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
35
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
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
36
Visual Basic
Copy Code
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
Copy Code
37
{
C1SizerLight szl = new C1SizerLight(c);
szl.SetAutoResize(f, true);
}
See Also
Position Controls on the C1Sizer Grid at Run Time
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
38
Rectangle
Return Rectangle.Intersect(c1Sizer1.Grid.Rows(row).Bounds,
c1Sizer1.Grid.Columns(col).Bounds)
End Function
To write code in C#
C#
Copy Code
See Also
Create a Three Dimensional Border for the Rows and Columns
39
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
Copy Code
40
ControlPaint.DrawBorder3D(e.Graphics, rccel,
Border3DStyle.Etched);
}
}
}
See Also
Store Layout Information for the C1Sizer Control
Copy Code
41
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++)
{
c1Sizer1.Controls[i].Bounds = (Rectangle)_ctlPositions[i];
}
}
}
42
C1.Win.C1Sizer.4 Assembly
Overview
Namespaces
Namespace
Description
C1.Win.C1Sizer
Namespaces
C1.Win.C1Sizer Namespace
Overview
Classes
Class
Description
Band
Abstract class that serves as a base for the Row and Column classes.
BandCollection
Border
C1Sizer
C1SizerEventArgs
43
C1SizerLight
Component that resizes all controls on a form when the form is resized.
ColumnCollection
Gradient
Grid
Row
RowCollection
Structures
Structure
Description
Corners
Delegates
Delegate
Description
C1SizerEventHandler
Enumerations
44
Enumeration
Description
AutoSizeEnum
GradientMode
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
C#
public abstract class Band
Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Band
C1.Win.C1Sizer.Column
C1.Win.C1Sizer.Row
45
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
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
46
See Also
Reference
Band Members
C1.Win.C1Sizer Namespace
Members
Properties
Public Properties
Name
Description
Bounds
Index
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
Top
See Also
Reference
Band Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see Band members.
Public Properties
47
Name
Description
Bounds
Index
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
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)
Public ReadOnly Property Bounds As Rectangle
C#
public Rectangle Bounds {get;}
Remarks
48
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
Band Class
Band Members
49
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).
50
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
51
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.
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
52
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
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
53
BandCollection Members
C1.Win.C1Sizer Namespace
Members
Properties Methods
Public Properties
Name
Description
Count
Top
Public Methods
Name
Description
Insert
Remove
SetSizes
Top
See Also
Reference
BandCollection Class
C1.Win.C1Sizer Namespace
Methods
For a list of all members of this type, see BandCollection members.
Public Methods
Name
Description
54
Insert
Remove
SetSizes
Top
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
55
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.
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
56
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 _
)
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
57
See Also
Reference
BandCollection Class
BandCollection Members
Properties
For a list of all members of this type, see BandCollection members.
Public Properties
Name
Description
Count
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
58
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
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
59
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
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
Public Properties
60
Name
Description
Color
Gets or sets the Color used to draw the border around the control.
Corners
Thickness
Top
See Also
Reference
Border Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see Border members.
Public Properties
Name
Description
Color
Gets or sets the Color used to draw the border around the control.
Corners
Thickness
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.
61
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
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
62
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
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)
63
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
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
64
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.
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
Members
Properties Methods Events
Public Constructors
Name
Description
Public Properties
Name
Description
AccessibilityObject
66
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
AutoSizeMode
BackColor
BackgroundImage
BackgroundImageLayout
BindingContext
Border
Bottom
Bounds
CanFocus
CanSelect
Capture
CausesValidation
67
ClientRectangle
ClientSize
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
Dock
Enabled
Focused
Gradient
68
Grid
Handle
HasChildren
Height
Image
ImageAlignment
ImageScaling
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
LayoutEngine
Left
Location
Margin
69
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
Site
Size
SplitterWidth
TabIndex
TabStop
70
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
Public Methods
Name
Description
AddControl
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
71
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetCellAtPoint
GetCellBounds
GetChildAtPoint
GetContainerControl
GetControlAtCell
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
72
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
73
Update
Top
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
CausesValidationChanged
ChangeUICues
Click
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
74
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
GiveFeedback
GotFocus
HandleCreated
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
75
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
MouseClick
MouseDoubleClick
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
76
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
SizeChanged
SplitterMoved
SplitterMoving
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextChanged
77
Validated
Validating
VisibleChanged
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()
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
For a list of all members of this type, see C1Sizer members.
78
Public Methods
Name
Description
AddControl
BeginInvoke
BringToFront
Contains
CreateControl
CreateGraphics
CreateObjRef
Dispose
DoDragDrop
DrawToBitmap
EndInvoke
FindForm
Focus
GetCellAtPoint
GetCellBounds
79
GetChildAtPoint
GetContainerControl
GetControlAtCell
GetLifetimeService
GetNextControl
GetPreferredSize
Hide
InitializeLifetimeService
Invalidate
Invoke
PerformLayout
PointToClient
PointToScreen
RectangleToClient
RectangleToScreen
Refresh
80
ResetText
ResumeLayout
Scale
Select
SelectNextControl
SendToBack
SetBounds
Show
SuspendLayout
ToString
Update
Top
See Also
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
81
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
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 _
82
)
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
See Also
Reference
83
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.
Requirements
84
See Also
Reference
C1Sizer Class
C1Sizer Members
Overload List
GetCellAtPoint Method
Gets the cell at a given point on the control's client area.
Overload List
Overload
Description
GetCellAtPoint(Point)
GetCellAtPoint(Int32,Int32) Gets the cell at a given point on the control's client area.
Requirements
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
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
86
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.
87
Overload List
Overload
Description
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
88
C#
public Rectangle GetCellBounds(
int row,
int col,
int rowSpan,
int colSpan
)
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.
89
Syntax
Visual Basic (Declaration)
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
90
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
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
91
See Also
Reference
C1Sizer Class
C1Sizer Members
ResumeLayout Method
Resumes normal layout logic.
Overload List
Overload
Description
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
ResumeLayout() Method
Resumes normal layout logic.
Syntax
Visual Basic (Declaration)
Public Overloads Shadows Sub ResumeLayout()
C#
92
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
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
93
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()
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
For a list of all members of this type, see C1Sizer members.
Public Properties
94
Name
Description
AccessibilityObject
AccessibleName
AccessibleRole
AllowDrop
Anchor
AutoScrollOffset
AutoSizeMode
BackColor
BackgroundImage
BackgroundImageLayout
BindingContext
Border
Bottom
Bounds
95
CanFocus
CanSelect
Capture
CausesValidation
ClientRectangle
ClientSize
CompanyName
Container
ContainsFocus
ContextMenu
ContextMenuStrip
Controls
Created
Cursor
DataBindings
DisplayRectangle
Disposing
96
Dock
Enabled
Focused
Gradient
Grid
Handle
HasChildren
Height
Image
ImageAlignment
ImageScaling
ImeMode
InvokeRequired
IsAccessible
IsDisposed
IsHandleCreated
IsMirrored
97
LayoutEngine
Left
Location
Margin
MaximumSize
MinimumSize
Name
Padding
Parent
PreferredSize
ProductName
ProductVersion
RecreatingHandle
Region
Right
RightToLeft
Site
98
Size
SplitterWidth
TabIndex
TabStop
Tag
Text
Top
TopLevelControl
UseWaitCursor
Visible
Width
Top
See Also
Reference
C1Sizer Class
C1.Win.C1Sizer Namespace
AutoSizeMode Property
Gets or sets the layout mode for the C1Sizer control.
Syntax
Visual Basic (Declaration)
99
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
Reference
C1Sizer Class
C1Sizer Members
100
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
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
101
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
C#
102
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
103
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
104
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
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)
105
Remarks
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
For a list of all members of this type, see C1Sizer members.
Public Events
Name
Description
BackColorChanged
BackgroundImageChanged
CausesValidationChanged
ChangeUICues
106
Click
ClientSizeChanged
ContextMenuChanged
ContextMenuStripChanged
ControlAdded
ControlRemoved
CursorChanged
Disposed
DockChanged
DoubleClick
DragDrop
DragEnter
DragLeave
DragOver
EnabledChanged
Enter
FontChanged
ForeColorChanged
107
GiveFeedback
GotFocus
HandleCreated
HandleDestroyed
HelpRequested
ImeModeChanged
Invalidated
KeyDown
KeyPress
KeyUp
Layout
Leave
LocationChanged
LostFocus
MarginChanged
MouseCaptureChanged
MouseClick
MouseDoubleClick
108
MouseDown
MouseEnter
MouseHover
MouseLeave
MouseMove
MouseUp
MouseWheel
Move
PaddingChanged
Paint
ParentChanged
PreviewKeyDown
QueryAccessibilityHelp
QueryContinueDrag
RegionChanged
Resize
RightToLeftChanged
SizeChanged
109
SplitterMoved
SplitterMoving
StyleChanged
SystemColorsChanged
TabIndexChanged
TabStopChanged
TextChanged
Validated
Validating
VisibleChanged
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
110
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.
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
111
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.
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#
112
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
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
113
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
Public Properties
Name
Description
Band
Gets a reference to the band (row or column) that caused the event.
Top
See Also
Reference
C1SizerEventArgs Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see C1SizerEventArgs members.
Public Properties
114
Name
Description
Band
Gets a reference to the band (row or column) that caused the event.
Top
See Also
Reference
C1SizerEventArgs Class
C1.Win.C1Sizer Namespace
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
115
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
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
116
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
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.
117
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
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.
118
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
Members
Properties Methods Events
Public Constructors
Name
Description
119
Top
Public Properties
Name
Description
Container
Enabled
Determines whether the C1SizerLight should resize the controls on the form
when the form is resized.
ResizeFonts
Site
Top
Public Methods
Name
Description
CreateObjRef
Dispose()
GetAutoResize
GetLifetimeService
ToString
Top
120
Public Events
Name
Description
Disposed
ResizingControl
Fires before the C1SizerLight resizes a control in response to the form being
resized.
ResizingFont
Fires before the C1SizerLight resizes the font in a control in response to the
form being resized.
Top
See Also
Reference
C1SizerLight Class
C1.Win.C1Sizer Namespace
C1SizerLight Constructor
Overload List
Overload
Description
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
121
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
See Also
Reference
C1SizerLight Class
C1SizerLight Members
Overload List
C1SizerLight Constructor()
Initializes a new instance of a C1SizerLight.
122
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
For a list of all members of this type, see C1SizerLight members.
Public Methods
Name
Description
CreateObjRef
Dispose()
GetAutoResize
GetLifetimeService
123
SetAutoResize
ToString
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
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
124
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
C1SizerLight Class
C1SizerLight Members
Properties
For a list of all members of this type, see C1SizerLight members.
125
Public Properties
Name
Description
Container
Enabled
Determines whether the C1SizerLight should resize the controls on the form
when the form is resized.
ResizeFonts
Site
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#
public bool Enabled {get; set;}
Remarks
This property has no effect at design time. Child controls are automatically resized at run time only.
126
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
C1SizerLight Class
C1SizerLight Members
127
Events
For a list of all members of this type, see C1SizerLight members.
Public Events
Name
Description
Disposed
ResizingControl
Fires before the C1SizerLight resizes a control in response to the form being
resized.
ResizingFont
Fires before the C1SizerLight resizes the font in a control in response to the
form being resized.
Top
See Also
Reference
C1SizerLight Class
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
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.
128
Property
Description
Cancel
Control
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#
129
Event Data
The event handler receives an argument of type C1SizerLightEventArgs containing data related to
this event. The following C1SizerLightEventArgs properties provide information specific to this
event.
Property
Description
Cancel
Control
Remarks
By default, C1SizerLight will resize all child controls on a form and will also update their fonts when
the form is resized.
In some cases, you may want to prevent the C1SizerLight from resizing the font for certain controls
on the form. For example, scrollable controls often don't need font resizing. When their dimensions
change, the user can still scroll to view their contents.
Example
For example, the code below prevents the C1SizerLight from resizing the font on any controls that
are not Buttons:
C#
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
130
Reference
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.
131
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
Members
Properties
Public Properties
Name
Description
132
Cancel
Control
Top
See Also
Reference
C1SizerLightEventArgs Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see C1SizerLightEventArgs members.
Public Properties
Name
Description
Cancel
Control
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)
133
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
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
134
Column
Represents a column in the Sizer grid.
Object Model
Syntax
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
135
Syntax
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
Members
Properties Methods
Public Properties
Name
Description
Bounds
136
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
Top
Public Methods
Name
Description
ToString
Top
See Also
Reference
Column Class
C1.Win.C1Sizer Namespace
Methods
For a list of all members of this type, see Column members.
Public Methods
Name
Description
ToString
Top
See Also
137
Reference
Column Class
C1.Win.C1Sizer Namespace
ToString Method
Returns a string representation of the Column object.
Syntax
Visual Basic (Declaration)
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
For a list of all members of this type, see Column members.
Public Properties
Name
Description
Bounds
138
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
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.
139
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
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
140
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
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
141
See Also
Reference
ColumnCollection Members
C1.Win.C1Sizer Namespace
Members
Properties Methods
Public Properties
Name
Description
Count
Item
Top
Public Methods
Name
Description
Insert
Remove
SetSizes
Top
See Also
Reference
142
ColumnCollection Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see ColumnCollection members.
Public Properties
Name
Description
Count
Item
Top
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
143
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
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
144
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#
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
145
Members
Properties
Public Properties
Name
Description
BackColor2
Gets or sets the secondary color used to build the background gradient.
Blend
Center
Top
See Also
Reference
Gradient Class
C1.Win.C1Sizer Namespace
Properties
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
146
Center
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
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
147
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
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
148
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
Reference
Gradient Class
Gradient Members
Mode Property
Gets or sets the GradientMode used to paint the background.
Syntax
Visual Basic (Declaration)
149
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#
public class Grid
Inheritance Hierarchy
System.Object
C1.Win.C1Sizer.Grid
Requirements
150
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
See Also
Reference
151
Grid Members
C1.Win.C1Sizer Namespace
Members
Properties Methods
Public Properties
Name
Description
Columns
DraggingSplitter
Rows
Gets a reference to the RowCollection that contains the rows in the layout
grid.
SelectedObjects
Sizer
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
Reference
152
Grid Class
C1.Win.C1Sizer Namespace
Methods
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
You will rarely have to call this method from your code. It is more commonly used internally (at
design time) by the grid designer.
153
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
For a list of all members of this type, see Grid members.
Public Properties
154
Name
Description
Columns
DraggingSplitter
Rows
Gets a reference to the RowCollection that contains the rows in the layout
grid.
SelectedObjects
Sizer
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
155
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;}
156
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
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)
157
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
158
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
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
159
Reference
Row Members
C1.Win.C1Sizer Namespace
Members
Properties Methods
Public Properties
Name
Description
Bounds
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
Top
Public Methods
Name
Description
ToString
Top
See Also
Reference
160
Row Class
C1.Win.C1Sizer Namespace
Methods
For a list of all members of this type, see Row members.
Public Methods
Name
Description
ToString
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
161
See Also
Reference
Row Class
Row Members
Properties
For a list of all members of this type, see Row members.
Public Properties
Name
Description
Bounds
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
Top
See Also
Reference
Row Class
C1.Win.C1Sizer Namespace
Size Property
Gets or sets the height of the Row in pixels.
Syntax
162
Remarks
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)
163
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
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
164
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
RowCollection Members
C1.Win.C1Sizer Namespace
Members
Properties Methods
Public Properties
Name
Description
Count
Item
Top
Public Methods
Name
Description
Insert
165
Remove
SetSizes
Top
See Also
Reference
RowCollection Class
C1.Win.C1Sizer Namespace
Properties
For a list of all members of this type, see RowCollection members.
Public Properties
Name
Description
Count
Item
Top
See Also
Reference
RowCollection Class
C1.Win.C1Sizer Namespace
Item Property
Gets the Row object at a given index in the collection.
Syntax
166
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
RowCollection Class
RowCollection Members
Enumerations
AutoSizeEnum
Represents the possible sizing modes.
Syntax
Visual Basic (Declaration)
Public Enum AutoSizeEnum
Inherits System.Enum
C#
public enum AutoSizeEnum : System.Enum
167
Members
Member
Description
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
168
Member
Description
DiagonalDown
DiagonalUp
Horizontal
None
No gradient.
Radial
Vertical
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
169
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
170
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
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
171
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.
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
172
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
173
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
Members
Properties Methods
Public Constructors
Name
Description
Public Properties
Name
Description
Empty
174
IsEmpty
LeftBottom
LeftTop
RightBottom
RightTop
Top
Public Methods
Name
Description
Equals
GetHashCode
Top
Public Operators
Equality
Top
See Also
Reference
Corners Structure
C1.Win.C1Sizer Namespace
175
Corners Constructor
Overload List
Overload
Description
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
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 _
176
)
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
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.
177
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
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
For a list of all members of this type, see Corners members.
Public Methods
Name
Description
Equals
178
current Corners.
GetHashCode
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)
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
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
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.
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
For a list of all members of this type, see Corners members.
Public Properties
180
Name
Description
Empty
IsEmpty
LeftBottom
LeftTop
RightBottom
RightTop
Top
See Also
Reference
Corners Structure
C1.Win.C1Sizer Namespace
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
181
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
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#
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 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
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
183
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
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
184
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.
c2
A Corners to test.
Return Value
true if the two Corners objects are equal; otherwise, false.
Requirements
185
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
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
Reference
Corners Structure
Corners Members
186
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
Reference
187
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
188
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
189