{"id":9631,"date":"2015-08-17T06:00:00","date_gmt":"2015-08-17T13:00:00","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=9631"},"modified":"2015-09-17T09:41:35","modified_gmt":"2015-09-17T16:41:35","slug":"typing-enter-pushes-a-button","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2015\/08\/17\/typing-enter-pushes-a-button\/","title":{"rendered":"Typing Enter Pushes a Button"},"content":{"rendered":"

As a beginner developer of PowerShell GUIs, I’m always looking for easy ways to make my simple applications more sophisticated and usable. One of the basic usability features in most applications is typing <Enter> in a textbox to invoke a function instead of clicking a Start, Go, or OK button.<\/p>\n

In this post, I’ll show you two ways to do it. One technique is significantly simpler than the other, but works only when there is exactly one “Go” button. The more complex technique works for multiple buttons and keys other than <Enter>.<\/p>\n

Registering a KeyDown Event Handler<\/h3>\n

Let’s start with the general, more complex technique. We’ll create a KeyDown event handler for the <Enter> key, but you can use the same method to register an event handler for any key. Our event handler will click a particular button, but you can set it up to click any button on the user’s behalf.<\/p>\n

Here’s the typical situation. In this little app, when you type a valid value in the textbox, the Get-Service<\/b> button is enabled. You can click the Get-Service button, but it would be nice to let the user just type <Enter> after typing the computer name.<\/p>\n

\"GetServicePsf\"<\/a><\/p>\n

To enable the “press <Enter>” feature, use the KeyDown<\/b> event<\/a> of the Textbox object<\/a> (System.Windows.Forms.Textbox):<\/p>\n

1. Start by creating a variable to hold the KeyDown<\/b> event of the textbox. Following the best practice naming guidelines, I’ll name the variable $textboxComputerName_KeyDown<\/b>.<\/p>\n

$textboxComputerName_KeyDown = {}<\/pre>\n
2. The KeyDown<\/b> event handler requires a KeyEventHandler<\/b> object<\/a>, so we’ll cast the script block as a KeyEventHandler<\/b> object.<\/p>\n
$textboxComputerName_KeyDown = [System.Windows.Forms.KeyEventHandler]{}<\/pre>\n
3. When the KeyCode<\/strong> property value ($_.KeyCode) is “Enter”, we want to click the Get-Service button on the user’s behalf. To click the button, call the Invoke() method of the Click event of the button ($buttonGetService.Click). Referencing the Click event without calling the Invoke() method has no effect.<\/p>\n
$textboxComputerName_KeyDown = [System.Windows.Forms.KeyEventHandler]{\r\n    if ($_.KeyCode -eq 'Enter')\r\n    {\r\n        $buttonGetServices_Click.Invoke()\r\n    }\r\n}<\/pre>\n
Or, you can use the PerformClick() method of the button. This makes your intent much clearer than just invoking an event handler function. (Many thanks to Charlie Eberly for this suggestion!)<\/p>\n
$textboxComputerName_KeyDown = [System.Windows.Forms.KeyEventHandler]{\r\n    if ($_.KeyCode -eq 'Enter')\r\n    {\r\n        $buttonGetServices.PerformClick()\r\n    }\r\n}<\/pre>\n
4. Set the SuppressKeyPress<\/b> property<\/a> of the KeyEventArgs<\/strong> object to $True.<\/p>\n
When you invoke the Click<\/b> event of the button on the user’s behalf, you want to prevent the user from clicking the button, too. Otherwise, the button could be clicked multiple times. Also, the Click generates a sound that’s typically associated with clicking a button, but not with pressing <Enter>. Setting SuppressKeyPress<\/strong> to $True takes care of this for you.<\/p>\n
$textboxComputerName_KeyDown = [System.Windows.Forms.KeyEventHandler]{\r\n\r\n    if ($_.KeyCode -eq 'Enter')\r\n    {\r\n        $buttonGetServices_Click.Invoke()\r\n\r\n        #Suppress sound from unexpected use of enter on keyPress\/keyUp\r\n        $_.SuppressKeyPress = $true\r\n    }\r\n}<\/pre>\n
The KeyDown event handler is now complete.<\/p>\n
The final step is to register the KeyDown<\/strong> event handler, that is, to associate the event hander with the KeyDown<\/strong> event so that when the KeyDown<\/strong> event happens (“is raised”), the system runs the event handler code. Because KeyDown<\/strong> is not the default event of a Textbox object, PowerShell Studio<\/i> doesn’t do it for you, but it’s very easy to do.<\/p>\n
To register the event handler in PowerShell Studio:<\/b><\/p>\n
1. In PowerShell Studio<\/i>, in the Designer window, click the textbox.<\/p>\n
2. In the Properties pane for the textbox, on the row for the KeyDown<\/b> event, type the name of the event handler.<\/p>\n
\"clip_image004\"<\/a><\/p>\n
To register the event manually <\/b>(without PowerShell Studio<\/i>):<\/b><\/p>\n
1. Write a statement that registers the event handler.<\/p>\n
The syntax is:<\/p>\n
.add()<\/pre>\n
For example:<\/p>\n
$textboxComputerName.add_KeyDown($textboxComputerName_KeyDown)<\/pre>\n
2. Remember to remove the event handler in your cleanup step.<\/p>\n
For example:<\/p>\n
$textboxComputerName.remove_KeyDown($textboxComputerName_KeyDown)<\/pre>\n
Set the Accept Button of the Form<\/h3>\n
Writing a KeyDown event is conceptually a bit complex, but it’s not difficult to do. However, the other technique is so simple that you’ll use it whenever you can.<\/p>\n
Every form has an AcceptButton<\/b> property that is invoked automatically when the user types <Enter>. Typically, the AcceptButton<\/strong> property is set to the OK button, if there is one, but you can set it to any button on the form (or not set it).<\/p>\n
NOTE: In PowerShell Studio, when you use a form template that includes an OK button, such as a Dialog Style form, the AcceptButton is set to the OK button by default.<\/p>\n
In the PowerShell Studio<\/i> designer and in the running application, the AcceptButton<\/b> is indicated by a blue border.<\/p>\n
\"clip_image006\"<\/a><\/p>\n
To set the AcceptButton property of the form:<\/b>
\n— In the Properties box for the form, in the row for the AcceptButton property, use the drop-down menu to select a button.<\/p>\n
\"clip_image007\"<\/a><\/p>\n
-or-<\/p>\n
— In the Load event of the form, set the AcceptButton<\/b> property of the form to the desired button.<\/p>\n
$formGetService_Load = {\r\n    $formGetService.AcceptButton = $buttonGetService\r\n}<\/pre>\n
 <\/p>\n
Now that you know both techniques, remember not to use them together. If the AcceptButton<\/strong> property of the form is set to any<\/em> button, that property value takes precedence over a KeyDown<\/strong> event with an ‘Enter’ key code. For example, if you write a KeyDown<\/strong> event for\u00a0$buttonGetServices\u00a0and set the AcceptButton<\/strong> property of the form\u00a0is $buttonOK, when you click enter in the textbox, it clicks $buttonOK.<\/p>\n
Allowing the user to press <Enter> in your app, instead of forcing them to click a button, improves the usability of your app. Spend an extra few minutes setting the AcceptButton<\/b> property, or even registering a KeyDown<\/b> event.<\/p>\n
June Blender is a technology evangelist at SAPIEN Technologies, Inc and a Windows PowerShell MVP. You can reach her at juneb@sapien.com<\/a> and follow her on Twitter at @juneb_get_help<\/a>.<\/i><\/p>\n","protected":false},"excerpt":{"rendered":"
As a beginner developer of PowerShell GUIs, I’m always looking for easy ways to make my simple applications more sophisticated and usable. One of the basic usability features in most applications is typing <Enter> in a textbox to invoke a function instead of clicking a Start, Go, or OK button. In this post, I’ll show […]<\/p>\n","protected":false},"author":31,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[932,946,703,25],"tags":[135,934,988,1016],"class_list":["post-9631","post","type-post","status-publish","format-standard","hentry","category-beginners","category-guiprogramming","category-powershell-studio","category-windows-powershell","tag-beginner","tag-juneb","tag-powershell-gui","tag-powershell-studio"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t