Windows 10 RTM Release - March 2016 Update 3

Author: oldnewthing

Samples/BasicSuspension/cs/BasicSuspension.csproj

@@ -11,7 +11,7 @@
     <AssemblyName>BasicSuspension</AssemblyName>
     <DefaultLanguage>en-US</DefaultLanguage>
     <TargetPlatformIdentifier>UAP</TargetPlatformIdentifier>
-    <TargetPlatformVersion>10.0.10240.0</TargetPlatformVersion>
+    <TargetPlatformVersion>10.0.10586.0</TargetPlatformVersion>
     <TargetPlatformMinVersion>10.0.10240.0</TargetPlatformMinVersion>
     <MinimumVisualStudioVersion>14</MinimumVisualStudioVersion>
     <EnableDotNetNativeCompatibleProfile>true</EnableDotNetNativeCompatibleProfile>

Samples/BasicSuspension/cs/Package.appxmanifest

@@ -13,7 +13,7 @@
     <Logo>Assets\StoreLogo-sdk.png</Logo>
   </Properties>
   <Dependencies>
-    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10240.0"/>
+    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.10240.0" MaxVersionTested="10.0.10586.0"/>
   </Dependencies>
   <Resources>
     <Resource Language="x-generate"/>

Samples/FileAccess/cpp/SampleConfiguration.cpp

@@ -34,17 +34,13 @@ void MainPage::Initialize()
 
 void MainPage::ValidateFile()
 {
-
     create_task(KnownFolders::GetFolderForUserAsync(nullptr /* current user */, KnownFolderId::PicturesLibrary)).then([this](StorageFolder^ picturesFolder)
     {
-        return picturesFolder->GetFileAsync(Filename);
-    }).then([this](task<StorageFile^> getFileTask)
+        return picturesFolder->TryGetItemAsync(Filename);
+    }).then([this](IStorageItem^ item)
     {
-        try
-        {
-            sampleFile = getFileTask.get();
-        }
-        catch (Exception^)
+        sampleFile = safe_cast<StorageFile^>(item);
+        if (item == nullptr)
         {
             // If file doesn't exist, indicate users to use scenario 1
             NotifyUserFileNotExist();

Samples/FileAccess/cs/SampleConfiguration.cs

@@ -46,12 +46,9 @@ public partial class MainPage : Page
         /// </summary>
         internal async void ValidateFile()
         {
-            try
-            {
-                StorageFolder picturesLibrary = await KnownFolders.GetFolderForUserAsync(null /* current user */, KnownFolderId.PicturesLibrary);
-                sampleFile = await picturesLibrary.GetFileAsync(filename);
-            }
-            catch (FileNotFoundException)
+            StorageFolder picturesLibrary = await KnownFolders.GetFolderForUserAsync(null /* current user */, KnownFolderId.PicturesLibrary);
+            sampleFile = (StorageFile)await picturesLibrary.TryGetItemAsync(filename);
+            if (sampleFile == null)
             {
                 // If file doesn't exist, indicate users to use scenario 1
                 NotifyUserFileNotExist();

Samples/FileAccess/js/js/sample-configuration.js

@@ -24,18 +24,14 @@
 
     function validateFileExistence() {
         Windows.Storage.KnownFolders.getFolderForUserAsync(null /* current user */, Windows.Storage.KnownFolderId.picturesLibrary).then(function (picturesLibrary) {
-            return picturesLibrary.getFileAsync("sample.dat");
-        }).done(
-            function (file) {
-                // If file exists. 
-                SdkSample.sampleFile = file;
-            },
-            function (err) {
+            return picturesLibrary.tryGetItemAsync("sample.dat");
+        }).done(function (item) {
+            SdkSample.sampleFile = item;
+            if (!item) {
                 // If file doesn't exist, indicate users to use scenario 1. 
-                SdkSample.sampleFile = null;
                 WinJS.log && WinJS.log("The file 'sample.dat' does not exist. Use scenario one to create this file.", "sample", "error");
             }
-        );
+        });
     };
 
     WinJS.Namespace.define("SdkSample", {

Samples/XamlNavigation/README.md

@@ -11,6 +11,7 @@ Specifically, this sample shows how to:
 
 - **Utilize a SplitView control:** The SplitView is a control with two content areas: the Pane and the Content.  The Pane can be opened or closed.  Using the DisplayMode property the app can switch the Pane to Overlay the Content or appear Inline.  When the available space is constrained the Pane can be put into a CompactOverlay or CompactInline mode where it provides a visual hint to the user. 
 - **Customize a ListView to present menu items with a single-selection experience:** This uses a ListView to present the default visuals for the menu items and customizes the keyboarding behavior to provide a single selection model where up/down/tab/shift+tab moves through each item and 'Enter' and 'Space' select the item. 
+- **Position the CommandBar based on the screen size:** This sample moves the CommandBar to the bottom on screens less than seven inches diagonal.
 
 **Note** The Windows universal samples require Visual Studio 2015 to build and Windows 10 to execute.
 
@@ -34,11 +35,11 @@ To obtain information about Microsoft Visual Studio 2015 and the tools for devel
 
 ## System requirements
 
-**Client:** Windows 10
+**Client:** Windows 10 Version 1511
 
 **Server:** Windows Server 2016 Technical Preview
 
-**Phone:**  Windows 10
+**Phone:**  Windows 10 Version 1511
 
 ## Build the sample
 

Samples/XamlNavigation/cpp/App.xaml.cpp

@@ -14,6 +14,8 @@ using namespace Windows::ApplicationModel;
 using namespace Windows::ApplicationModel::Activation;
 using namespace Windows::Foundation;
 using namespace Windows::Foundation::Collections;
+using namespace Windows::UI;
+using namespace Windows::UI::ViewManagement;
 using namespace Windows::UI::Xaml;
 using namespace Windows::UI::Xaml::Controls;
 using namespace Windows::UI::Xaml::Controls::Primitives;
@@ -50,6 +52,18 @@ void App::OnLaunched(Windows::ApplicationModel::Activation::LaunchActivatedEvent
     }
 #endif
 
+    // Change minimum window size
+    ApplicationView::GetForCurrentView()->SetPreferredMinSize(Size(320, 200));
+
+    // Darken the window title bar using a color value to match app theme
+    ApplicationViewTitleBar^ titleBar = ApplicationView::GetForCurrentView()->TitleBar;
+    if (titleBar != nullptr)
+    {
+        Color color = safe_cast<Color>(this->Resources->Lookup(L"SystemChromeMediumColor"));
+        titleBar->BackgroundColor = color;
+        titleBar->ButtonBackgroundColor = color;
+    }
+
     auto shell = dynamic_cast<AppShell^>(Window::Current->Content);
 
     // Do not repeat app initialization when the Window already has content,
@@ -75,7 +89,7 @@ void App::OnLaunched(Windows::ApplicationModel::Activation::LaunchActivatedEvent
     if (shell->AppFrame->Content == nullptr)
     {
         // When the navigation stack isn't restored navigate to the first page,
-        // suppressing the initial entrance animation and configuring the new 
+        // suppressing the initial entrance animation and configuring the new
         // page by passing required information as a navigation parameter
         shell->AppFrame->Navigate(TypeName(Views::LandingPage::typeid), e->Arguments, ref new Windows::UI::Xaml::Media::Animation::SuppressNavigationTransitionInfo());
     }

Samples/XamlNavigation/cpp/AppShell.xaml.cpp

@@ -191,7 +191,7 @@ namespace NavigationMenuSample
             auto container = (ListViewItem^)NavMenuList->ContainerFromItem(item);
 
             // While updating the selection state of the item prevent it from taking keyboard focus.  If a
-            // user is invoking the back button via the keyboard causing the selected nav menu item to change 
+            // user is invoking the back button via the keyboard causing the selected nav menu item to change
             // then focus will remain on the back button.
             if (container != nullptr) container->IsTabStop = false;
             NavMenuList->SetSelectedItem(container);
@@ -209,11 +209,9 @@ namespace NavigationMenuSample
             control->Loaded += ref new RoutedEventHandler(this, &AppShell::Page_Loaded);
         }
 
-        // Update the Back button depending on whether we can go Back.
+        // Show the Back button
         SystemNavigationManager::GetForCurrentView()->AppViewBackButtonVisibility =
-            AppFrame->CanGoBack ?
-            Windows::UI::Core::AppViewBackButtonVisibility::Visible :
-            Windows::UI::Core::AppViewBackButtonVisibility::Collapsed;
+            Windows::UI::Core::AppViewBackButtonVisibility::Visible;
     }
 
     void AppShell::Page_Loaded(Object^ sender, RoutedEventArgs^ e)
@@ -223,24 +221,56 @@ namespace NavigationMenuSample
     }
 
     /// <summary>
-    /// Callback when the SplitView's Pane is toggled open or close.  When the Pane is not visible
-    /// then the floating hamburger may be occluding other content in the app unless it is aware.
+    /// Public method to allow pages to open SplitView's pane.
+    /// Used for custom app shortcuts like navigating left from page's left-most item
+    /// </summary>
+    void AppShell::OpenNavePane()
+    {
+        TogglePaneButton->IsChecked = true;
+        NavPaneDivider->Visibility = Windows::UI::Xaml::Visibility::Visible;
+    }
+
+    // <summary>
+    /// Hide divider when nav pane is closed.
+    /// </summary>
+    /// <param name="sender"></param>
+    /// <param name="args"></param>
+    void AppShell::RootSplitView_PaneClosed(SplitView^ sender, Object^ args)
+    {
+        NavPaneDivider->Visibility = Windows::UI::Xaml::Visibility::Collapsed;
+    }
+
+    /// <summary>
+    /// Callback when the SplitView's Pane is toggled opened.
+    /// Restores divider's visibility and ensures that margins around the floating hamburger are correctly set.
     /// </summary>
     /// <param name="sender"></param>
     /// <param name="e"></param>
     void AppShell::TogglePaneButton_Checked(Object^ sender, RoutedEventArgs^ e)
+    {
+        NavPaneDivider->Visibility = Windows::UI::Xaml::Visibility::Visible;
+        CheckTogglePaneButtonSizeChanged();
+    }
+
+    /// <summary>
+    /// Callback when the SplitView's Pane is toggled closed.  When the Pane is not visible
+    /// then the floating hamburger may be occluding other content in the app unless it is aware.
+    /// </summary>
+    /// <param name="sender"></param>
+    /// <param name="e"></param>
+    void AppShell::TogglePaneButton_Unchecked(Object^ sender, RoutedEventArgs^ e)
     {
         CheckTogglePaneButtonSizeChanged();
     }
 
-	/// <summary>
-	/// Ensure that we update the reported size of the TogglePaneButton when the SplitView's 
-	/// DisplayMode changes.
-	/// </summary>
-	void AppShell::RootSplitViewDisplayModeChangedCallback(DependencyObject^ sender, DependencyProperty^ dp)
-	{
-		CheckTogglePaneButtonSizeChanged();
-	}
+    /// <summary>
+    /// Ensure that we update the reported size of the TogglePaneButton when the SplitView's
+    /// DisplayMode changes.
+    /// </summary>
+    void AppShell::RootSplitViewDisplayModeChangedCallback(DependencyObject^ sender, DependencyProperty^ dp)
+    {
+        CheckTogglePaneButtonSizeChanged();
+    }
 
     /// <summary>
     /// Check for the conditions where the navigation pane does not occupy the space under the floating

Samples/XamlNavigation/cpp/AppShell.xaml.h

@@ -32,6 +32,7 @@ namespace NavigationMenuSample
         {
             Windows::UI::Xaml::Controls::Frame^ get();
         }
+        void OpenNavePane();
 
     internal:
         /// <summary>
@@ -62,9 +63,11 @@ namespace NavigationMenuSample
         void OnNavigatingToPage(Object^ sender, NavigatingCancelEventArgs^ e);
         void OnNavigatedToPage(Object^ sender, NavigationEventArgs^ e);
         void Page_Loaded(Object^ sender, RoutedEventArgs^ e);
+        void RootSplitView_PaneClosed(SplitView^ sender, Object^ args);
         void TogglePaneButton_Checked(Object^ sender, RoutedEventArgs^ e);
+        void TogglePaneButton_Unchecked(Object^ sender, RoutedEventArgs^ e);
         void CheckTogglePaneButtonSizeChanged();
-		void RootSplitViewDisplayModeChangedCallback(DependencyObject^ sender, DependencyProperty^ dp);
+        void RootSplitViewDisplayModeChangedCallback(DependencyObject^ sender, DependencyProperty^ dp);
         void NavMenuItemContainerContentChanging(ListViewBase^ sender, ContainerContentChangingEventArgs^ args);
 
         Vector<NavMenuItem^>^ navlist;