Here is how to setup the service in your WinUI or mobile apps made with Uno Platform. If you want to know how to setup this service for UWP, check out getting started with UWP.
Install the MessageDialogService.Uno.WinUI NuGet package.
Create a MessageDialogService instance.
using Windows.ApplicationModel.Resources;
// (...)
var currentWindow = yourWindow; // Get the current window.;
var dispatcherQueue = currentWindow.DispatcherQueue;
var resourceLoader = ResourceLoader.GetForViewIndependentUse();
var resourceResolver = resourceKey => resourceLoader.GetString(resourceKey);
var messageDialogService = new MessageDialogService.MessageDialogService(
dispatcherQueue,
#if __IOS__ || __ANDROID__
new MessageDialogBuilderDelegate(resourceResolver)
#else
// On Windows, the builder delegate needs a window handle.
new MessageDialogBuilderDelegate(
resourceResolver,
WinRT.Interop.WindowNative.GetWindowHandle(currentWindow)
)
#endif
);
You can use the AcceptOrDefaultMessageDialogService in test projects to simulate a message dialog that always takes the accept or default command.
Here is some code showing how to set it up using Microsoft.Extensions.DependencyInjection.
First, you'll need to install the MessageDialogService NuGet package in your test project.
You can get the result of the dialog using ShowMessage. This will return a MessageDialogResult enum value.
var result = await _messageDialogService.ShowMessage(ct, mb => mb
.Title("Logout")
.Content("Are you sure you want to logout?")
.CancelCommand()
.AcceptCommand(acceptResourceKey: "Logout_Confirm")
);
if (result == MessageDialogResult.Accept)
{
// Logout
}
Use Your Own Return Type
When MessageDialogResult doesn't cover all your needs, you can use your own return type by using the ShowMessage<TResult> method. This will return a TResult value.
You can use the isDesctructive parameter of the Command and CommandResource methods to make the command red on iOS.
This option has no effect on Windows and Android.
var result = await _messageDialogService.ShowMessage(ct, mb => mb
.Title("Delete")
.Content("Are you sure you want to delete the selected items?")
.CancelCommand()
.Command(MessageDialogResult.Accept, label: "Delete", isDestructive: true)
);
if (result == MessageDialogResult.Accept)
{
// Delete
}
Changelog
Please consult the CHANGELOG for more information about version
history.
License
This project is licensed under the Apache 2.0 license - see the
LICENSE file for details.
Contributing
Please read CONTRIBUTING.md for details on the process for
contributing to this project.
