Windows Phone Toolkit In Depth edition by Boryana Miloshevska Windows Phone Toolkit in Depth 3nd edition Disclaimers Disclaimer of Endorsement Reference within this book to any specific commercial or non-commercial product, process, or service by trade name, trademark, manufacturer or otherwise does not constitute or imply an endorsement, recommendation, or favoring by the author Disclaimer for Links to External, Third Party Web Sites Links to external, or third party Web sites, are provided solely for readers' convenience Links taken to other sites are done so at your own risk and the author accepts no liability for any linked sites or their content When you access an external Web site, keep in mind that the author has no control over its content www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition About the Author Boryana Miloshevska is a software developer with more than years of professional experience with NET technologies She is a co-founder of www.windowsphonegeek.com – the leading Windows Phone development community Boryana is the author of the hugely popular "Silverlight for Windows Phone Toolkit In Depth" and "Windows Phone Toolkit In Depth 2-nd" books and winner of the Microsoft “Engineering Excellence Achievement” Award She is an active blogger and tech enthusiast trying to contribute to the Windows Phone development community in various ways, including more than 400 development articles, tutorials and guides related to Windows Phone most of which published on www.windowsphonegeek.com.Boryana is also working as a consultant in the areas of Windows Phone and Windows application development About the Editor Yordan Pavlov is an experienced software developer with years of professional experience with the NET technology stack and a co-founder of www.windowsphonegeek.com He has worked on many interesting projects including UI and data access components at Telerik, financial software and even a GIS system that consumes data from NASA satellites Yordan is also a winner of the Microsoft ImagineCup competition and the Microsoft “Engineering Excellence Achievement” Award www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition Table of Contents Disclaimers About the Author About the Editor Introduction 13 Who is this book for? 13 What this book covers? 13 How is this book structured? 14 Source code 15 About the third edition 15 Introduction to Windows Phone 17 Introduction to the Windows Phone Toolkit 20 Components included in the Windows Phone Toolkit for Windows Phone, October 2012 20 Unit Testing Framework 21 What's included in the source code? 21 Suggestions? Features? Questions? 22 Official Blogs & Tweets 22 What else will you need? 23 Getting Started with the Windows Phone Toolkit 23 Option1: Install Windows Phone Toolkit using NuGet 24 Option2: Download the Windows Phone Toolkit Oct 2012 Source Code 31 How to use unofficial builds 33 How to use Windows Phone Toolkit in Visual Studio 36 How to add Windows Phone Toolkit Controls to the Visual Studio Toolbox 40 How to use Windows Phone Toolkit in Expression Blend 45 AutoCompleteBox 50 Overview 50 Getting Started 50 Key Properties 51 Key Events 58 Key Methods 61 www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition Data Binding AutoCompleteBox 62 Data Binding AutoCompleteBox via ValueMemberBinding 65 ContextMenu 68 Overview 68 Getting Started 68 Key Properties 69 Key Events 71 MenuItem 71 MenuItem Key Properties 72 MenuItem Key Events 73 Populating a ContextMenu with MenuItems 73 Populating ContextMenu with data via Data Binding 74 Using ContextMenu inside ListBox ItemTemplate (DataTemplate) 76 CustomMessageBox 80 Overview 80 Getting Started 80 Key Properties 82 Key Events 86 Key Methods 87 Set UserControl as a Content of the CustomMessageBox control 88 Passing Data between the CustmMessageBox and and an application page 89 DatePicker 93 Overview 93 Getting Started 93 Key Properties 95 Key Events 96 Customizing the full-screen picker page 96 ExpanderView 99 Overview 99 Getting Started 99 Key Properties 100 www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition Key Events 102 Data Binding ExpanderView 103 ExpandAll and CollapseAll Example 109 HubTile 110 Overview 110 Getting Started 110 Key Properties 111 HubTileService 114 Data Binding HubTile 115 Freezing and Unfreezing Tiles 119 ListPicker 121 Overview 121 Getting Started 121 Key Properties 123 Key Events & Methods 125 Data Binding ListPicker 126 Working with ListPicker SelectedItem 129 10 LongListMultiSelector 134 Overview 134 Getting Started 134 Key Properties 135 Key Events 140 LongListMultiSelectorItem 142 LongListMultiSelectorItem Key Properties 142 LongListMultiSelectorItem Key Events 143 Data Binding LongListMultiSelector 143 11 LoopingSelector 154 Overview 154 Getting Started 154 Key Properties 159 Key Events 160 www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition ILoopingSelectorDataSource 160 Implementing a Generic LoopingSelectorDataSource 161 LoopingSelector with Double Data 165 LoopingSelector with Int Data 166 LoopingSelector with String Data 167 LoopingSelector with DateTime Data 168 Advanced Data Binding using IComparable 169 Advanced Data Binding using a separate Comparer 172 12 Map API extensions and Controls 175 Overview 175 Getting Started 175 GeocoordinateExtensions 176 MapExtensions 177 MapItemsControl 177 Pushpin 178 UserLocationMarker 178 MapChildControl 178 How to use the new Map API extensions 179 Defining the Data Source 179 Data binding the MapItemsControl 180 Implement multiple visual states by changing the ContentTemplate of the Pushpin 181 Display the Current Location 182 13 PhoneTextBox 185 Overview 185 Getting Started 185 Key Properties 186 Key Events 190 14 Rating Control 191 Overview 191 Getting Started 191 Key Properties 192 www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition Key Events 197 15 Transitions 198 Overview 198 Key concepts 198 Getting Started 201 Page Transition 202 UIElement Transition 204 Transition Structure 205 CustomTransition with XAML animation 206 CustomTransition with C# animation 208 CustomTransition with animation defined in the NavigationInTransition / NavigationOutTransition 209 16 TiltEffect 212 Overview 212 Getting Started 212 Key Properties 213 How to Enable TiltEffect globally 214 How to Suppress TiltEffect 215 Adding more controls to the list of TiltableItems 215 Adding TiltEffect to data bound ListPicker items 216 17 TurnstileFeatherEffect 218 Overview 218 Getting Started 218 Key Properties 219 Setup the page navigation before using the TurnstileFeatherEffect 220 How to Add TurnstileFeatherEffect to a Databound ListBox 222 How to Add TurnstileFeatherEffect to different UI elements 225 Final Result 225 18 TimePicker 227 Overview 227 Getting Started 227 Key Properties 229 www.windowsphonegeek.com Windows Phone Toolkit in Depth 3nd edition Key Events 230 Customizing the full-screen picker page 230 19 ToggleSwitch 233 Overview 233 Getting Started 233 Key Properties 234 Key Events 236 Dynamically Changing ToggleSwitch Content depending on the current State 237 20 WrapPanel 239 Overview 239 Getting Started 239 Key Properties 240 Horizontal WrapPanel 241 Vertical WrapPanel 241 WrapPanel as ItemsPanel 242 21 UnitTesting Framework 245 Introduction to Unit Testing 245 Before you begin 245 Installing the Windows Phone Toolkit Test Framework via NuGet 246 Getting Started - Step By Step Guide 250 Introduction to Tags and how to use them 253 Testing Framework: Basic Tests and Async Tests 254 22 Additional Components 260 SlideIn Effect 260 RecurringDaysPicker 261 HeaderedItemsControl 262 DateTimeConverters 262 LocalizedResources 265 23 GestureService and GestureListener (obsolete) 267 Overview 267 What is GestureService? 268 www.windowsphonegeek.com 10 Windows Phone Toolkit in Depth 3nd edition What is GestureListener? 269 Getting Started 269 GestureListener Key Events 270 Examples 276 24 LockablePivot (obsolete) 278 Overview 278 Getting Started 278 Key Properties 279 Examples 279 25 LongListSelector (obsolete) 282 Overview 282 Visual structure 282 Getting Started 284 Key Properties 285 Key Events 289 Key Methods 292 Data Binding LongListSelector 293 Customizing LongListSelector group popup 298 Animating LongListSelector group items using transitions 299 Dynamically Insert, Update and Delete data in a data bound LongListSelector 303 How to get Selected Item and Group info in the LongListSelector SelectionChaged event 307 26 MultiselectList (obsolete) 310 Overview 310 Getting Started 310 Key Properties 311 Key Events 312 MultiselectItem 312 MultiselectItem Key Properties & Events 313 Data Binding MultiselectList 314 27 PerformanceProgressBar (obsolete) 322 Overview 322 www.windowsphonegeek.com 11 Windows Phone Toolkit in Depth 3nd edition Getting Started 323 Key Properties 324 www.windowsphonegeek.com 12 Windows Phone Toolkit in Depth 3nd edition Introduction Who is this book for? The target audience of this book is anyone who is interested in Windows Phone development It covers all controls from the Microsoft Windows Phone Toolkit – Oct 2012 (Windows Phone SDK) This book contains all the information necessary to get you started with the Windows Phone Toolkit for Windows Phone It is suitable for both beginners and advanced developers Before you begin you will need to have a basic understanding of:    XAML principles Windows Phone principles C# programming What this book covers? The book covers “in depth” all controls plus the testing framework from the Microsoft Windows Phone Toolkit for Windows Phone including: o o o o o o o o o o o o o o o o o o o o AutoCompleteBox ContextMenu CustomMessageBox DatePicker DateTimeConverters ExpanderView HeaderedItemsControl HubTile ListPicker LocalizedResources LoopingSelector LongListMultiSelector Page Transitions PhoneTextBox Rating Control TiltEffect TimePicker TurnstileFeatherEffect ToggleSwitch WrapPanel www.windowsphonegeek.com 13 Windows Phone Toolkit in Depth 3nd edition o o Test Framework Obsolete Controls: o GestureService and GestureListener*(obsolete) o LockablePivot*(obsolete, use for WP7 only) o LongListSelector*(obsolete, use for WP7 only) o MultiselectList*(obsolete, use for WP7 only) o PerformanceProgressbar*(obsolete, use for WP7 only) Furthermore the first two chapters make a quick introduction to the main concepts related to Windows Phone application development and how to get started using external libraries like the “Windows Phone Toolkit” How is this book structured? In this book you will learn how to use the different tools and controls that the “Windows Phone Toolkit” for Windows Phone offers Chapter is a brief introduction to the main Windows Phone concepts You will learn the key concepts that you need to know in order to get started with Windows Phone application development Chapter is focused on getting started with the “Windows Phone Toolkit” for Windows Phone It gives you all the necessary information from start to finish including:         What is in the toolkit? System requirements Installing Windows Phone Toolkit and Visual Studio Visual Studio Toolbox integration Expression Blend integration Unofficial builds Issue Tracker In Chapters through Chapter 27 you will learn how to use each one of the toolkit controls “in depth” Each chapter contains the following main sections: “Overview”: a brief description of the main features “Getting Started”: explains how to get started using the control in XAML and C# www.windowsphonegeek.com 14 Windows Phone Toolkit in Depth 3nd edition “Key Properties”/ “Key Methods”/ “Key Events”: a full explanation of the available public API (with short samples) Examples: Depending on the importance and how complex the control is there are more or less examples with source code and detailed explanation Source code The full source code used in this book can be downloaded here: http://windowsphonegeek.com/marketplace/components/windows-phone-toolkit-in-depth3rd-edition All sample projects discussed in this book target Windows Phone The following conventions are used in code samples (XAML and C#): XAML //XAML code here C# //C# code here NOTE: Important things here! About the third edition This is the third version of the hugely popular book “Windows Phone Toolkit In Depth" that I wrote a while ago I have reflected all the changes that have been made in the latest official Oct 2012 release of the toolkit for Windows Phone If you are using this book with another version of the Windows Phone Toolkit and / or Windows Phone, there might be differences in the available APIs What`s new: This book is completely changed due to the fact that this 3rd edition is entirely focused on Windows Phone app development All previous examples and APIs are updated to the latest WP8 version of the toolkit and also all new components and APIs are covered in depth A couple of new controls have been introduced in the latest release of the Windows Phone Toolkit as well as a brand new Test Framework All this is explained in details with a lot www.windowsphonegeek.com 15 Windows Phone Toolkit in Depth 3nd edition of new WP8 examples, complete WP8 API guide, explanations and more The full source code of all examples is now structured in a single solution with a separate project for each sample www.windowsphonegeek.com 16 ... 15 Introduction to Windows Phone 17 Introduction to the Windows Phone Toolkit 20 Components included in the Windows Phone Toolkit for Windows Phone, October 2012... www.windowsphonegeek.com – the leading Windows Phone development community Boryana is the author of the hugely popular "Silverlight for Windows Phone Toolkit In Depth" and "Windows Phone Toolkit. .. http://windowsphonegeek.com/marketplace/components /windows- phone- toolkit- in- depth3 rd-edition All sample projects discussed in this book target Windows Phone The following conventions are used in