# Thursday, November 26, 2009

For anyone who’s done any WPF control retemplating, it can sometimes be a daunting task. Some controls seem to retemplate with ease, while others can have a myriad of nested styles, with certain parts seeming to appear where you don’t expect them. Today, I ran into an interesting situation with the WPF Toolkit’s DataGrid – retemplating the column header sorting arrows.

As it turns out, the arrows for column sorting live in the control DataGridHeaderBorder. If we inspect the DataGrid.DataGridColumnHeader style in Blend…

Blend1

…notice there’s no placeholder for the arrows. Attempting to edit the default style for the Border won’t work either – there is no style to be found. There is no ControlTemplate to edit either, since DataGridHeaderBorder inherits from Border, which in turn inherits from FrameworkElement, and not Control. (Remember, Control defines the ControlTemplate property)

So where are the arrows defined then? Well, inspecting the source for the DataGridHeaderBorder…

/// <summary>
///     Called when this element should re-render.
/// </summary>
protected override void OnRender(DrawingContext dc)
{
if (UsingBorderImplementation)
{
    // Revert to the Border implementation
    base.OnRender(dc);
}
else
{
    // Choose the appropriate rendering based on the current theme
    switch (Theme)
    {
      // Omitted for brevity's sake...
      // A switch here calls RenderAeroNormalColor.
    }
}

private void RenderAeroNormalColor(DrawingContext dc)
{

   if (isSorted && (size.Width > 14.0) && (size.Height > 10.0))
   {
       // Draw the sort arrow
       TranslateTransform positionTransform = new TranslateTransform((size.Width - 8.0) * 0.5, 1.0);
       positionTransform.Freeze();
       dc.PushTransform(positionTransform);

       bool ascending = (sortDirection == ListSortDirection.Ascending);
       PathGeometry arrowGeometry = (PathGeometry)GetCachedFreezable(ascending ? (int)AeroFreezables.ArrowUpGeometry : (int)AeroFreezables.ArrowDownGeometry);


          // Actual drawing here, omitted for brevity's sake...
      }
}

If you snoop through this source (in the toolkit), you’ll notice the arrows are drawn in the OnRender() method of the DataGridHeaderBorder. In my humble opinion, I don’t think this is the most intuitive way to pull this effect off, but I’m sure there was a sound reason for it. In any case, if you’ve got your own sorting arrows that you wish to use, the easiest (and only way, I believe) to do this is to adjust their visibility by using the Triggers of the DataGridColumnHeader, namely the SortDirection property.

Special note: SortDirection is a nullable property – it is set to null when there is no sorting applied to the column. Keep this in mind when templating the control.

image For this demonstration, I’ve blown away the default DataGridHeaderBorder. I’ll use a regular Border, with a ContentPresenter within it (for the column header contents – don’t forget this), and two TextBlocks to indicate the sort direction. Remember, you aren’t limited to TextBlocks – you can use whatever you want to indicate sort direction. You can even use Storyboards that fire on the EnterAction property of the trigger to provide animations.

First, I created a style on the DataGridColumnHeader of a fresh DataGrid, and defined it in Window1.xaml. I blew away the default style and put in a Border containing a StackPanel, which contains the ContentPresenter and our two TextBlocks.

The TextBlocks are to be Collapsed by default, since the default state of a column is no sorting.

The reason I picked a StackPanel to contain the ContentPresenter and the sorting arrows is that I wanted to whip up a demo fairly quickly, and this is the fastest way to get the control to automatically resize itself to prevent waste of dead-space from the arrows. You can pull off the hiding of the space used by the arrows by using appropriate autosizing of grid columns, etc., a topic of which I’ll cover in a future article.

Next, we can apply our triggers to show the user what direction they are sorting. In the above screengrab, I’ve already added three Property triggers for  SortDirection: Ascending, Descending, and null. Null is used for when there is no sorting applied, and the other two are self-explanatory. So, depending on which value is currently set will define which arrows are visible.

With SortDirection = Ascending selected, I’ve set the Visibility property of the Up TextBlock to be visible, and for the SortDirection = Descending, the Dn TextBlock is visible. When null, no changes occur from the default style, which is to say both TextBlocks are Collapsed. The end result looks like this…

 

 image which goes to…  image

… and finally goes to…

image

Thursday, November 26, 2009 11:32:16 AM (Eastern Standard Time, UTC-05:00)  #    Disclaimer  |  Comments [0]  | 
# Thursday, November 19, 2009

Recently, I found a need to keep an item within a Scrollviewer from scrolling vertically, yet allow it to scroll horizontally. After a few fruitless attempts at banging my head against the wall on this issue, I found a solution that appeals to my sense of elegance. Not only that, but it’s a XAML-only approach. Sweet.

We make use of the RenderTransform property on a UIElement. Specifically, to allow the control to scroll horizontally but keep it fixed vertically, we’ll be using a TranslateTransform and tweaking its Y value. Thankfully, it derives from DependencyObject, so it’s eligible to participate in data binding, so that’s exactly what we’ll do.

<ScrollViewer x:Name="scrollViewer"
              HorizontalScrollBarVisibility="Visible">
    <Grid>
        <Rectangle Stroke="Blue"
                   StrokeThickness="4"
                   HorizontalAlignment="Left"
                   VerticalAlignment="Top"
                   Width="900"
                   Height="50">
            <Rectangle.RenderTransform>
                <TransformGroup>
                    <TranslateTransform Y="{Binding VerticalOffset, RelativeSource={RelativeSource FindAncestor, AncestorType={x:Type ScrollViewer}}, Mode=Default}"
                                        X="{Binding HorizontalOffset, ElementName=scrollViewer, Mode=Default}" />
                </TransformGroup>
            </Rectangle.RenderTransform>
        </Rectangle>

        <Rectangle Stroke="Black"
                   HorizontalAlignment="Left"
                   VerticalAlignment="Top"
                   Width="100"
                   Height="900"
                   StrokeThickness="4" />
    </Grid>
</ScrollViewer>

imageIn the above sample, I’ve bound to the Vertical/HorizontalOffset of the Scrollviewer in two ways. The first is using my preferred method of finding a specific element, RelativeSource FindAncestor. That signals the WPF binding engine to search through the visual tree for the first parent control of type Scrollviewer. This is convenient for when you don’t want (or need) to give your control a specific name, but still need to bind to it. The other method is to use the ElementName binding, which works just as well. The result?

The result is exactly what you would expect. The blue bordered rectangle appears to stay in the same spot, yet everything else within the Scrollviewer scrolls as per normal. Why?

During a RenderTransform, as far as the WPF layout engine is concerned, the Rectangle has not moved, since RenderTransforms are not applied until after the layout (measure/arrange) has been completed, ergo during the render pass.

Remember, a LayoutTransform will change the controls layout, which will be taken into account during the measure/arrange pass! This is why I used a RenderTransform to pull this off. As an exercise, you might want to change the RenderTransform to a LayoutTransform just to see what will happen.

As a side-note, yes, I realize I’m running in the classic Windows theme. It’s only because I’m not running Windows 7 (yet) on my main development box. Perhaps I’ll switch that over soon…

Thursday, November 19, 2009 12:24:13 PM (Eastern Standard Time, UTC-05:00)  #    Disclaimer  |  Comments [0]  | 
# Wednesday, March 18, 2009
Normally I don't blog at work, but today is a very special exception. Announcements include Expression Web SuperPreview, a beta of which is now available at http://shrinkster.com/15ad.

Various announcements concerning ASP.NET MVC 1.0, Velocity, and the like.

Just announced as I write this post is the Microsoft Web Platform Installer. Scott Hanselman has a post of this at http://shrinkster.com/15ae.

If you actually keep track of my site, go to http://live.visitmix.com/ and watch the keynote!

UPDATE: Silverlight 3 beta 1 SDK! Here we go again, kids. http://www.microsoft.com/downloads/details.aspx?FamilyID=D09B6ECF-9A45-4D99-B752-2A330A937BC4&displaylang=en This should prove interesting. It looks like Microsoft answered my prayers for a way to run a Silverlight app as a standalone application, like Adobe AIR. Awesome! http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=11dc7151-dbd6-4e39-878f-5081863cbb5d is where the VS tools are.

UPDATE THE SECOND: The Silverlight 3 tools are all available for download at http://silverlight.net/getstarted/silverlight3/default.aspx.

Wednesday, March 18, 2009 11:48:39 AM (Eastern Standard Time, UTC-05:00)  #    Disclaimer  |  Comments [0]  | 
# Saturday, March 14, 2009

You know you want some swag with my face plastered onto it in full monochrome glory. Now you can get your fill of Elias Puurunen anytime you want - http://www.cafepress.com/EliasPuurunen. Buy a T-shirt, buy a mug, hell, buy one (or more) of everything! Show some love in the form of your hard-earned recession-bail-out-package dollars.

Saturday, March 14, 2009 11:25:50 PM (Eastern Standard Time, UTC-05:00)  #    Disclaimer  |  Comments [0]  | 
# Sunday, March 08, 2009

2 After a few months of being M.I.A., a podcast that I didn't exactly maintain, and a successful university term, I think I'm back... for a little while at least. A number of things have changed in my world; I'm certainly busier these days than ever before.

First off, I will be speaking at the Toronto Code Camp on April 25, 2009! Go check out the details at http://www.torontocodecamp.net/. I'll be speaking about some of my experiences as a Windows Presentation Foundation developer, with the session being named WPF and the Model-View-ViewModel Pattern. I hope to make this an interesting session, and I plan to bring up the small nuances/gotchas that one might run into whilest working with WPF. (As an aside, enough W's in that last sentence?) It's an all-day event, my session is only an hour long, and it's free for anyone to attend. Come on out and see it!

IMG_0054 Next, I'm making a triumphant return to the world of water-cooled PC's. I've got the gear sitting on my desk as I type this article; it's a matter of taking the plans I've crafted, going to the hardware store, and getting the beast integrated into my system again, all without leaking liquid all over the place. Pictures will be forthcoming of that event.

Somewhat related to technology as well is the custom hybrid dance pad I built for Dance Dance Revolution. Dissatisfied with the way most soft pads work, I decided to venture out and build my own. Unfortunately, this didn't work out as well as I had planned, but I took plenty of pictures of the disaster, and once I locate the SD card they're stored upon, those will be posted as well. A wood version of the pad is currently in the works, and I plan on talking about that sucker plenty.

Finally, I'm in the process of moving the old blog to my new webhosting provider; I'll be porting over the old posts at some point. For now, I'm back. For a little while at least.

P.S.: For what it's worth, I've now got a Twitter account, since that seems to be the latest craze. Follow me at http://twitter.com/EliasPuurunen.

Sunday, March 08, 2009 7:35:21 PM (Eastern Standard Time, UTC-05:00)  #    Disclaimer  |  Comments [0]  |