Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

UWP.MDI

UWP.MDI provides Multiple document interface (MDI) support for UWP applications.

NuGet

Background

MDI (Multiple Document Interface) was popular user interface paradigma in Windows Forms era. MDI allows one window to host multiple child windows. Each window can be resized and moved around.

When WPF was released, it didn't contain support for MDI interfaces and the situation didn't change when WinRT and UWP were released.

UWP.MDI has three targets:

  1. To provide comprehensive MDI support for UWP applications.
  2. To provide MDI support in such a way that those familiar with Windows Forms' MDI support feel at home.
  3. To provide the extra benefits of MVVM & Data binding & XAML into the MDI world.

Getting started

  1. Create a blank Universal Windows Application
  2. Add UWP.MDI from NuGet https://www.nuget.org/packages/UWP.MDI/
  3. Add MDIContainer to MainPage:
<Page
    x:Class="UWP.MDI.Sample.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:UWP.MDI.Sample"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    xmlns:controls="using:Microsoft.Toolkit.Uwp.UI.Controls"
    xmlns:mdi="using:UWP.MDI.Controls"
    mc:Ignorable="d">

    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
        <mdi:MDIContainer />
    </Grid>
</Page>
  1. Create UserControl with the content you like.

  2. In MainApplication, create a new instance of the UserControl and use Show-method to display it:

         var frm = new CustomerForm();
         frm.Show();
    

Samples

For samples, check out the samples folder inside this repository.

Basics

Each application should have single MDIContainer. MDIContainer is used to host the windows.

Each window should be a UserControl.

Use attached properties provided by FormProperties to configure the basic settings of your child windows. For example: Title, Starting position.

MVVM Support

See the following sample: https://github.com/mikoskinen/UWP.MDI/tree/master/samples/UWP.MDI.MVVM

Customizations

Title

To add title for your UserControl, use AttachedProperty FormProperties.Text. For example:

Width and height

To set starting size for your UserControl, set UserControl's Width and Height properties.

Visual style

To change the styling, use MDIChild.xaml and MDIContainer.xaml as basis.

Supported settings

The settings/configuration for child windows are provided using attached properties.

Title: FormProperties.Text Starting position: FormProperties.FormStartPosition Resizable or not: FormProperties.FormBorderStyle

Layouts

UWP.MDI contains three built-in layouts for your child windows: TileHorizontal, TileVertical and Cascade. You can organize your current windows at any point by calling MDIContainer.LayoutMdi.

For example:

mdiContainer.LayoutMdi(MdiLayout.Cascade);

For sample see samples\UWP.MDI.Layouts

Dependencies

UWP.MDI doesn't have external dependencies.

Acknowledgements

UWP.MDI contains code from the following projects:

About

Multiple document interface (MDI) support for UWP applications

Resources

License

Releases

No releases published

Packages

No packages published

Languages

You can’t perform that action at this time.