MVVM Windows UWP apps with Template 10

1. MVVMWindowsUWP
Apps withTemplate 10
Jiri Danihelka

2. Blank template
• Blank App.xaml
• Blank MainPage.xaml/cs
• Blank MainPageViewModel.cs
• References
– XAML Behaviors SDK
– Newtonsoft JSON
– Template 10

3. Minimal template
• Folder conventions
• Settings Service
• Custom.xaml
• Extra features
– Splash.xaml
– Busy.xaml
– DetailsPage.xaml

4. Hamburger template
• Hamburger Menu
– Shell.xaml
• Folder conventions
• Settings Service
• Custom.xaml
• Extra features
– Splash.xaml
– Busy.xaml
– DetailsPage.xaml

5. Navigation service
• Enable consistent frame navigation
• Pass parameters to view-models
• Wrap the frame in a frame façade
• Extended behavior
– Refresh()
– OpenAsync()
– Save/RestoreNavState()

6. Navigation service

7. Settings helper
• Read, Write, and Cast
• Manages sub-containers
• Typically, used in your own Settings Service

8. Settings service

9. Logging service
• Disabled by default
• Writes T10 internal operations
• Add logging to any Windows app
• Customizable WriteLine() output

10. Logging service

11. Bootstrapper
It's responsibilities include:
1. Handling an extended splash screen
2. Creating the root frame
3. Wrapping the root in a modal dialog
4. Creating the navigation service
5. Aggregating activation paths
6. Automate suspension management
7. Support view-model injection

12. The activation pipeline
Special cases
• Application prelaunch
• Resuming from termination
• Special activation (file, protocol, share, etc.)
Constructor() OnInitializeAsync()
OnPrelaunchAsync()
[ optional ]
OnStartAsync()

13. Window wrapper
• Application View
• ActiveWrappers
• UI thread dispatcher
• Nested Navigation Services
• Close() method

14. Dispatcher wrapper
• Current
• Simplified dispatch
• Awaitable dispatch

15. Mvvm.BindableBase
• Reusable implementation of
INotifyPropertyChanged
• Marshals the PropertyChanged event
onto the current UI thread

16. Mvvm.DelegateCommand
• Reusable implementation of Icommand
– Support for CommandParameter
• Intended for Button controls

17. Mvvm.ViewModelBase
• Reusable implementation of INavigable
which enables the navigation service

18. Template 10 supports third-party frameworks
• MVVM Light
• Prism MVVM
• Caliburn Micro
• Others…

19. Template 10 supports MVVM-related patterns
• Blend design-time support
• Dependency injection
• Messaging

20. Page header
• Create a common page element
– Including header text
– Including primary buttons
– Including secondary buttons.
• Allows developers to create an easy uniform page UI.

21. Page header
• Key Features
– Primary buttons/commands
– Secondary buttons/commands (ellipsis menu)
– Back button, wired to navigate
– Easy look-and-feel style customization

22. Page header

23. Page header
• Navigation
– Add Frame reference
– Make Back button “visible”
– Ongoing visibility controlled by
Frame.CanGoBack, et al.
– Optional Bootstrapper.ShowShellBackButton = true;
– Developer can override back behavior
• Handle the Bootstrapper.BackRequested event
• Set args.Handled = true to stop back propagation

24. Page header
• Customization
– Text to define the text displayed
in the header (typically, the title
of the page)
– HeaderForeground to define the
text color of the header
– HeaderBackground to define
the background color of the
header

25. Page header
• PageHeader offers two categories of commands:
– PrimaryCommands are always visible.
– SecondaryCommands are hidden by default.