This sample demonstrates how to use the application settings API and settings flyouts to integrate an app's settings UI with the Settings charm.

The sample uses the Windows.UI.ApplicationSettings namespace and WinJS.UI.SettingsFlyout or Windows.UI.Xaml.Controls.SettingsFlyout control.

The Settings charm provides users with a consolidated place for fast, in-context access to settings that affect the current Windows Store app experience. By participating in the Settings contract, an app can include app-specified settings commands in the Settings charm and launch the corresponding settings UI from that standard entry point.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.

Note  For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.

Related topics

Adding app settings
Windows 8 app samples
Windows.UI.ApplicationSettings
WinJS.UI.SettingsFlyout
Windows.UI.Xaml.Controls.SettingsFlyout

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2

Build the sample

  1. Start Visual Studio 2013 and select File > Open > Project/Solution.
  2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Visual Studio 2013 Solution (.sln) file.
  3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.