Spread for ASP.NET Developer’s Guide 0 Developer's Guide This guide provides introductory conceptual material and how-to explanations for routine tasks for developers using Spread for ASP.NET. It describes how an application developer would use the properties and methods in Spread to create spreadsheets and grids on Web Forms, bind to databases, and customize the component for your application. Getting Started Understanding the Product Working with the Spread Designer Customizing the Appearance Customizing User Interaction Customizing with Cell Types Managing Data Binding Managing Data in the Component Managing Formulas Managing File Operations Using Sheet Models Maintaining State Working with the Chart Control Using Touch Support with the Component For complete API reference information, refer to the Assembly Reference (on-line documentation). For a complete list of documentation, refer to the Spread for ASP.NET Documentation (on-line documentation). Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 1 1 Table of Contents Developer's Guide 0 1. Table of Contents 1-15 Getting Started 16 Handling Installation 16 Installing the Product 16 Licensing a Trial Project after Installation 16 End-User License Agreement 16-17 Creating a Build License 17-18 Handling Redistribution 18-20 Product Requirements 20 Handling Variations In Windows Settings 20 Working with the Component 20-21 Adding a Component to a Web Site using Visual Studio 2015 or 2017 21-23 Adding JavaScript IntelliSense for Visual Studio 2015 or 2017 23-25 Understanding Browser Support 25-27 Understanding Parts of the Component Interface 27-28 Working with Collection Editors 28 Working with Web Parts 28-29 Working with Windows Azure 29 Working with Microsoft ASP.NET MVC 5 29-33 Working with Microsoft ASP.NET MVC 3 33-37 Copying Shared Assemblies to Local Folder 37-38 Working with Strongly Typed Data Controls 38 Getting More Practice 38 Understanding Procedures in the Documentation 38-40 Getting Technical Support 40 Understanding the Spread Wizard 40 Starting the Spread Wizard 40-41 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 2 Using the Spread Wizard 41-42 Tutorial: Creating a Checkbook Register 42 Adding Spread to the Checkbook Project 42 Adding Spread to a Project 42-44 Setting Up the Rows and Columns of the Register 44-46 Setting the Cell Types of the Register 46-48 Adding Formulas to Calculate Balances 48-49 Understanding the Product 50 Product Overview 50-51 Features Overview 51-52 AJAX Support 52 ASP.NET AJAX Extenders 52-53 Built-In Functions 53 Cell Types 53-54 Chart Control 54 Client-Side Scripting 54 Conditional Formatting 54 Context Menu 54 Corner Customization 54-55 Customized Appearance (Skins) 55 Data Binding 55 Footers for Columns or Groups 55 Frozen Rows and Columns 55 Goal Seeking 55 Grouping 55 Headers with Multiple Columns and Rows 55 Hierarchical Display 55-56 Import and Export Capabilities 56 Load on Demand 56 Multiple-Line Columns 56 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 3 Multiple Sheets 56 PDF Support 56 Printing 56-57 Row Filtering 57 Row Preview 57 Row Template Editor 57 Searching Features 57 Sorting Capabilities 57 Spannable Cells 57 Sparklines 57 Spread Designer 57-58 Spread Wizard 58 Theme Roller 58 Title and Subtitle 58 Touch Support 58 Validation Controls 58 Concepts Overview 58 Shortcut Objects 58-60 Object Parentage 60 Underlying Models 61-62 Cell Types 62 SheetView versus FpSpread 62 Formatted versus Unformatted Data 62-63 Zero-Based Indexing 63 Client-Side Scripting 63 Maintaining State 63 Namespaces Overview 64 Working with the Spread Designer 65 Starting the Spread Designer 65 Understanding the Spread Designer Interface 65-66 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 4 Spread Designer Menus 66-67 File Menu 67-68 Home Menu 68 Insert Menu 68-69 Data Menu 69 View Menu 69 Settings Menu 69-70 Chart Tools Menu 70 Sparklines Menu 70 Spread Designer Toolbars 70-71 Spread Designer Editors 71 Alternating Rows Editor 71-72 Cells, Columns, and Rows Editor 72-73 ContextMenu Collection Editor 73-76 DataKey Names (String Collection) Editor 76-77 Formula Editor 77-78 GroupInfo Collection Editor 78-79 Header Editor 79-80 NamedStyle Collection Editor 80-81 Row Template Editor 81-82 SheetSkin Editor 82-83 SheetView Collection Editor 83-84 Spread Designer Context Menus 84-85 Using the Spread Designer 85-86 Customizing Sheets, Rows, and Columns in Spread Designer 86-87 Customizing Cells in Spread Designer 87-89 Adding Formulas to Cells 89-91 Saving and Opening Design Files 91-92 Applying Changes and Closing Spread Designer 92 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 5 Customizing User Interaction 93 Customizing Interaction with the Overall Component 93 Displaying Scroll Bars 93-94 Displaying Scroll Bar Text Tips 95 Customizing the Scroll Bar Colors 95-96 Allowing Load on Demand 96-98 Customizing Interaction Based on Events 98 Handling the Tab Key 98 Customizing the Graphical Interface 99-100 Searching for Data with Code 100-101 Adding a Context Menu 101-103 Working with AJAX 103 Enabling AJAX support 103-104 Using ASP.NET AJAX Extenders 104-105 Customizing the Toolbars 105 Customizing the Command Bar on the Component 105-107 Customizing the Command Buttons 107-110 Changing the Command Button Images 110-112 Hiding a Specific Command Button 112-113 Displaying the Sheet Names 113-115 Customizing Page Navigation 115-118 Customizing Page Navigation Buttons on the Client 118-119 Customizing the Hierarchy Bar 119-120 Customizing Interaction with Rows and Columns 120 Allow the User to Move Columns 120-121 Allowing the User to Resize Rows or Columns 121-122 Freezing Rows and Columns 122-123 Setting up Row Edit Templates 123-124 Setting up Preview Rows 124-125 Managing Filtering of Rows of User Data 125-126 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 6 Creating Filtered Rows and Setting the Appearance 126-130 Customizing Simple Filtering of Rows of User Data 130 Using Row Filtering 130-131 Customizing the List of Filter Items 131-132 Creating a Completely Custom Filter 132-133 Using Enhanced Filtering 133-135 Using the Filter Bar 135-138 Customizing Grouping of Rows of User Data 138 Using Grouping 138-139 Allowing the User to Group Rows 139-140 Setting the Appearance of Grouped Rows 140-142 Customizing the Group Bar 142-143 Creating a Custom Group 143 Compatibility with Other Features 143-144 Customizing Sorting of Rows of User Data 144-145 Allowing User Sorting 145-146 Customizing Interaction with Cells 146 Adding a Note to a Cell 146-147 Adding a Tag to a Cell 147-149 Locking a Cell 149-151 Using Conditional Formatting in Cells 151 Creating Conditional Formatting with Rules 151-152 Color Scale Rules 152-153 Data Bar Rule 153-155 Highlighting Rules 155-157 Icon Set Rule 157-158 Top or Average Rules 158-159 Conditional Formatting of Cells 159-160 Customizing Selections of Cells 160 Specifying What the User Can Select 160-162 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 7 Working with Selections of Cells 162-163 Customizing the Appearance of Selections 163-164 Managing Printing 164 Printing a Spreadsheet 164-165 Adding Headers and Footers to Printed Pages 165 Customizing the Appearance 166 Customizing the Appearance of the Overall Component 166 Customizing the Dimensions of the Component 166-167 Customizing the Outline of the Component 167-168 Customizing the Default Initial Appearance 168-169 Resetting Parts of the Interface 169-170 Using the jQuery Theme Roller with Spread 170-171 Customizing the Appearance of the Sheet 171-172 Working with the Active Sheet 172 Working with Multiple Sheets 172-173 Adding a Sheet 173-174 Removing a Sheet 174-175 Showing or Hiding a Sheet 175-176 Setting the Background Color of the Sheet 176-177 Adding a Title and Subtitle to a Sheet 177-178 Customizing the Page Size (Rows to Display) 178-180 Displaying Grid Lines on the Sheet 180-181 Customizing the Sheet Corner 181-183 Displaying a Footer for Columns or Groups 183-187 Creating a Skin for Sheets 187-189 Applying a Skin to a Sheet 189-190 Customizing the Appearance of Rows and Columns 190 Customizing the Number of Rows or Columns 190-191 Adding a Row or Column 191-192 Copyright © GrapeCity, Inc. All rights reserved. Spread for ASP.NET Developer’s Guide 8 Removing a Row or Column 192-194 Showing or Hiding Rows or Columns 194-195 Setting the Row Height or Column Width 195-196 Setting the Top Row to Display 196-197 Creating Alternating Rows 197-198 Creating Row Templates (Multiple-Line Columns) 198-202 Customizing the Appearance of Headers 202-203 Customizing the Style of Header Cells 203-204 Showing or Hiding Headers 204-206 Customizing the Default Header Labels 206-208 Customizing Header Label Text 208-209 Setting the Size of Header Cells 209-210 Customizing the Header Empty Areas 210-211 Creating a Header with Multiple Rows or Columns 211-214 Creating a Span in a Header 214-215 Customizing the Appearance of a Cell 215-216 Working with the Active Cell 216 Customizing the Colors of a Cell 216-218 Aligning Cell Contents 218-219 Customizing Cell Borders 219-220 Customizing the Margins and Spacing of the Cell 220-222 Creating and Applying a Custom Style for Cells 222-224 Assigning a Cascading Style Sheet to a Cell 224-225 Creating a Range of Cells 225-226 Spanning Cells 226-228 Allowing Cells to Merge Automatically 228-230 Using Sparklines 230-231 Adding a Sparkline to a Cell 231-233 Customizing Markers and Pointers 233-235 Specifying Horizontal and Vertical Axes 235-236 Copyright © GrapeCity, Inc.