Spread for ASP.NET Developer's Guide
Total Page:16
File Type:pdf, Size:1020Kb
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-16 Getting Started 17 Handling Installation 17 Installing the Product 17 Licensing a Trial Project after Installation 17 End-User License Agreement 17-18 Creating a Build License 18-19 Handling Redistribution 19-20 Product Requirements 20 Handling Variations In Windows Settings 20-21 Working with the Component 21 Adding a Component to a Web Site using Visual Studio 2015 or 2017 21-24 Adding a Component to a Web Site using Visual Studio 2013 24-28 Adding a Component to a Web Site using Visual Studio 2012 28-30 Adding a Component to a Web Site using Visual Studio 2010 30-33 Adding and Using JavaScript Intellisense 33 Adding JavaScript IntelliSense for Visual Studio 2012 33-35 Adding JavaScript IntelliSense for Visual Studio 2010 35-36 Understanding Browser Support 36-38 Understanding Parts of the Component Interface 38-39 Working with Collection Editors 39 Working with Web Parts 40 Working with Windows Azure 40 Working with Microsoft ASP.NET MVC 5 40-44 Working with Microsoft ASP.NET MVC 3 44-48 Copying Shared Assemblies to Local Folder 48-49 Working with Strongly Typed Data Controls 49 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 2 Getting More Practice 49 Understanding Procedures in the Documentation 49-51 Getting Technical Support 51 Understanding the Spread Wizard 51 Starting the Spread Wizard 51-52 Using the Spread Wizard 52-53 Tutorial: Creating a Checkbook Register 53 Adding Spread to the Checkbook Project 53 Adding Spread to a Project 53-55 Setting Up the Rows and Columns of the Register 55-57 Setting the Cell Types of the Register 57-59 Adding Formulas to Calculate Balances 59-60 Understanding the Product 61 Product Overview 61-62 Features Overview 62-63 AJAX Support 63 ASP.NET AJAX Extenders 63-64 Built-In Functions 64 Cell Types 64-65 Chart Control 65 Client-Side Scripting 65 Conditional Formatting 65 Context Menu 65 Corner Customization 65-66 Customized Appearance (Skins) 66 Data Binding 66 Footers for Columns or Groups 66 Frozen Rows and Columns 66 Goal Seeking 66 Grouping 66 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 3 Headers with Multiple Columns and Rows 66 Hierarchical Display 66-67 Import and Export Capabilities 67 Load on Demand 67 Multiple-Line Columns 67 Multiple Sheets 67 PDF Support 67 Printing 67-68 Row Filtering 68 Row Preview 68 Row Template Editor 68 Searching Features 68 Sorting Capabilities 68 Spannable Cells 68 Sparklines 68 Spread Designer 68-69 Spread Wizard 69 Theme Roller 69 Title and Subtitle 69 Touch Support 69 Validation Controls 69 Concepts Overview 69 Shortcut Objects 69-71 Object Parentage 71 Underlying Models 72-73 Cell Types 73 SheetView versus FpSpread 73 Formatted versus Unformatted Data 73-74 Zero-Based Indexing 74 Client-Side Scripting 74 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 4 Maintaining State 74 Namespaces Overview 75 Working with the Spread Designer 76 Starting the Spread Designer 76 Understanding the Spread Designer Interface 76-77 Spread Designer Menus 77-78 File Menu 78 Home Menu 78-79 Insert Menu 79 Data Menu 79 View Menu 79 Settings Menu 80 Chart Tools Menu 80 Sparklines Menu 80-81 Spread Designer Toolbars 81 Spread Designer Editors 81 Alternating Rows Editor 81-82 Cells, Columns, and Rows Editor 82-83 ContextMenu Collection Editor 83-86 DataKey Names (String Collection) Editor 86-87 Formula Editor 87-88 GroupInfo Collection Editor 88-89 Header Editor 89-90 NamedStyle Collection Editor 90-91 Row Template Editor 91-92 SheetSkin Editor 92-93 SheetView Collection Editor 93-94 Spread Designer Context Menus 94-95 Using the Spread Designer 95-96 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 5 Customizing Sheets, Rows, and Columns in Spread Designer 96-97 Customizing Cells in Spread Designer 97-99 Adding Formulas to Cells 99-101 Saving and Opening Design Files 101-102 Applying Changes and Closing Spread Designer 102 Customizing User Interaction 103 Customizing Interaction with the Overall Component 103 Displaying Scroll Bars 103-104 Displaying Scroll Bar Text Tips 105 Customizing the Scroll Bar Colors 105-106 Allowing Load on Demand 106-108 Customizing Interaction Based on Events 108 Handling the Tab Key 108 Customizing the Graphical Interface 109-110 Searching for Data with Code 110-111 Adding a Context Menu 111-113 Working with AJAX 113 Enabling AJAX support 113-114 Using ASP.NET AJAX Extenders 114-115 Customizing the Toolbars 115 Customizing the Command Bar on the Component 115-117 Customizing the Command Buttons 117-120 Changing the Command Button Images 120-122 Hiding a Specific Command Button 122-123 Displaying the Sheet Names 123-124 Customizing Page Navigation 124-127 Customizing Page Navigation Buttons on the Client 127-128 Customizing the Hierarchy Bar 128-130 Customizing Interaction with Rows and Columns 130 Allow the User to Move Columns 130-131 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 6 Allowing the User to Resize Rows or Columns 131-132 Freezing Rows and Columns 132 Setting up Row Edit Templates 132-134 Setting up Preview Rows 134-135 Managing Filtering of Rows of User Data 135-136 Creating Filtered Rows and Setting the Appearance 136-140 Customizing Simple Filtering of Rows of User Data 140 Using Row Filtering 140-141 Customizing the List of Filter Items 141-142 Creating a Completely Custom Filter 142-143 Using Enhanced Filtering 143-145 Using the Filter Bar 145-148 Customizing Grouping of Rows of User Data 148 Using Grouping 148-149 Allowing the User to Group Rows 149-150 Setting the Appearance of Grouped Rows 150-152 Customizing the Group Bar 152-153 Creating a Custom Group 153 Compatibility with Other Features 153-154 Customizing Sorting of Rows of User Data 154-155 Allowing User Sorting 155-156 Customizing Interaction with Cells 156 Adding a Note to a Cell 156-157 Adding a Tag to a Cell 157-159 Locking a Cell 159-161 Using Conditional Formatting in Cells 161 Creating Conditional Formatting with Rules 161-162 Color Scale Rules 162-163 Data Bar Rule 163-165 Highlighting Rules 165-167 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 7 Icon Set Rule 167-168 Top or Average Rules 168-169 Conditional Formatting of Cells 169-170 Customizing Selections of Cells 170 Specifying What the User Can Select 170-172 Working with Selections of Cells 172-173 Customizing the Appearance of Selections 173-174 Managing Printing 174 Printing a Spreadsheet 174-175 Adding Headers and Footers to Printed Pages 175 Customizing the Appearance 176 Customizing the Appearance of the Overall Component 176 Customizing the Dimensions of the Component 176-177 Customizing the Outline of the Component 177-178 Customizing the Default Initial Appearance 178-179 Resetting Parts of the Interface 179-180 Using the jQuery Theme Roller with Spread 180-181 Customizing the Appearance of the Sheet 181-182 Working with the Active Sheet 182 Working with Multiple Sheets 182-183 Adding a Sheet 183-184 Removing a Sheet 184-185 Showing or Hiding a Sheet 185-186 Setting the Background Color of the Sheet 186-187 Adding a Title and Subtitle to a Sheet 187-188 Customizing the Page Size (Rows to Display) 188-190 Displaying Grid Lines on the Sheet 190-191 Customizing the Sheet Corner 191-193 Displaying a Footer for Columns or Groups 193-197 Copyright © GrapeCity, inc. All rights reserved. Spread for ASP.NET Developer’s Guide 8 Creating a Skin for Sheets 197-199 Applying a Skin to a Sheet 199-200 Customizing the Appearance of Rows and Columns 200 Customizing the Number of Rows or Columns 200-201 Adding a Row or Column 201-202 Removing a Row or Column 202-204 Showing or Hiding Rows or Columns 204-205 Setting the Row Height or Column Width 205-206 Setting the Top Row to Display 206-207 Creating Alternating Rows 207-208 Creating Row Templates (Multiple-Line Columns) 208-212 Customizing the Appearance of Headers 212-213 Customizing the Style of Header Cells 213-214 Showing or Hiding Headers 214-216 Customizing the Default Header Labels 216-218 Customizing Header Label Text 218-219 Setting the Size of Header Cells 219-220 Customizing the Header Empty Areas 220-221 Creating a Header with Multiple Rows or Columns 221-224 Creating a Span in a Header 224-225 Customizing the Appearance of a Cell 225-226 Working with the Active Cell 226 Customizing the Colors of a Cell 226-228 Aligning Cell Contents 228-229 Customizing Cell Borders 229-230 Customizing the Margins and Spacing of the Cell 230-232 Creating and Applying a Custom Style for Cells 232-234 Assigning a Cascading Style Sheet to a Cell 234-235 Creating a Range of Cells 235-236 Spanning Cells 236-238 Copyright © GrapeCity, inc.