There is another window inside:
Changing the name also, not only the value:
Introduction
I came to a point where I needed to allow the user to reset the values in the property grid, the same way Visual Studio does (using a context menu when right clicking on the property). This is useful for some reasons:
- You don't have to remember the old value of the property. The controls does it all for you.
- The control displays the modified properties using bold, so it's easy to see which properties have been modified.
Background
After searching a great deal on the internet, I still didn't find anything. Then it occurred to me to use the same old friend, the Spy++ tool that comes with Visual Studio. Then I noticed there is another window inside what we think is the property grid. That other window does all the impressive work that makes the property grid so famous.
Since there is no direct way to get our hands on that window, I had to go brute force on it:
propertyGrid1.GetChildAtPoint( new Point(40,40) )
Now, I had the window. All I had to do was to get my hands on the messages the window receives and look for messages that indicate a right click inside.
This is done by adding a filter to all the messages in the application's loop and looking for the messages addressed to our window:
Application.AddMessageFilter( new PropertyGridMessageFilter(
propertyGrid1.GetChildAtPoint( new Point(40,40) ),
new MouseEventHandler( propGridView_MouseUp )) );
Since doing this in the OnLoad
event handler failed (Object reference not set to an instance of an object), I now do it in a timer event handler that lets the entire GUI to instantiate:
private void timerLoad_Tick(object sender, System.EventArgs e)
{
timerLoad.Stop();
Application.AddMessageFilter(
new PropertyGridMessageFilter(
propertyGrid1.GetChildAtPoint( new Point(40,40) ),
new MouseEventHandler( propGridView_MouseUp )) );
}
The filter looks for WM_?BUTTONUP
messages and makes a call to a provided delegate:
public bool PreFilterMessage(ref Message m)
{
if( ! this.Control.IsDisposed && m.HWnd ==
this.Control.Handle && MouseUp != null)
{
MouseButtons mb = MouseButtons.None;
switch( m.Msg )
{
case 0x0202 :
mb = MouseButtons.Left;
break;
case 0x0205 :
mb = MouseButtons.Right;
break;
}
if( mb != MouseButtons.None )
{
MouseEventArgs e =
new MouseEventArgs( mb, 1, m.LParam.ToInt32() & 0xFFff,
m.LParam.ToInt32() >> 16, 0 );
MouseUp( Control, e );
}
}
return false;
}
When the form's method is called by the filter, I just get the propertyGrid1.SelectedGridItem.PropertyDescriptor
and display the context menu containing the Reset and ChangeName options.
Here you can see the Reset option displaying the default value so the user has the new and the default value next to each other:
What if the user wants to rename the property itself
First, the program displays an on-site textbox for the user to alter the property name in:
private void menuItemChangeName_Click(object sender, System.EventArgs e)
{
GenericPropertyDescriptor gpd =
propertyGrid1.SelectedGridItem.PropertyDescriptor
as GenericPropertyDescriptor;
if( gpd != null )
{
TextBox t = new TextBox();
t.Text = gpd.Property.PropertyName;
t.Tag = gpd;
t.KeyUp += new KeyEventHandler(textbox_name_KeyUp);
t.MouseUp += new MouseEventHandler(textbox_name_MouseUp);
t.Capture = true;
Point mp = MousePosition; mp.Offset( -3, -3 );
t.Location = PointToClient( mp );
Controls.Add( t );
t.BringToFront();
t.Focus();
t.Select( t.Text.Length, 0 );
t.BackColor = Color.Yellow;
t.ForeColor = Color.Red;
}
}
Once the textbox is on the screen, the content can be validated by pressing Enter, or discarded by pressing Escape:
private void textbox_name_KeyUp(object sender, KeyEventArgs e)
{
switch( e.KeyData )
{
case Keys.Enter:
{
TextBox t = sender as TextBox;
( (GenericPropertyDescriptor)
t.Tag ).Property.PropertyName = t.Text != "" ?
t.Text : "must type something or" +
" the control will go berserk" ;
RemoveTextBox( sender );
propertyGrid1.Refresh();
}break;
case Keys.Escape:
{
RemoveTextBox( sender );
}break;
}
}
Using the code
The properties are stored in a collection that implements ICustomTypeDescriptor
(this has been explained in many articles, I'm not explaining it again here). This collection returns the custom properties when asked by the property grid (propertyGrid1.SelectedObject = properties;
). Adding properties to this collection is quite easy:
properties = new GenericPropertyCollection_CustomTypeDescriptor();
properties.AddProperty( new GenericProperty( "Integer",
(int) 1, "Custom", "Int32" ) );
properties.AddProperty( new GenericProperty( "Float disabled",
4.5f, "Custom", "Single",
new ReadOnlyAttributeEditor() ) );
Making one of the properties read only (disabled) is also easy, just tag-it with the ReadOnlyAttributeEditor
.
The collection can be used as storage for the data, there is no need for a parallel structure. Accessing the data can be done like this:
foreach( GenericProperty gp in properties )
MessageBox.Show( gp.Value.ToString() );
Points of Interest
Many things can be done by accessing the insides of the operating system or common controls. Platform Invoke and filtering of messages can be used to create new, helpful, and original effects.
I find interesting the on-site editing of the property name, using the small textbox that disappears when the user is done with it. It's something like the Undo control in Visual Studio that is placed over all the controls (toolbars, edit window).
History
- January 29th, 2006 - first version.