====== Map Suite Desktop for WinForms ======

<div msgbox>
**Note:** The page is for Map Suite 10. If you are using Map Suite 9.0 or previous versions of Map Suite product, please go to [[map_suite_android_edition|MapSuite 9.0 Wiki]]. We highly recommended you to upgrade to ThinkGeo 12.0 if possible which supports both .NET Framework and .NET Core, which is easier to use and get more features over the previous version. The majority of previously built code should work without modification assuming the new namespaces are added.  For guidance on upgrading your existing code, please check out [[thinkgeo_12_upgrade_guide|ThinkGeo 12 Upgrade Guide]]. </div>

Map Suite Desktop for WinForms is a .NET native set of GIS software controls that lets .NET developers add rich, interactive maps to their Windows desktop applications. Featuring Winforms controls, running on Linux and Mac through Mono, packed with powerful mapping features and support for the most popular data formats, Map Suite Desktop for WinForms makes GIS accessible to developers of any skill.

===== Getting Started =====

It's very easy to get started. You can start from getting the samples from GitHub, or start from creating a new application in your Visual Studio. GitHub samples run properly in MonoDevelop on Linux as well. Please have a quick look at the following short videos.  
\\
<div play medialist>
[[media:map_suite_desktop_for_winforms_run_github_sample_on_windows|{{desktopedition:map_suite_desktop_for_windows_quickstart_windows.png?180x99|Map Suite Desktop for WinForms Quickstart On Windows}}]]
\\
Run GitHub Sample on Windows (2'28")
</div>


<div play medialist>
[[media:map_suite_desktop_for_winforms_run_github_sample_on_linux|{{desktopedition:map_suite_desktop_for_windows_quickstart_linux.png?180x99|Map Suite Desktop for WinForms Quickstart on Linux}}]]
\\
Run GitHub Sample on Linux (2'13")
</div>


<div play medialist>
[[media:map_suite_desktop_for_winforms_hello_world|{{desktopedition:map_suite_desktop_for_winforms_hello_world.png?180x99|Map Suite Desktop for WinForms Hello World}}]]
\\
Hello World on Windows (3'09")
</div>

<div dokuteaser>
> [[map_suite_desktop_for_winforms_quick_start_guide|Quick Start Guide]]
Get you up to speed with integrating the Map Suite Desktop for WinForms map control into your GIS software.
</div>

===== Product Guides =====

<div dokuteaser>
> [[Map Suite Desktop for WinForms Installation Guide|Installation Guide]]
Walks you through installing the map control on your system and creating a simple GIS application.
</div>


<div dokuteaser>
> [[map_suite_dependencies|Dependencies Guide]]
Introduces the dependencies Map Suite Desktop for WinForms needs with their features, versions and source websites.
</div>


<div dokuteaser>
> [[map_suite_mono_environment_setup_guide_on_linux|Linux Development Guide]]
Walks you through deploying your GIS software using the map control into a production environment.
</div>


<div dokuteaser>
> [[map_suite_runtime_license_guide_for_desktop|Deployment Guide]]
Walks you through deploying your GIS software using the map control into a production environment.
</div>


<div dokuteaser>
> [[Map Suite Data Format Guide|Data Format Guide]]
Walks the various GIS data format that are supported in the map control. It also list any caveats related to the use of that format in your mapping application.
</div>


<div dokuteaser>
> [[Map Suite Serialization Guide|Serialization Guide]]
Explains how to use our custom serialization class to render your Map Suite objects to XML, or other format etc. This allows your GIS application to easily save things such as Layers, Styles, or even whole maps to XML to be recalled at a later time.
</div>


<div dokuteaser>
> [[Map Suite Style Guide|Style Guide]]
Explains how to use styles to beautifully represent your GIS mapping data. It includes an overview of styles, a detailed explanation of the various styles that ship with Map Suite, as well as a step by step guide of creating your own custom styles.
</div>


<div dokuteaser>
> [[Map Suite Performance Guide|Performance Guide]]
Walks you through various ways you can increase performance in your .Net GIS application.
</div>

<div dokuteaser>
> [[Map Suite SQLite|SQLite Guide]]
Walks you through using SQLite as a storage format.
</div>

<div dokuteaser>
> [[map_suite_license_guide#map_suite_desktop_winforms_wpf|License Guide]]
Introduces what licenses are needed / how the license would work for debugging/deploying the Map Suite products.
</div>


<div dokuteaser>
> [[map_suite_10_upgrade_guide|Upgrade Guide]]
Introduces how to upgrade to Map Suite 10.0 from Map Suite 9.0 or previous version.
</div>

<div dokuteaser>
> [[map_suite_platform_coverage|Coverage Guide]]
Show Map Suite features coverage of different product and different platfoms 
</div>

===== Code Samples =====

** In addition to the samples below, we have dozens of interactive Desktop for WinForms sample applications available **

<div samplelist>
<faicon fa fa-navicon fa-lg> [[map_suite_desktop_for_winforms_all_samples|All Samples]]
\\
All samples about Map Suite Desktop for WinForms.
</div>

<div samplelist>
<faicon fa fa-copy fa-lg> [[map_suite_desktop_for_winforms_project_templates|Project Templates]]
\\
These projects show various study cases based on Map Suite Desktop for WinForms.
</div>

<div samplelist>
<faicon fa fa-globe fa-lg> [[map_suite_desktop_for_winforms_background_maps_samples|Background Maps]]
\\
These samples show how to incorporate 3rd part background map(Google, Bing, etc) with your application.
</div>

<div samplelist>
<faicon fa fa-random fa-lg> [[map_suite_desktop_for_winforms_interactiveoverlays_samples|InteractiveOverlays]]
\\
These samples show various aspects of how to extend or create InteractiveOverlays.
</div>

<div samplelist>
<faicon fa fa-font fa-lg> [[map_suite_desktop_for_winforms_labeling_samples|Labeling]]
\\
These samples show various ways to use labeling in your application. 
</div>

<div samplelist>
<faicon fa fa-road fa-lg> [[map_suite_desktop_for_winforms_layers_featuresources_samples|Layers & FeatureSources]]
\\
These samples show custom layers and feature sources from which you can get inspired to integrate your own data.   
</div>

<div samplelist>
<faicon fa fa-folder-open fa-lg> [[map_suite_desktop_for_winforms_miscellaneous_samples|Miscellaneous]]
\\
These samples show other miscellaneous features for the product. 
</div>

<div samplelist>
<faicon fa fa-print fa-lg> [[map_suite_desktop_for_winforms_printing_samples|Printing]]
\\
These samples demonstrate robust printing and page layout features.
 </div>

<div samplelist>
<faicon fa fa-map fa-lg> [[map_suite_desktop_for_winforms_projection_samples|Projection]]
\\ 
These sample features various usages of projection.  
</div>

<div samplelist>
<faicon fa fa-object-group fa-lg> [[map_suite_desktop_for_winforms_spatial_functions_samples|Spatial Functions]]
\\
These samples show various spatial functions such as union, buffer, merging data etc. 
</div>

<div samplelist>
<faicon fa fa-paint-brush fa-lg> [[map_suite_desktop_for_winforms_styles_samples|Styles]]
\\
These samples show various kinds of styles such as styles that scale or adjust based on time of day.
</div>

<div samplelist>
<faicon fa fa-car fa-lg> [[map_suite_desktop_for_winforms_vehicle_tracking_samples|Vehicle Tracking]]
\\
These samples show various features related to vehicle and asset tracking
</div>

<div samplelist>
<faicon fa fa-arrows-alt fa-lg> [[map_suite_desktop_for_winforms_zooming_panning_moving_samples|Zooming Panning Moving]]
\\
These samples show various ways to move the map.
</div>

<div newline></div>

<div samplelist>
<faicon fa fa-navicon fa-lg> [[http://wiki.thinkgeo.com/wiki/map_suite_all_samples|All Samples Across all the Products]]
\\
All samples about Map Suite Products, see what other products can do.
</div>

<div clearboth>
**NOTE:**
We have provided hundreds of .Net code samples in C# & VB.NET to help you get going quickly.  We have categorized them to allow you to quickly find what you are looking for.  Each code sample includes an overview, complete code online to review and the ability to download the sample to run it yourself.
</div>


===== Package =====
==== Standard  ====
Standard version contains all packages that Map Suite supported on this platform which should meet most user's requirements.

 [[map_suite_desktop_for_winforms_package_coverage|Compare with Barebone]]

==== Barebone ====
Barebone version is intended for experienced Map Suite developers who require fine grain control over their dependencies.  All other developer please use the Standard Edition.

 [[map_suite_desktop_for_winforms_package_coverage|Compare with Standard]]



===== API Documentation =====

   *[[map_suite_desktop_for_winforms_api|ThinkGeo.MapSuite.WinForms]]<div>The Desktop for WinForms API documentation covers the ThinkGeo.MapSuite.WinForms namespace which resides in the ThinkGeo.MapSuite.WinForms.dll assembly. It contains all of the Desktop for WinForms specific classes such as the map control itself, Overlays, and supported map classes.</div>


===== Change Logs =====

  *[[Map Suite Desktop for WinForms Release Change Log|API Change Log]]<div>The Desktop for WinForms change log details the changes made to the product for each major release cycle. </div>
  *[[Map Suite Desktop for WinForms Features & Bug Fixes Change Log|Features & Bug Fixes Change Log]]<div>This change log details the new features and bug fixes applied to the product for each major release cycle.</div>


===== Videos =====

> **Desktop for WinForms Sample App Walkthrough Video Series**

Step through the Desktop for WinForms sample applications and see how they're put together. We'll demonstrate how to use each app, then take you through every part of the source code and show you how it works.\\ 

**Tip**: //You'll want to select "Fullscreen" to properly read the source code.//


<div play medialist>
[[desktopedition:Introduction to the Desktop Edition|{{desktopedition:screenshot:Introduction_to_the_Desktop_Edition.png?180x99|Introduction to the Desktop for WinForms}}]]
\\
Introduction to the Desktop for WinForms
</div>
<div newline/>
> **Extending Map Suite Video Series**
{{page>map_suit_extending_map_suite_video_series}}


===== Screenshots =====
The Map Suite Desktop for WinForms screenshots gallery section displays a wide range of screenshots covering various GIS features of the Map Suite Desktop for WinForms map control.

<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_SatelliteImagery.jpg?180|Add rich aerial imagery
Supports JPEG2000, TIFF, MrSid, ECW and more}} 
\\
//Add rich aerial imagery
Supports JPEG2000, TIFF, MrSid, ECW and more//
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_SQLQuerying.png?180|SQL query feature layers
Get column data
Visually render SQL data}} 
\\
SQL query feature layers
Get column data
Visually render SQL data
</div>

<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_ChartsGraphs.png?180|Integrate charts and graphs on your map
Uses ZedGraph classes}} 
\\
Integrate charts and graphs on your map
Uses ZedGraph classes
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_ColorFamilies.png?180|Automatic color family generation
Group colors by hue or quality}} 
\\
Automatic color family generation
Group colors by hue or quality
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_SelectiveDrawing.png?180|Draw or exclude features based on conditions
Render based on data points}} 
\\
Draw or exclude features based on conditions
Render based on data points
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_RestrictionLayers.png?180|Restrict drawing of features
Fill restricted areas with patterns or bitmaps}} 
\\
Restrict drawing of features
Fill restricted areas with patterns or bitmaps
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_DotDensity.png?180|Plots points on your map
Point density represents numeric data}} 
\\
Plots points on your map
Point density represents numeric data
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_RegEx.png?180|Render features based on a regular expression
Puts you in control}} 
\\
Render features based on a regular expression
Puts you in control
</div>

<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_ValueRendering.png?180|Render features based on a range of data values
Useful for points & labels}} 
\\
Render features based on a range of data values
Useful for points & labels
</div>

<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_ThematicFeatures.png?180|Render features specifically based on a theme
Colorize map features}} 
\\
Render features specifically based on a theme
Colorize map features
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_Projections.png?180|Project your spatial data
Nearly every known projection is available}} 
\\
Project your spatial data
Nearly every known projection is available
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_MapRotation.png?180|Draw your maps in any orientation you wish
Real-time rotation}} 
\\
Draw your maps in any orientation you wish
Real-time rotation
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_PointsUsingBitmaps.png?180|Draw an image at a point
Additional options include vector symbols}} 
\\
Draw an image at a point
Additional options include vector symbols
</div>


<div medialist imagewithremaker>
{{desktopedition:screenshot:Map_Suite_Desktop_Edition_Screenshot_Gallery_SampleApps.png?180|Dozens of interactive sample applications
Source code in C#}} 
\\
Dozens of interactive sample applications
Source code in C#
</div>


<div newline></div>
<div newline></div>

===== Frequently Asked Questions=====

  *[[Map Suite Desktop for WinForms FAQ General Questions|General Questions]]<div>These frequently asked questions cover high level GIS and mapping topics that are not categorized in other areas.</div>

===== Help & Support Guides =====
{{page>help_support_guides}}