depechie/uwpprojects

A set of UWP controls and utilities

UwpProjects

A set of UWP controls and utilities that I have built and used as a Windows dev. I will continue to add to this from my personal colleciton of do-dads and bobbles and as a I build new ones.

##Contents

• AdaptiveGridView in UwpHelpers.Controls.ListControls (maintains aspect ratio of items as it scales for column width)
• BusyIndicators in UwpHelpers.Controls.BusyIndicators (custom busy indicators)
• BlurElementAsync in UwpHelpers.Examples.Helpers (converts any UIElement into a blurred bitmap)
• IncrementalLoadingCollection in UwpHelpers.Controls.Common (Use this for lazy-loading scenarios, demo in Examples)
• NetworkImage in UwpHelpers.Controls.ImageControls (an Image control that shows download progress)
• DownloadStreamWithProgressAsync in UwpHelpers.Controls.Extensions (HttpClient Extension methods that reports download progress)
• ReleaseNotesDialog in UwpHelpers.Controls.Dialogs (shows a list of Features and Fixes using the familiar ContentDialog approach)

###AdaptiveGridView

###AdaptiveGridView with grouping

Properties

• MinItemWidth (double)
• MinItemHeight (double)

Example

<listControls:AdaptiveGridView ItemsSource="{Binding ListItems}"
       MinItemHeight="105"
       MinItemWidth="315">
       

###BusyIndicators

• BandBusyIndicator
• DownloadUploadIndicator

Properties

• IsActive (boolean): shows or hides the indicator
• Direction (AnimationDirection): The direction of the animation
• DisplayMessage (string): message shown when active
• DisplayMessageSize (double): message font size

<busyIndicators:BandBusyIndicator IsActive="{Binding IsBusy}"
      DisplayMessage="busy..."
      Direction="Uploading"  />

###BlurElementAsync

Example

//You can pass any UIElement to the method and it will render all of the children into a bitmap with a Blur applied
var blurredElement = await ContentToBlur.BlurElementAsync();

//example: you can then set Background brush of a Grid
ContentRootGrid.Background = new ImageBrush
{
  ImageSource = blurredBitmapImage,
  Stretch = Stretch.UniformToFill
};

###IncrementalLoadingCollection

Example

XAML

<ListView ItemsSource="{Binding InfiniteItems}" />

ViewModel or Code-Behind

InfiniteItems = new IncrementalLoadingCollection<T>((cancellationToken, count) => Task.Run(GetMoreData, cancellationToken));
    
//and GetMoreData is
private async Task<ObservableCollection<T>> GetMoreData()
{
   return more items of type ObservableCollection<T>
}

###NetworkImage

Properties

• ImageUrl (string): string url of the photo
• IsActive (bool) - the control manages this automatically, but you can manually enable/disable if needed
• DownloadPercentageVisibility (Visibility) - If you want to hide the progress percentage
• ProgressRingVisibility (Visibility) - If you want to hide the ProgressRing animation
• ImageStretch (Stretch) - Stretch property passed ot the underlying Image control

Example

XAML

<imageControls:NetworkImage ImageUrl="http://bigimages.com/MyHugeImage.jpg" />

###DownloadStreamWithProgressAsync (HttpClient Extension)

Properties

• Url (string): url of the thing you want to download
• Reporter (Progress<DownloadProgressArgs>) - reports the progress via event, see example below

Note: There are a couple more methods in the helper class (i.e. DownloadStringwithProgressAsync)

Example

C# - usage

var reporter = new Progress<DownloadProgressArgs>();
reporter.ProgressChanged += Reporter_ProgressChanged;

var imageStream = await new HttpClient(myFavoriteHandler).DownloadStreamWithProgressAsync(bigImageUrl, reporter)
    

C# - event handler

private void Reporter_ProgressChanged(object sender, DownloadProgressArgs e)
{
    SomeProgressBar.Value = e.PercentComplete;
}
    

###ReleaseNotesDialog

Properties

• AppName (string): Set the Dialog's title, default value is "Release Notes"
• Features (ObservableCollection<string>): List of new features
• Fixes (ObservableCollection<string>): List of fixes
• UseFullVersionNumber (bool): Determines whether to show the Build number (1.0.X).

Example

C# - usage

 var rnd = new ReleaseNotesDialog();
    
rnd.AppName = "My App Name";
rnd.Message = "Thank you for checking out ReleaseNotesDialog! Here's a list of what's new and what's fixed:";
    
rnd.Features = new ObservableCollection<string>
{ 
    "Amazing feature!", 
    "Added theming", 
    "Backup and restore added!" 
};
    
rnd.Fixes = new ObservableCollection<string>
{
    "Fixed crash when opening",
    "Added text wrapping to fix text being cut off"
};
    
await rnd.ShowAsync();