#usercontrol

Your feed used to be shaped by people you knew. Now it’s shaped by algorithms you don’t.

Anyone else miss the old timeline? 👀

Feels like we're slowly moving back toward decentralized social media, smaller communities, and more user-controlled platforms again.

People are starting to value privacy-first networks, algorithm-free feeds, and authentic digital connections over endless scrolling.

Introducing the New Dashboard

Yahoo's all about keeping our data safe while we enjoy their platforms! They've laid out how they use cookies to boost functionality, security, and personalized experiences. It’s all about giving users control—whether you want to accept all cookies for a more tailored experience or reject some to protect your privacy, the choice is yours.

Plus, you can tweak your settings anytime through their easy-to-navigate privacy dashboard. Transparency is key, and Yahoo invites you to learn more about how they handle your data. In a world where privacy matters more than ever, they’re stepping up to keep our info secure while still enhancing our online experience.

En XAML tenemos varias formas de escribir un código limpio y mantenible. Una de ellas es utilizar estilos, para ahorrarnos escribir una y otra vez los mismos valores y propiedades. Otra es el uso de DataTemplates, que nos permiten describir la estructura de un objeto con pelos y señales, pero aún tenemos una tercera, los UserControls.

¿Qué es un UserControl?

Un UserControl viene a ser un control que encapsula a su vez a otros controles dándoles además, un comportamiento propio.

Dicho control puede recibir parámetros, pero la implementación de esta funcionalidad no es del todo simple, así que me he creado un par de clases Base para facilitarme el trabajo.

BaseUserControl

public class BaseUserControl : UserControl { public event PropertyChangedEventHandler PropertyChanged; public BaseUserControl() : base() { } void SetValueDP(DependencyProperty property, object value, [System.Runtime.CompilerServices.CallerMemberName] String p = null) { SetValue(property, value); if (PropertyChanged != null) { PropertyChanged(this, new PropertyChangedEventArgs(p)); } } }

Esta clase limpia el cs del UserControl de la gestión del PropertyChanged.

Sin embargo, esta implementación es muy sencilla, y a veces necesito usar un Command y un CommandParameter en mis UserControls, para estos casos uso además la siguiente clase.

BaseCommandUserControl

public class BaseCommandUserControl : BaseUserControl { public BaseCommandUserControl() : base() { } public static readonly DependencyProperty TagProperty = DependencyProperty.Register("Tag", typeof(object), typeof(BaseCommandUserControl), null); public static readonly DependencyProperty CommandProperty = DependencyProperty.RegisterAttached("Command", typeof(ICommand), typeof(BaseCommandUserControl), new PropertyMetadata(null, OnCommandPropertyChanged)); public object Tag { get { return GetValue(TagProperty); } set { SetValue(TagProperty, value); } } public static void SetCommand(DependencyObject d, ICommand value) { d.SetValue(CommandProperty, value); } public static ICommand GetCommand(DependencyObject d) { return (ICommand)d.GetValue(CommandProperty); } protected static void OnCommandPropertyChanged(DependencyObject d, DependencyPropertyChangedEventArgs e) { var control = d as BaseCommandUserControl; if (control != null) control.Tapped += OnTapped; } private static void OnTapped(object sender, TappedRoutedEventArgs e) { var control = sender as BaseCommandUserControl; var command = GetCommand(control); command.Execute(control.Tag); } }

De esta forma puedo, por ejemplo, enlazar un comando al Tap de la Grid principal del UserControl.

¿Y como sería la implementación del UserControl?

El CS del UserControl

public sealed partial class UCProfileButton : BaseCommandUserControl { public static readonly DependencyProperty ContentLineProperty = DependencyProperty.Register("ContentLine", typeof(string), typeof(UCProfileButton), null); public static readonly DependencyProperty HeaderProperty = DependencyProperty.Register("Header", typeof(string), typeof(UCProfileButton), null); public static readonly DependencyProperty IconProperty = DependencyProperty.Register("Icon", typeof(SymbolIcon), typeof(UCProfileButton), null); public UCProfileButton() : base() { this.InitializeComponent(); (this.Content as FrameworkElement).DataContext = this; } public string Header { get { return (string)GetValue(HeaderProperty); } set { SetValue(HeaderProperty, value); } } public string ContentLine { get { return (string)GetValue(ContentLineProperty); } set { SetValue(ContentLineProperty, value); } } public SymbolIcon Icon { get { return (SymbolIcon)GetValue(IconProperty); } set { SetValue(IconProperty, value); } } }

En nuestro UserControl añadimos las propiedades estáticas que queramos actualizar pasando parámetros desde la vista.

Y finalmente el XAML.

El XAML del UserControl

<local:BaseCommandUserControl x:Class="Msw.Presentation.Apps.Windows8.UserControls.UCProfileButton" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:local="using:Msw.Presentation.Apps.Windows8.UserControls" xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d" d:DesignHeight="300" d:DesignWidth="400"> <Button Style="{StaticResource ButtonProfileStyle}" HorizontalAlignment="Center" Visibility="{Binding ContentLine, Converter={StaticResource nullOrEmptyVisibilityConverter}}"> <Grid VerticalAlignment="Center" HorizontalAlignment="Center" Width="260"> <Grid.ColumnDefinitions> <ColumnDefinition Width="Auto"/> <ColumnDefinition Width="*"/> </Grid.ColumnDefinitions> <Grid.RowDefinitions> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <AppBarButton Icon="{Binding Icon, Mode=OneWay}" IsCompact="True" Grid.RowSpan="2" IsHitTestVisible="False"/> <TextBlock Grid.Column="1" Text="{Binding Header, Mode=OneWay}" Style="{StaticResource SubheaderTextBlockStyle}" Foreground="White" /> <TextBlock Grid.Column="1" Grid.Row="1" Text="{Binding ContentLine}" Style="{StaticResource BaseTextBlockStyle}" Foreground="White" /> </Grid> </Button> </local:BaseCommandUserControl>

Esta semana debía añadir un control de valoración en una de nuestras aplicaciones, dicho control debía permitir la visualización, pero también la modificación del valor, permitiendo tanto estrellas enteras como medias estrellas.

Exáctamente esto:

Tras un rato buscando, lo más cercano que encontré fue un control realizado por Shai Raiten. Sin embargo, su control era de visualización y no de entrada de datos, así que he hecho unos pequeños cambios.

Necesitaremos seguir tres pasos:

Crear el control de valoración

Crear el convertidor que dado un valor muestre las estrellas

Añadir el control de valoración a la vista.

Paso 1 - Creación del UserControl

En primer lugar deberemos crear el UserControl y asignar los recursos que necesitamos. Uno será el Converter, que crearemos más tarde, y el otro la string que usaremos para crear las estrellas.

<UserControl.Resources> <converter:RatingValueToWidthConverter x:Key="ratingValueToWidthConverter" /> <x:String x:Key="StarPath">F1 M 0,217.042L 227.5,217.042L 297.875, 0L 367.542,217L 595.542,217L 410.208,353.667L 480.708, 569.667L 297.208,436.667L 116.208,568.167L 185.708,352.667L 0,217.042 Z</x:String> </UserControl.Resources>

Evidentemente deberemos añadir el xmlns que del namespace donde crearemos el Converter, que en mi caso es:

xmlns:converter="using:AppRating.Converter"

Hecho esto deberemos crear el XAML del UserControl.

<Grid x:Name="MainGrid"> <Grid.RowDefinitions> <RowDefinition Height="Auto"/> <RowDefinition Height="Auto"/> </Grid.RowDefinitions> <Grid.ColumnDefinitions> <ColumnDefinition Width="*"/> <ColumnDefinition Width="*"/> <ColumnDefinition Width="*"/> <ColumnDefinition Width="*"/> <ColumnDefinition Width="*"/> </Grid.ColumnDefinitions> <Path Name="star" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="0" Grid.Row="1" Fill="Gold" Margin="4" HorizontalAlignment="Left" VerticalAlignment="Top" d:LayoutOverrides="Width, Height" /> <Path x:Name="star2" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="1" Grid.Row="1" Fill="Gold" Margin="4" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Path x:Name="star3" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="2" Grid.Row="1" Fill="Gold" Margin="4" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Path x:Name="star4" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="3" Grid.Row="1" Fill="Gold" Margin="4" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Path x:Name="star5" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="4" Grid.Row="1" Fill="Gold" Margin="4" HorizontalAlignment="Left" VerticalAlignment="Top" /> <TextBlock Text="{Binding Header, Mode=OneWay}" Grid.ColumnSpan="5" Style="{StaticResource BaseTextBlockStyle}" Margin="0,12"/> <Rectangle x:Name="Mask" Fill="{ThemeResource ApplicationPageBackgroundThemeBrush}" VerticalAlignment="Top" Height="{Binding ElementName=star, Path=ActualHeight}" HorizontalAlignment="Right" Width="{Binding Rating, Converter={StaticResource ratingValueToWidthConverter}}" RenderTransformOrigin="0.5,0.5" Grid.ColumnSpan="5" Grid.Row="1" Margin="0,4"/> <Path Name="border" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="0" Grid.Row="1" StrokeThickness="1" Stroke="Goldenrod" Margin="3" HorizontalAlignment="Left" VerticalAlignment="Top" d:LayoutOverrides="Width, Height"/> <Path x:Name="border2" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="1" Grid.Row="1" StrokeThickness="1" Stroke="Goldenrod" Margin="3" HorizontalAlignment="Left" VerticalAlignment="Top"/> <Path x:Name="border3" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="2" Grid.Row="1" StrokeThickness="1" Stroke="Goldenrod" Margin="3" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Path x:Name="border4" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="3" Grid.Row="1" StrokeThickness="1" Stroke="Goldenrod" Margin="3" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Path x:Name="border5" Stretch="Uniform" Data="{StaticResource StarPath}" Grid.Column="4" Grid.Row="1" StrokeThickness="1" Stroke="Goldenrod" Margin="3" HorizontalAlignment="Left" VerticalAlignment="Top" /> <Canvas Grid.ColumnSpan="5" Grid.Row="1" Tapped="Canvas_Tapped" Background="Transparent"/> </Grid>

Como veis, he hecho alguna modificación respecto al código de Shai Raiten, he creado una Grid con columnas para albergar las estrellas en lugar de usar margins (de esta forma nos será más fácil controlar el tamaño del control) y he añadido un Canvas al final de todo que mediante un evento Tapped nos permitirá modificar el Rating pinchando en las estrellas.

Finalmente iremos al CS del usercontrol para añadir las propiedades Header y Rating al UserControl, para que puedan ser modificadas desde el XAML de la vista.

public static readonly DependencyProperty RatingProperty = DependencyProperty.Register("Rating", typeof(double), typeof(UCRating), null); public static readonly DependencyProperty HeaderProperty = DependencyProperty.Register("Header", typeof(string), typeof(UCRating), null); public event PropertyChangedEventHandler PropertyChanged; public UCRating() { this.InitializeComponent(); (this.Content as FrameworkElement).DataContext = this; } void SetValueDP(DependencyProperty property, object value, [System.Runtime.CompilerServices.CallerMemberName] String p = null) { SetValue(property, value); if (PropertyChanged != null) { PropertyChanged(this, new PropertyChangedEventArgs(p)); } } /// Texto del TextBlock public string Header { get { return (double)GetValue(HeaderProperty); } set { SetValue(HeaderProperty, value); } } /// Valoración de las estrellas public double Rating { get { return (double)GetValue(RatingProperty); } set { SetValue(RatingProperty, value); } }

Además del evento del Canvas que nos servirá para actualizar el control.

/// Evento que se dispara al hacer Tap en el canvas private void Canvas_Tapped(object sender, TappedRoutedEventArgs e) { var position = e.GetPosition((Canvas)sender).X; double max = ((Canvas)sender).ActualWidth; Rating = 5 - Math.Round(((-position + max) * 5 / max) * 2, MidpointRounding.AwayFromZero) / 2; }

Le he añadido un Match Round para que permita la entrada de valor enteros y medios.

Paso 2 - Creación del Converter

Aquí no hay mucho secreto, creamos un convertidor que dado un valor de tipo double nos devuelva un ancho, que hará que la máscara nos muestre pintadas las estrellas que tocan. 

/// Convertidor que devuelve el ancho dependiendo de un double public class RatingValueToWidthConverter : IValueConverter { //ancho del control private const double Max = 150; public object Convert(object value, Type targetType, object parameter, string lang) { var rate = (double)value; return ((((rate) * Max) / 5.0) - Max) * -1.0; } public object ConvertBack(object value, Type targetType, object parameter, string lang) { throw new NotImplementedException(); } }

Hay que tener en cuenta que si queremos modificar el ancho del control lo deberemos modificar también aquí en el valor Max.

Paso 3 - Añadir el UserControl al XAML de la vista

Finalmente añadimos el "xmlns" y el control a la vista.

xmlns:uc="using:AppRating.UserControls"

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> <uc:UCRating x:Uid="UCRating" Header="Valoración" Rating="3.5" Width="150" VerticalAlignment="Center"/> </Grid>