Xamarin.Ios Controls
Total Page:16
File Type:pdf, Size:1020Kb
ComponentOne Xamarin.iOS Controls Copyright © 1987-2015 GrapeCity, Inc. All rights reserved ComponentOne, a division of GrapeCity 201 South Highland Avenue, Third Floor Pittsburgh, PA 15206 USA Website: http://www.componentone.com Sales: [email protected] 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 media on which the software is delivered is free from defects in material and workmanship, assuming normal use, for a period of 90 days from the date of purchase. If a defect occurs during this time, you may return the defective media to ComponentOne, along with a dated proof of purchase, and ComponentOne will replace it at no charge. After 90 days, you can obtain a replacement for the defective media by sending it and a check for $25 (to cover postage and handling) to ComponentOne. Except for the express warranty of the original media on which the software is delivered is set forth here, ComponentOne makes no other warranties, express or implied. Every attempt has been made to ensure that the information contained in this manual is correct as of the time it was written. ComponentOne is not responsible for any errors or omissions. ComponentOne’s 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. Xamarin.iOS Controls 1 Table of Contents Getting Started with Xamarin.iOS Controls 6 Breaking Changes for Xuni Users 6-7 NuGet Packages 7 Redistributable Files 7-8 System Requirements 8 Xamarin iOS Project Templates 8-9 Creating a New Xamarin.iOS App 9-12 Adding NuGet Packages to your App 12-14 Licensing 14 License App using GrapeCity ComponentOneMenu Extension 14-24 Licensing your app using website 24-25 Finding the Application Name 25-27 About this Documentation 27 Technical Support 27-28 Controls 29 Calendar 29 Quick Start: Display a C1Calendar Control 29-31 Interaction Guide 31-33 Features 33 Customizing Appearance 33-35 Customizing Header 35-38 Customizing Day Content 38-41 Orientation 41 Custom Selection 41-43 CollectionView 43 Quick Start 43-48 Features 48 Filtering 48-50 Grouping 50-53 Incremental Loading 53-56 Sorting 56-59 FlexChart 59 Chart Elements 59-60 Chart Types 60-67 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 2 Quick Start: Add Data to FlexChart 67-70 Features 70 Animation 70-71 Annotations 71-76 Axis 76-79 Customize Appearance 79-80 Hit Test 80-82 Data Labels 82-84 Header and Footer 84-85 Legend 85-87 Line Marker 87-90 Mixed Charts 90-94 Selection 94-95 Themes 95-97 Tooltip 97-98 Zooming and Panning 98-99 Zones 99-103 Manage Overlapped Data Labels 103-106 FlexGrid 106-107 Key Features 107-108 Quick Start: Add Data to FlexGrid 108-117 Features 117 Reordering Rows and Columns 117-118 Custom Cells 118-121 Custom Icon 121-123 Customize Appearance 123-125 Clipboard and Keyboard Support 125 Data Mapping 125-126 Defining Columns 126-128 Editing 128 Inline Editing 128-129 Custom Editing 129-133 Add New Row 133-134 Export 134-135 Filtering 135 Search Box Filtering 135-136 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 3 Frozen Rows and Columns 136-137 Formatting Columns 137-139 Grouping 139-141 Material Theme 141-142 Merging Cells 142 Resizing Columns 142-143 Row Details 143-146 Selecting Cells 146-147 Word Wrapping 147-148 FlexPie 148-149 Quick Start: Add data to FlexPie 149-152 Features 152 Animation 152-153 Customize Appearance 153-154 Data Labels 154-155 Manage Overlapped Data Labels 155-156 Donut Pie Chart 156-157 Exploded Pie Chart 157-158 Header and Footer 158-159 Legend 159-160 Themes 160-162 Zooming and Panning 162-163 FlexViewer 164-165 FlexViewer Toolbar 165 Quick Start 165-167 Features 167 Navigation 167-168 Text Search 168-169 Appearance 169-170 Export 170-171 UI Virtualization 171 Gauge 171-172 Gauge Types 172 Quick Start: Add and Configure Gauge 173-174 Quick Start: Add and Configure 174 BulletGraph Quick Start 174-176 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 4 LinearGauge Quick Start 176-178 RadialGauge Quick Start 178-180 Features 180 Animation 180-181 Customize Appearance 181 Direction 181-182 Export Image 182-184 Range 184 Input 184 AutoComplete 184-185 Quick Start: Populating C1AutoComplete with data 185-187 Features 188 Data Binding 188 Delay 188 Highlight Matches 188-189 AutoComplete Mode 189-190 CheckBox 190 ComboBox 190-191 Quick Start: Display a C1ComboBox Control 191-192 Features 192 Custom Appearance 192-193 Data Binding 193-194 Editing 194 DropDown 194 Creating a Custom Date Picker using C1DropDown 194-196 MaskedTextField 196 Mask Symbols 196-197 Quick Start: Display C1MaskedTextField Controls 197-198 Toggle Button 198 Quick Start: Change State and Customize the Control 198-199 Sunburst Chart 199-200 QuickStart 200-205 Features 205 Legend 205-206 Selection 206-207 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 5 Grouping 207-209 Zooming and Panning 209-210 TreeMap 210 Key Features 210-211 Elements 211 Layouts 211-213 QuickStart 213-218 Features 218 Drilldown 218-219 Selection 219-221 Theming 221-222 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 6 Getting Started with Xamarin.iOS Controls ComponentOne Xamarin.iOS is a collection of iOS UI controls developed by GrapeCity. Xamarin.iOS Edition has been optimized for iOS development. For existing Xuni users, the new architecture brings many new features listed below: Enhanced performance The new controls should generally perform better than the old controls (sometimes doubling performance). By specifically focusing on the Xamarin architecture, the controls cut out some intermediary logic and are optimized for the platform. Since they’re entirely in C#, so you can also expect a more consistent experience. Designer support The new controls should also support Xamarin’s designers for iOS and Android applications. This makes it much easier to construct your Android XML or iOS Storyboards using these controls. New control features The controls have been rethought for the new architecture with the combined experience of Xamarin, Wijmo, as well as ComponentOne controls. Some controls have a number additional features (such as FlexGrid). Breaking Changes for Xuni Users New Package Names The packages have changed their prefix if you're coming from Xuni. For instance, Xuni.iOS.Calendar now corresponds to C1.iOS.Calendar We have also moved to a more consistent naming scheme for our controls based on the following pattern: Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 7 C1.[Platform].[ControlName] For example, FlexGrid is available in C1.Xamarin.Forms.Grid Additionally, FlexChart, FlexPie, and ChartCore have all been consolidated into one single package instead of three different packages. To use FlexChart or FlexPie, you now need to add a single package developed for the platform of your choice: C1.iOS.Chart Namespace Changes We’ve made some changes to the namespace of the current controls, which are in line with the changes in package names. For example, Xuni.iOS.FlexGrid now corresponds to C1.iOS.Grid. Minor API Changes There are some minor changes in API between ComponentOne Xamarin Edition and Xuni. These should mostly amount to additions, slight change in syntax, and use of prefix 'C1' instead of 'Xuni' in class and object names. For FlexChart, however, the control is very actively growing in terms of API, so missing features are intended to be added in the future. NuGet Packages The following NuGet packages are available for download: Package Name Description C1.CollectionView This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.iOS.Calendar Installing this NuGet package adds all the references that enable you to use the Calendar control in your Xamarin.iOS application. C1.iOS.Core This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.iOS.Chart Installing this NuGet package adds all the references that enable you to use the FlexChart and FlexPie controls in your Xamarin.iOS application. C1.iOS.Grid Installing this NuGet package adds all the references that enable you to use the FlexGrid control as well as CollectionView interface in your Xamarin.iOS application. C1.iOS.Gauge Installing this NuGet package adds all the references that enable you to use the Gauge control in your Xamarin.iOS application. C1.iOS.Input Installing this NuGet package adds all the references that enable you to use the Input controls in your Xamarin.iOS application. Redistributable Files Xamarin.iOS Edition, developed and published by GrapeCity, inc., can be used to develop applications in conjunction with Microsoft Visual Studio, Xamarin Studio or any other programming environment that enables the user to use and integrate controls. Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.iOS Controls 8 You may also distribute, free of royalties, the following redistributable files with any such application you develop to the extent that they are used separately on a single CPU on the client/workstation side of the network.