Huddled Masses » Interop http://huddledmasses.org You can do more than breathe for free... Fri, 27 Apr 2012 05:42:40 +0000 en hourly 1 http://wordpress.org/?v=3.3.2 WPF Window “Native” Behavior: The Base Class http://huddledmasses.org/wpf-window-native-behaviors/ http://huddledmasses.org/wpf-window-native-behaviors/#comments Thu, 16 Oct 2008 21:52:18 +0000 Joel 'Jaykul' Bennett http://HuddledMasses.org/?p=726 I wrote yesterday about the WPF Snap-To Behavor that I created, and showed you how simple it is, but I skipped over where the magic happens, so I thought I’d go through how I created the Native Behaviors collection class, because there are a few cool tricks in here that I wanted to share with WPF developers at large (even if you’re not interested in hooking the Window Procedure).

The framework for Native Bahaviors is made up of just two classes, the first of which is basically 3 lines of code.

NativeBehavior is the abstract base class for behaviors, and consists of just definitions for the mandatory abstract GetHandlers() method (where you return an IEnumerable collection of mappings from Window Messages to your delegate methods) and the two optional (virtual) methods AddTo and RemoveFrom which are called when your behavior is initially added to a window (generally before the Window is initialized).

NativeBehaviors is an ObservableCollection of NativeBehaviors, obviously ;) . But it’s ever so much more than that. First of all, it has the NativeBehaviors attached property, but it also has the code for actually hooking a WPF window to get the Window Messages, and a WndProc which processes each message against the mappings retrieved from the various NativeBehaviors that have been registered.

Lets start with the attached dependency property. There’s a very clever (and problematic) trick in the way this property is exposed. If you look at this code, you’ll see I create a private NativeBehavior dependency property, and then create public Get/Set accessors for “Behavior” which just call the NativeBehavior property. The reason for this is that if the dependency property is public, or if the public accessors even have the same name … the XAML parser finds the dependency property and uses it directly (bypassing the get/set accesors), which means you have to have an extra element in your XAML markup to initialize the NativeBehaviors collection, or you get something like this screenshot.

The behavior collection doesn't get created...

So instead, we hide the dependency property, and supply a getter which is backed by the dependency property. I should not that although this works great in the .Net Framework, it’s not recognized properly by all of the tools (including Resharper 4.1 and even Expression Blend), so you may have to fiddle with things.


      private static readonly DependencyProperty NativeBehaviorsProperty =
          DependencyProperty.RegisterAttached(
          "NativeBehaviors", typeof(NativeBehaviors), typeof(NativeBehaviors),
          new FrameworkPropertyMetadata(null));
      // A public setter (for the non-existent "Behaviors" property)
      public static void SetBehaviors(Window window, NativeBehaviors behaviors)
      {
         if (window == null){ throw new ArgumentNullException("window"); }
         window.SetValue(NativeBehaviorsProperty, behaviors);
      }
      // The public getter  (for the non-existent "Behaviors" property)
      public static NativeBehaviors GetBehaviors(Window window)
      {  // instead of GetValue, call the accessor!
         return GetNativeBehaviors(window);
      }
      // This dependency property getter makes sure it returns a collection
      private static NativeBehaviors GetNativeBehaviors(Window window)
      {
         if (window == null) { throw new ArgumentNullException("window"); }
         // This is the plain old normal thing:
         var behaviors = (NativeBehaviors)window.GetValue(NativeBehaviorsProperty);
         // Our raison d'être: create a new collection if there isn't one yet
         if (behaviors == null) { behaviors = new NativeBehaviors(window); }

         return behaviors;
      }
 

There’s a little more to it in the actual class source code, I’m glossing over the simplest parts, and leaving out all the XML documentation comments too. We override the CollectionChanged event so that we can hook new Behaviors as they arrive, and we make sure to hook the WndProc whenever the Target Window is set:


protected override void OnCollectionChanged(NotifyCollectionChangedEventArgs nccea)
{
   base.OnCollectionChanged(nccea);
   // design mode bailout because NativeBehaviors don't work in DesignMode
   if (DesignerProperties.GetIsInDesignMode(Target)) { return; }
   // notify new behaviors they are being hooked up, and track their handlers
   if (nccea.Action == NotifyCollectionChangedAction.Add ||
       nccea.Action == NotifyCollectionChangedAction.Replace)
   {
      foreach (NativeBehavior behavior in nccea.NewItems)
      {
         behavior.AddTo(Target);
         Handlers.AddRange(behavior.GetHandlers());
      }
   }

   // notify removed behaviors they are being unhooked, and stop tracking their handlers
   if (nccea.Action == NotifyCollectionChangedAction.Remove ||
       nccea.Action == NotifyCollectionChangedAction.Replace)
   {
      foreach (NativeBehavior behavior in nccea.OldItems)
      {
         behavior.RemoveFrom(Target);
         foreach (var h in behavior.GetHandlers())
         {
            Handlers.Remove(h);
         }
      }
   }
}

// Hook the Window when its added
// but keep only a week reference to it...
public Window Target
{
   get
   {
      if (_owner != null) {
         return _owner.Target as Window;
      } else return null;
   }
   set
   {
      // design mode bailout (in Design mode there's no window, and no wndproc)
      if (DesignerProperties.GetIsInDesignMode(value)) { return; }

      if (_owner != null && WindowHandle != IntPtr.Zero)
      {
         HwndSource.FromHwnd(WindowHandle).RemoveHook(WndProc);
      }

      Debug.Assert(null != value);
      _owner = new WeakReference(value);

      // Check for an HWND to determine if the Window has been loaded.
      WindowHandle = new WindowInteropHelper(value).Handle;

      if (IntPtr.Zero == WindowHandle)
      { // If there's no handle, set the hook when the Source is initialised.
         value.SourceInitialized += (sender, e) =>
         {
            WindowHandle = new WindowInteropHelper((Window)sender).Handle;
            // hook the WndProc
            HwndSource.FromHwnd(WindowHandle).AddHook(WndProc);
         };
      }
      else
      { // hook the WndProc
         HwndSource.FromHwnd(WindowHandle).AddHook(WndProc);
      }
   }
}
// the weak reference to the actual window...
private WeakReference _owner;
 

And finally, the last part of the puzzle is my actual WndProc implementation, which has a minor drawback in that we can hypothetically have multiple behaviors which process the same window message … and may each return a different value (which we cannot reconcile). For now I’m just returning the last (non-zero) result (in actuality, all of the behaviors I’ve written thus far return zero).


private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
   Debug.Assert(hwnd == WindowHandle); // Only expecting messages for our cached HWND.

   // cast and cache the message
   var message = (NativeMethods.WindowMessage)msg;
   // NOTE: we may process a message multiple times
   // and we have no good way to handle that...
   var result = IntPtr.Zero;
   foreach (var handlePair in Handlers)
   {  if (handlePair.Key == message)
      {
         var r = handlePair.Value(wParam, lParam, ref handled);
         // So, we'll return the last non-zero result (if any)
         if (r != IntPtr.Zero) { result = r; }
   }  }
   return result;
}
 

That pretty much covers the framework. The actual behaviors can be fairly simple like my Snap-To behavior (which is actually too simple), or extremely complex like my latest behavior, which is a port Joe Castro’s custom Window ‘Chrome’ to my behavior framework, and I’m hoping some of you will choose to write new ones and submit them as patches to the CodePlex project (for now, I’m just piggybacking it on the PoshConsole project). But in any case, the latest code is available via subversion on CodePlex, and you can download today’s snapshot here.

Reblog this post [with Zemanta]
]]> http://huddledmasses.org/wpf-window-native-behaviors/feed/ 0 How to get the Char(acter) and VirtualKey from a WPF KeyDown event http://huddledmasses.org/how-to-get-the-character-and-virtualkey-from-a-wpf-keydown-event/ http://huddledmasses.org/how-to-get-the-character-and-virtualkey-from-a-wpf-keydown-event/#comments Mon, 22 Sep 2008 05:02:34 +0000 Joel 'Jaykul' Bennett http://HuddledMasses.org/?p=699 While working on my WPF PowerShell console, I’m working on implementing PSRawUserInterface, and had to implement a method called ReadKey which returns a KeyInfo object. KeyInfo is a pretty simple struct class with four properties:

  • VirtualKeyCode
  • Character
  • ControlKeyState
  • KeyDown

So it doesn’t seem like it would be a real problem … just handle the KeyDown event or PreviewKeyDown event on the WPF control, right? Well, no. Because all of these just use a KeyEventArgs parameter which has a Key property which doesn’t map to a virtual key code (why isn’t the WPF Key enumeration in the right order? It’s ridiculous), and there’s no character information at all.

Thankfully, it is possible to get this information using PInvoke, but I wouldn’t want to try to do this in Silverlight. ;)

Here’s how it goes:

First, you need to get the VirtualKey code. Thankfully, there’s a simple class called KeyInterop, which exposes a static method VirtualKeyFromKey that gets us this information.

Then, we need to get the character. This is much trickier. First we have to get the keyboard state and then we have to map that VirtualKey we got in the first step to a ScanCode, and finally, convert all of that to Unicode, because .Net doesn’t really speak ASCII ;)

The rest of the code is pretty clear, I hope… you can find the current version of Keyboard.cs on CodePlex in the PoshCode source repository, but to make this complete, here’s the version as it stands now:


using System.Management.Automation.Host;
using System.Runtime.InteropServices;
using System.Text;
using System.Windows.Input;

namespace Huddled.Interop
{
   public static class Keyboard
   {

      /// <summary>The set of valid MapTypes used in MapVirtualKey
      /// </summary>
      /// <remarks></remarks>
      public enum MapType : uint
      {
         /// <summary>uCode is a virtual-key code and is translated into a scan code.
         /// If it is a virtual-key code that does not distinguish between left- and
         /// right-hand keys, the left-hand scan code is returned.
         /// If there is no translation, the function returns 0.
         /// </summary>
         /// <remarks></remarks>
         MAPVK_VK_TO_VSC = 0x0,

         /// <summary>uCode is a scan code and is translated into a virtual-key code that
         /// does not distinguish between left- and right-hand keys. If there is no
         /// translation, the function returns 0.
         /// </summary>
         /// <remarks></remarks>
         MAPVK_VSC_TO_VK = 0x1,

         /// <summary>uCode is a virtual-key code and is translated into an unshifted
         /// character value in the low-order word of the return value. Dead keys (diacritics)
         /// are indicated by setting the top bit of the return value. If there is no
         /// translation, the function returns 0.
         /// </summary>
         /// <remarks></remarks>
         MAPVK_VK_TO_CHAR = 0x2,

         /// <summary>Windows NT/2000/XP: uCode is a scan code and is translated into a
         /// virtual-key code that distinguishes between left- and right-hand keys. If
         /// there is no translation, the function returns 0.
         /// </summary>
         /// <remarks></remarks>
         MAPVK_VSC_TO_VK_EX = 0x3,

         /// <summary>Not currently documented
         /// </summary>
         /// <remarks></remarks>
         MAPVK_VK_TO_VSC_EX = 0x4,
      }

      /// <summary>
      /// The ToUnicode function translates the specified virtual-key code and keyboard state
      /// to the corresponding Unicode character or characters. To specify a handle to the keyboard layout
      /// to use to translate the specified code, use the ToUnicodeEx function.
      /// </summary>
      ///
Reblog this post [with Zemanta]
]]> http://huddledmasses.org/how-to-get-the-character-and-virtualkey-from-a-wpf-keydown-event/feed/ 0