MultiRow Windows Forms Developer's Guide 1 Developer's Guide This guide provides information about using MultiRow for Windows Forms. System Requirements Notational Conventions Installation and Redistribution Licensing the Product Technical Support End-User License Agreement About MultiRow Using MultiRow Limitations Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 2 1 Table of Contents Developer's Guide 1 1. Table of Contents 2-11 System Requirements 12-13 Notational Conventions 14-15 Installation and Redistribution 16 Technical Support 17 Licensing the Product 18 End-User License Agreement 19 About MultiRow 20 Product Overview 20-21 Product Structure 21 Main Features 21-24 Feature Comparison 24-26 What's New 26 What's New in the Designer 27-33 What's New in the Grid Control 33-38 New Cell Types 38-40 Breaking Changes 40 Compatibility with the Previous Version 40 Breaking Changes from 6.0 40-42 Co-existence and Migration from the Previous Version 42 Coexistence with the Previous Version 42-43 Migration from the Previous Version 43-44 Using MultiRow 45 MultiRow Architecture 45 Basic Concepts 45-48 Template Structure 48-50 Template File 50-51 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 3 Cell Structure 51-56 Format String 56 Quick Start 56-57 Adding MultiRow Component and Template to the Project 57-61 Adding the MultiRow Component to a Visual Studio 2013 Project 61-65 Creating an Application using GcMultiRow 65-66 Connecting to SQL Server Database 66-73 Creating an Application Using the Designer (Grid View) 73-81 Creating an Application Using the Designer (Single Template View) 81-89 Designer Window 89 Integration with IDE 89-90 Document Window 90-91 Toolbox 91-92 Menu Bar 92-93 Toolbar 93 Status Bar 93-94 Properties Window 94 Template Property List 7.0 94-97 Template Explorer 7.0 97-98 Template - Named Cell Styles 7.0 98-99 Designer Options 99-102 Using the Designer 102-103 Changing Height and Width of a Row in Designer 103 Working with Column Headers in the Designer 103-104 Working with Column Footers in the Designer 104 Adding Cells in the Designer 104-105 Replacing Cells in the Designer 105-106 Moving Cells in the Designer 106 Copying Cells in the Designer 106-107 Selecting Cells in the Designer 107-108 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 4 Resizing Cells in the Designer 108 Get or Set Cell Properties in the Designer 108-109 Changing Cell Index in the Designer 109-110 Undo Changes in Designer 110-111 Locking Cells in the Designer 111 Changing Tab Order of Cells in the Designer 111-112 Display Modes of the Designer 112-113 Cell Display Modes in the Designer 113-114 Layout Modes of the Designer 114-115 Setting the Column Mode Template in the Designer 115 Advanced Designer Features 115-116 Create Template using Wizard 116-118 Create Template from Data Sources Window 118-120 Create Template from Table 120-125 Create Templates Using Tracing Mode 125-126 Adjust Character Size with Placeholders 126-127 Template Localization 127-130 Hints for using the Designer 131-132 Conversion from DataGridView 132-136 Using Annotations 136-138 Template 138 Adding Cells 138-139 Adding Column Headers 139-140 Adding Column Footers 140-142 Template Width and Height 142-144 Column Mode Template 144-148 Grid 148-149 Assigning and Allocating a Template 149-150 Edit Modes 150-153 Selection Mode 153-156 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 5 View Modes 156-159 Scrolling 159-162 Visual Style 162-163 Zooming 163-166 Splitter Line and ViewPort 166-169 Context Menu 169-171 Shortcut Keys 171-176 Resizing 176-177 Retrieving the Method Used to Move Cells 177-178 Automatic Merging of Cells 178-180 Displaying a New Row at the Top 180-181 Expanding Or Collapsing Columns 181-182 Automatic Adjustment of the Cell Width 182-183 Points to Note with Default Settings 183-185 Tips on Improving the Performance 185-189 Headers 189 Selecting Cells using Headers 189-190 Filtering Rows using the Column Headers 190-194 Sorting Rows using Column Headers 194-197 Changing the Header Appearance 197-198 Using Row Headers 198-199 Cell Types 199-200 Base Cell 200-201 HeaderCell 201-203 Change BackColor (HeaderCell) 203-204 ColumnHeaderCell 204-206 RowHeaderCell 206-208 CornerHeaderCell 208 TextBoxCell 208-212 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 6 Input Line Break (TextBoxCell) 212-213 How to Use KeyDown Event (TextBoxCell) 213-214 Display Vertical Scroll Bar (TextBoxCell) 214-215 ButtonCell 215-218 Change BackColor (ButtonCell) 218-219 Handling User Click (ButtonCell) 219-220 Display String (ButtonCell) 220-221 Using Button Commands (ButtonCell) 221-222 CheckBoxCell 222-224 Refer to Editing Value when Modifying TrueValue and FalseValue 224-225 (CheckBoxCell) Detect Value Change (CheckBoxCell) 225 ComboBoxCell 225-229 Get Index Of Selected Value (ComboBoxCell) 229-230 How to Use SelectedIndexChanged Event (ComboBoxCell) 230-231 MaskedTextBoxCell 231-235 DateTimePickerCell 235-239 Display Alternate Text for Null Values (DateTimePickerCell) 239-240 Hide Drop-Down Button (DateTimePickerCell) 240-241 Get Formatted Values (DateTimePickerCell) 241-242 Automatically Confirm Initial Value as Input Value (DateTimePickerCell) 242 Usage of ValueChanged Event (DateTimePickerCell) 242-243 NumericUpDownCell 243-246 Displaying Negative Values in Red (NumericUpDownCell) 246-248 Hiding Spin Button (NumericUpDownCell) 248-249 Displaying Numeric Value Separator (NumericUpDownCell) 249-250 DomainUpDownCell 250-253 LabelCell 253-255 Handling User Click (LabelCell) 255-256 Display String (LabelCell) 256-257 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 7 LinkLabelCell 257-259 Open Link in Associated Browser (LinkLabelCell) 259 ImageCell 259-261 Display Alternate Image for Empty Value (ImageCell) 261-262 Handle User Click (ImageCell) 262-263 Display Image (ImageCell) 263 ProgressBarCell 263-266 RichTextBoxCell 266-269 RadioGroupCell 269-272 Detect Value Changed (RadioGroupCell) 272-273 ListBoxCell 273-275 ListLabelCell 275-277 Setting Bullets (ListLabelCell) 277-278 ShapeCell 278-280 Setting Shapes (ShapeCell) 280-281 Pop-upCell 282-284 Select Color (Pop-upCell) 284-285 SummaryCell 285-288 Show Column Sum in Footer (SummaryCell) 288-290 Displaying an Error Icon for Data Errors (SummaryCell) 290-291 Create Statement of Account (SummaryCell) 291-294 PrintInfoCell 294-296 TrackBarCell 296-299 FilteringTextBoxCell 299 User-Defined Cell 299-302 Register User Defined Cell in ToolBox 302 Rows and Cells 302-303 Current Row 303-304 Current Cell 304-305 Adding Rows 305-307 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 8 Deleting Rows 307-309 Getting and Setting the Row Count 309-310 Freezing Rows 310-312 Selected Rows and Cells 312-314 Restricting Cell Selection 314-315 Disabled Cells 315 Hiding Cells and Rows 315-317 Editing Cells 317-319 Displaying Error Messages 319-320 Read-Only Cells 320-321 Cell Note 321-325 Column Mode 325 Current Column 325-326 Adding Columns 326-329 Deleting Columns 329-332 Column Operation 332-334 Managing Data 334-335 Get and Set Data 335-338 Data Binding Modes 338-340 Sorting Data 340-343 Working with Clipboard 343-344 Set Default Value in New Row 344-345 Cell Styles 345 Rules for Applying Styles 345-347 Borders 347-350 BackColor and ForeColor 350-352 Background Pattern 352-354 Background Gradation 354-356 Tag 356-358 Image 358-359 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 9 Margins and Padding 359-360 Multiline and Word Wrap 360-361 Text Formatting 361-362 Text Indent 362-363 GDI+ Compatibility Mode 363-366 Mouse Hover Styles 366-367 User-defined Word Wrap 367-368 Customizing the Justification of Single-byte Characters 368-369 Conditional Cell Styles 369 Types of Cell Styles 369-371 Manage Cell Styles with Names 371-374 Changing Cell Styles based on Conditions 374-376 Combining Multiple Styles 376-377 User Defined Conditional Styles 377-378 Manage Cell Styles with Names 378-382 User Input Validation 382 Validation using Control Events 382-383 Value Validation by Cell 383 Validation 383-384 Built-in Cell Validators 384 RangeValidator 384-387 IncludeListValidator 387-388 RequiredTypeValidator 388-390 RequiredFieldValidator 390-391 ExcludeListValidator 391-392 CompareCellValidator 392-393 CompareValueValidator 393-394 PairCharValidator 394-396 SurrogateCharValidator 396-397 Copyright © GrapeCity, inc. All rights reserved. MultiRow Windows Forms Developer's Guide 10 RegularExpressionValidator 397-398 CompareStringValidator 398-399 TextLengthValidator 399-400 EncodingValidator 400-401 Built-in Validation Actions 401 Notification using Underline (LineNotify) 401-402 Notification using CellStyle (CellStyleNotify) 402-403 Notification using Icon (IconNotify) 403-404 Notification using Sound (SoundNotify) 404-405 TipNotify 406-407 Notification using Focus Change (FocusProcess) 407-408 ValueProcess 408-409 Notification using Message Box (MessageBoxNotify) 409-410 Notification using Three-State Icon 410-411 Customizing the Validation Information 411-412 User-Defined Cell Validator 412-413 User Defined Validation Actions 413-416 Connecting to Database 416-419 Print and Print Preview 419-420 Simple Printing 420-421 Custom Printing 422 Print Style 422-424 Paging Mode 424-425 Specify Print Range 425-426 Specifying the