Saturday, July 04, 2009   Search 
Links

 

Disciple
 My WPF Code Snippets Minimize
Location: BlogsAsk Dr. WPF    
Posted by: Dr. WPF 12/17/2007 7:32 AM

Yikes!  Has it really been over a month since my last blog entry!?!

Okay, the last 6 weeks are a bit hazy and I wish I could blame my absence from the WPF Forum (and this blog) on something exciting, but honestly, it's just been work.  A number of projects all converged at once creating "the perfect storm" of work engagements.  And although I love writing WPF code, I'm now hoping for a small respite from the daily deadlines.  Hopefully, the next few weeks will be a little more tame and I will be able to catch up with life in the WPF community.

Whenever we go through these crunch times, I realize how much I've come to depend upon the code snippet support in Visual Studio 2005/2008.  I totally rely on my WPF code snippets... and its not just because of the time they save me writing code, but also because of the consistency they bring to my code.  I can look at any WPF classes I've written over the past few years and immediately understand what is going on in the properties, events, and commands exposed by those classes.

If you do not yet have a good set of Visual Studio code snippets, I would encourage you to develop them.  I have posted my C# WPF snippets here for anyone who is interested in perusing, adopting, or improving them. 

<UPDATE>

January 4, 2008:  The downloadable snippets file now contains a .vsi file that can be used to directly import these snippets into Visual Studio 2005/2008.  (Special thanks to the coworker who was nice enough to create the install package for me!)

</UPDATE>

(Apologies to the VB.NET WPF developers out there...  I have never ported these to VB, as the time I spend writing VB code is extremely limited.  But if anyone is up for a challenge and wants to port these and send them my way, I'd be happy to post the equivalent VB snippets on my site.)

<UPDATE>

September 22, 2008:  I finally got around to porting these snippets to VB.  See this post for the details.

</UPDATE>

I have designed these snippets to cover 98% of the usage scenarios that I encounter in a typical WPF development project.  I have also designed them to enforce good coding patterns, especially around consistency and documentation.

I won't spend a lot of time explaining how to use them (because hopefully they are self-explanatory for WPF developers).  There are really only three shortcut keywords to remember:

  • dp  (for dependency properties)
  • rc  (for routed commands)
  • re  (for routed events)

From there, it's just a matter of choosing the correct snippets from the context menu.  I've found that I can now invoke most of my snippets without even thinking about the keystrokes... my fingers just go into "auto" mode ( d - p - <tab> - <tab> - 2 - <enter> - property name - property type - ... ). 

Of course, I created the blasted things, so maybe I'm not a representative sample. 

In addition to the WPF-specific snippets, I've included a couple of other snippets in this zip that I also use quite a bit... "pc" provides the PropertyChanged implementation for the INotifyPropertyChanged interface and "pcp" is used to define a property that raises such a change notification. 

I'm looking forward to a day when I'll be able to do more advanced things in my snippets (custom functions, custom formatting, capitalization, custom placement for different code parts, etc).  In the meantime, I hope others will find my existing snippets useful!

Cheers,
Dr. WPF

Permalink |  Trackback

Comments (23)   Add Comment
Re: My WPF Code Snippets    By Rick Eberle on 12/18/2007 9:16 AM
These snippets are great. Although I could use them in VB more. Let us know if anyone ever ports them over.

Re: My WPF Code Snippets    By Kent Boogaart on 12/19/2007 12:02 PM
The defaults IsHilarious :)

Re: My WPF Code Snippets    By Jeremiah Morrill on 12/19/2007 1:45 PM
Was starting to wonder what the hell happened to you in the forums. At least it's given other people a chance to build up some forum points without you bogartin all the questions! =P

-Jer

Re: My WPF Code Snippets    By Marlon Grech on 12/20/2007 5:34 AM
Cool set of snippets.... Thanks

Re: My WPF Code Snippets    By Mike Brown on 1/11/2008 8:35 AM
I made some PC and PCP snippets as well. Looks about the same as yours. Good to have you back...was wondering if the aliens had come to take you back home :P

Re: My WPF Code Snippets    By Philipp on 1/17/2008 6:13 AM
It's only for dependency properties, but here's a snippet for the ReSharper folks, too:

http://www.hardcodet.net/net/wpf/2008/01/resharper-code-snippet-for-dependency-properties

Re: My WPF Code Snippets    By Denis Vuyka on 4/11/2008 11:33 AM
Thanks for sharing this stuff. It's worth of gold.

Re: My WPF Code Snippets    By Roland Rodriguez on 6/30/2008 2:00 PM
Hi Doc,

Love your blog, love the snippets. Just wondering if I'm doing something wrong, the routed event helper methods have more arguments than the calls to them from the generated routed events. Is this a feature or a bug? ;-)

Regards,
Roland Rodriguez
http://WPFBlog.info

Re: My WPF Code Snippets    By John "Z-Bo" Zabroski on 6/30/2008 4:48 PM
Is there a way to write code snippets as if they were macros?

What I really want is for in XAML to be able to write stuff like:

grid(r=4,c=4) TAB TAB
generates
<Grid>
<Grid.RowDefinitions>
... four rows
</Grid.RowDefinitions>
<Grid.ColumnDefinitions>
... four columns
</Grid.ColumnDefinitions>
<Grid>

and then a macro like:
#5 Label, TextBlock TAB TAB
generates
<Label x:Name="$lblName0$"/>
<TextBlock x:Name="$Name0$"/>
etc...

a fellow co-worker tells me VS sucks at really powerful stuff like this and to just use PowerShell Get-ClipBoard and Set-ClipBioard. I'd rather not depend on an external tool unless I can integrate PoerShell with VS

Re: My WPF Code Snippets    By Dr. WPF on 6/30/2008 2:11 PM
Hey Roland,

Glad you like the snippets!

If you're referring to the AddHandler() and RemoveHandler() helper methods, these are actually correct. They should have 3 arguments. These helpers are only accessed by the attached routed events. There are similarly named methods (with only 2 arguments) inherited from UIElement, which are called by the non-attached routed events.

The RaiseEvent() helper, on the other hand, is accessed by both the attached and non-attached routed events.

Hope this helps!

Cheers,
-dw

Re: My WPF Code Snippets    By Dr. WPF on 6/30/2008 4:53 PM
Hi Z-Bo. Currently, there is no support for the macro style snippets that you describe. I'm not really "in the know" when it comes to future snippet support/features within VS.

Re: My WPF Code Snippets    By Cory on 8/5/2008 10:04 AM
Hi Doc,

I just stumbled across your re1, re2, and re3 snippets and am confused by them.

There isn't a way to add arguments to RoutedEventArgs, correct? So, are you assuming a derived RoutedEventArgs class that you've created yourself to take arguments to initialize it?

Just curious about the intent of those snippets,
Cory

Re: My WPF Code Snippets    By Dr. WPF on 8/5/2008 12:34 PM
Thanks, Cory! Glad you're finding the snippets useful. :-)

Yes, the re(N) snippets support derived routed event classes... but not just custom ones that I create. The framework contains many such classes itself.

For example, re3 can be used if you want to expose a DragCompleted event based on the framework's DragCompletedEventArgs (which takes 3 parameters... double, double, bool).

I stopped at 3 because I've never really used any framework routed arg classes that took more than 3 arguments. (Well, there are some internal ones like ScrollChangedEventArgs, but those don't count.)

Admittedly, I tend to use the re(N) snippets more in Surface projects or in projects where I'm defining a lot of my own attached events. For the most part, you can get by with the re0 snippet, but when you need one of the others, its really nice to have it! :)

Cheers,
-dw

Re: My WPF Code Snippets    By Cory on 8/5/2008 1:25 PM
Doc,

Forgot to add that I love your snippets! Very useful!

Thanks for sharing them.

Cory

Re: My WPF Code Snippets    By Cory on 8/6/2008 4:02 PM
I should also add that I noticed the version of ret(n) snippets that I have ... had the Bubble routing strategy on both the normal event and the preview event. Pretty sure that's not what you want. :)

Re: My WPF Code Snippets    By Dr. WPF on 8/6/2008 4:09 PM
Yikes! Thanks Cory... that's a really old version of my snippets. I fixed that problem a while back, but I guess I've been pretty delinquent in updating the site.

If you grab the version I just uploaded, you won't see that problem anymore in the ret snippets. You'll also get some of the improvements I've made over the last 6 months.

I've found that I typically use the helper methods (for routed events and commands) across many classes in a project, so those snippets now create a static internal class. This way they only need to be added once to a project.

There are several other changes too, but I'm too lazy to diff the files to see what they are... probably a few other bug fixes. Let me know if you find anymore bugs!

Thanks!
-dw

Re: My WPF Code Snippets    By Jochen on 8/7/2008 3:03 AM
Thank you so much for posting the updated snippets!

Jochen

Re: My WPF Code Snippets    By Cory on 8/7/2008 10:08 PM
Ok, you're probably tired of me by now. <grin> Is there a reason that the Preview or tunneling events don't use the RaiseEvent method on the static helper class? (The regular bubbling event uses RoutedEventHelper.RaiseEvent but the tunneling event doesn't.)

Re: My WPF Code Snippets    By Dr. WPF on 8/7/2008 10:26 PM
You bet, Jochen!

Another great catch, Cory! I just updated the installer again.

I'm not tired of you at all... Keep scrutinizing them and I'll keep updating them! :-D

That was actually a problem across all the RE snippets. The first parameter on the static Raise helper was supposed to be DependencyObject (so that it can be used to target both UIEs and CEs). Not sure how long that problem has been there... probably the result of some merge/global replace gone bad. I looked back at the very first version I posted, and it was correct, but in the snippets that've been up there for the last 6 months, it was definitely wrong. :(

Oh well... its fixed now. Thanks again! Keep the feedback coming!

Re: My WPF Code Snippets    By Iffi on 9/25/2008 11:56 PM
These are very Cooooooooooooooooooool Snippets!!
Thanks Dr.WPF

Re: My WPF Code Snippets    By John "Z-Bo" Zabroski on 11/24/2008 11:43 AM
Dr. WPF,

I semi-solved my problem I was describing above.

As of February 2008, VS2008 apparently supports a feature I just learned about today called T4 templates, that are a part of the DSL and GAX/GAT toolkits. In particular, there is a command line tool called TransformText.

Unfortunately, it isn't fully integrated with C# or XAML Visual Studio stuff itself.

Re: My WPF Code Snippets    By Mario on 2/14/2009 3:04 PM
Nice Snippets!

@John "Z-Bo" Zabroski u can use my useful application sxGriddler ; )

Re: My WPF Code Snippets    By John "Z-Bo" Zabroski on 5/31/2009 3:27 PM
Neat. Thanks for the link. I came up with an approach that made me feel more like I was a Windows Office user. Great to see programmers making tools to automate the tedious stuff, though. Great job.


Your name:
Title:
Comment:
Security Code
Enter the code shown above in the box below
Add Comment   Cancel 

  
Copyright 2009 by Dr. WPF   Terms Of Use  Privacy Statement