Xamarin.Android Documentation 1
Total Page:16
File Type:pdf, Size:1020Kb
ComponentOne Xamarin.Android 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.Android Documentation 1 Table of Contents Getting Started with Xamarin.Android Controls 6 Breaking Changes for Xuni User 6-7 NuGet Packages 7 Redistributable Files 7-8 System Requirements 8 Creating a New Xamarin.Android App 8-11 Adding NuGet Packages to your App 11-13 Licensing 13 License App using GrapeCity ComponentOneMenu Extension 13-23 Licensing your app using website 23-24 Finding the Application Name 24-26 About this Documentation 26 Technical Support 26-27 Xamarin.Android Project Templates 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 39-41 Orientation 41 Selection 41-42 Customizing Selection 42-44 CollectionView 44 Quick Start 44-50 Features 50 Filtering 50-52 Grouping 52-54 Incremental Loading 54-57 Sorting 57-59 FlexChart 59-60 Chart Elements 60-61 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 2 Chart Types 61-66 Quick Start: Add Data to FlexChart 66-72 Features 72 Animation 72 Annotations 73-77 Axes 77-79 Customize Appearance 79-80 Data Labels 80-81 Header and Footer 81-82 Hit Test 82-85 Legend 85-86 Line Marker 86-87 Mixed Charts 87-92 Selection 92-93 Themes 93-95 Tooltip 95-97 Zooming and Panning 97-99 Zones 99-103 FlexGrid 103-104 Key Features 104-105 Quick Start: Add Data to FlexGrid 105-110 Features 110 Reordering Rows and Columns 110-111 Cell Freezing 111-112 Customize Appearance 112-113 Custom Icon 113-115 Custom Cells 115-118 Clipboard and Keyboard Support 118 Data Mapping 118-119 Defining Columns 119-120 Editing 120-121 Inline Editing 121 Add New Row 121-122 Export 122-123 Filtering 123 Search Box Filtering 123-124 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 3 Grouping 124-126 Merging Cells 126-127 Resizing Columns 127 Row Details 127-129 Selecting Cells 129-131 Star Sizing 131-132 Word Wrap 132 FlexPie 132-133 Quick Start: Add Data to FlexPie 133-135 Features 135 Animation 135-136 Customize Appearance 136-137 Data Labels 137-138 Donut Pie Chart 138-139 Exploded Pie Chart 139-140 Header and Footer 140-141 Legend 141-142 Themes 142-144 Zooming and Panning 144-146 FlexViewer 146-147 FlexViewer Toolbar 147-148 Quick Start 148-150 Features 150 Navigation 150-151 Text Search 151-152 Appearance 152-153 Export 153-154 UI Virtualization 154 Gauge 154-155 Gauge Types 155-156 Quick Start: Add and Configure Gauge 156-159 Quick Start: Add and Configure 159 LinearGauge Quick Start 159-161 RadialGauge Quick Start 161-163 BulletGraph Quick Start 163-165 Features 165 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 4 Customize Appearance 165 Direction 165-166 Range 166-167 Input 167 AutoComplete 167-168 Quick Start: Populating C1AutoComplete with data 168-170 Features 170 Data Binding 170-171 Delay 171 Highlight Matches 171-172 AutoComplete Mode 172-173 ComboBox 173-174 Quick Start: Display a C1ComboBox Control 174-176 Features 176 Custom Appearance 176-177 Data Binding 177 Editing 177-178 DropDown 178 Creating a Custom Date Picker using C1DropDown 178-179 MaskedTextField 179-180 Mask Symbols 180-181 Quick Start: Display C1MaskedTextField Controls 181-182 Toggle Button 182 Quick Start: Change State and Customize the Control 182-183 Sunburst Chart 183-184 QuickStart 184-190 Features 190 Legend 190-191 Selection 191-192 Grouping 192-194 Zooming and Panning 194-195 TreeMap 195-197 Key Features 197 Elements 197 Layouts 197-199 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 5 QuickStart 199-205 Features 205 Drilldown 205 Selection 205-207 Theming 207-208 Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 6 Getting Started with Xamarin.Android Controls ComponentOne Xamarin.Android is a collection of Android UI controls developed by GrapeCity. Xamarin.Android Edition has been optimized for Android development with outstanding built-in features and superior flexibility. It allows you to design views in XML and develop applications similar to the pre-built UI controls in Android. For existing Xuni new users, the new architecture brings many new features: 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 Xuni, Wijmo, as well as ComponentOne controls. Some controls have a number additional features (such as FlexGrid). Breaking Changes for Xuni User New Package Names The packages have changed their prefix if you're coming from Xuni. For instance, Xuni.Android.Calendar now corresponds to C1.Android.Calendar We have also moved to a more consistent naming scheme for our controls based on the following pattern: C1.[Platform].[ControlName] For example, FlexGrid is available in C1.Xamarin.Forms.Grid Copyright © 2019 GrapeCity, inc. All rights reserved. Xamarin.Android Documentation 7 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.Android.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.Android.FlexGrid now corresponds to C1.Android.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 CollectionView and is automatically installed when any dependent package is installed. C1.Android.CollectionView This is the dependency package to use CollectionView with a native RecyclerView on Android. C1.Android.Calendar Installing this NuGet package adds all the references that enable you to use the Calendar control in your Xamarin.Android application. C1.Android.Core This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.Android.Chart Installing this NuGet package adds all the references that enable you to use the FlexChart and FlexPie controls in your Xamarin.Android application. C1.Android.Grid Installing this NuGet package adds all the references that enable you to use the FlexGrid control in your Xamarin.Android application. C1.Android.Gauge Installing this NuGet package adds all the references that enable you to use the Gauge controls in your Xamarin.Android application. C1.Android.Input Installing this NuGet package adds all the references that enable you to use the Input controls in your Xamarin.Android application. Redistributable Files Xamarin.Android 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. 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 Copyright © 2019 GrapeCity, inc.