{"id":4114,"date":"2012-05-08T14:24:00","date_gmt":"2012-05-08T22:24:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=4114"},"modified":"2012-05-08T14:24:33","modified_gmt":"2012-05-08T22:24:33","slug":"spotlight-on-the-notifyicon-control","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2012\/05\/08\/spotlight-on-the-notifyicon-control\/","title":{"rendered":"Spotlight on the NotifyIcon Control"},"content":{"rendered":"

The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PowerShell Studio 2012, details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms.<\/em><\/p>\n

Last time we took a look at the ListView control. This time we will look at the NotifyIcon control:<\/p>\n

NotifyIcon <\/strong>[System.Windows.Forms.NotifyIcon]<\/span><\/p>\n

Specifies a component that creates an icon in the notification area of the Window\u2019s taskbar. <\/p>\n

\"NotifyIcon\"<\/p>\n

Default Event: MouseDoubleClick<\/p>\n

Why use a NotifyIcon control?<\/em><\/p>\n

Use the NotifyIcon control, to alert users of special events, such as when a task is completed. Typically this control is used for informational purposes, but it can also be used as a source for user interaction.<\/p>\n

Note: When you add a NotifyIcon it will appear at the bottom of the Designer:<\/p>\n

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

 <\/p>\n

Important Properties:<\/font><\/strong><\/p>\n

BalloonTipText<\/strong><\/p>\n

This property sets the text associated with the balloon ToolTip. Use this property to display a message in the Balloon Tooltip.<\/p>\n

Setting the BalloonTipText in the script editor:<\/p>\n

$NotifyIcon<\/span>.BalloonTipText <\/span>=<\/span> <\/span>\"This is the balloon text\"<\/span><\/pre>\n
\"BalloonText\"<\/p>\n
BalloonTipTitle<\/strong><\/p>\n
This property sets the title of the balloon ToolTip.
The title text is displayed above the balloon text.<\/p>\n
\"Balloon<\/p>\n
BalloonTipIcon<\/strong><\/p>\n
This property sets the icon to associate with the balloon Tooltip. In other words, the icon displayed inside the tooltip itself. 
Note: The BalloonTipTitle<\/em> property must be set in order to view the balloon icon.<\/p>\n
Values (Default: None<\/em>):<\/p>\n
\n
None
<\/em>No icon is displayed.
\"Icon<\/p>\n
Info<\/em>
An information icon.
\"Icon<\/p>\n
Warning<\/em>
A warning icon.
\"Icon<\/p>\n
Error<\/em>
An error icon.
\"Icon<\/p>\n<\/blockquote>\n
Icon<\/strong><\/p>\n
This property sets the icon to display in the system tray. <\/p>\n
Important: This property must be set; otherwise the tooltip balloon will not show!<\/font><\/p>\n
The designer will allow you to browse and select an icon to display when the tooltip is shown.<\/p>\n
Click on the browse button in the Property Panel:<\/p>\n
\"Icon<\/a><\/p>\n
Or use the menu in the designer:<\/p>\n
\"Choose<\/p>\n
Next select the Icon file<\/p>\n
\"Open<\/a><\/p>\n
Finally the Icon will be displayed in the system tray:<\/p>\n
\"Icon<\/p>\n
Note: If a \u201cphantom\u201d icon remains in the system tray after closing the form, then it is recommended set the Visible property to False<\/em> in order to clear the icon before closing form.<\/p>\n
ContextMenuStrip<\/strong><\/p>\n
This property sets the shortcut menu to show when the user right-clicks the icon. 
Set this property to an existing ContextMenuStrip in order to assign a menu to the system tray icon. See Spotlight on the ContextMenuStrip Control<\/a> for more details.<\/p>\n
\"NotifyIcon's<\/p>\n
Visible<\/strong><\/p>\n
This property indicates whether the icon is visible in the notification area of the taskbar.<\/p>\n
Values (Default: True<\/em>):<\/p>\n
\n
True \/ False<\/em><\/p>\n<\/blockquote>\n
Important Events:<\/font><\/strong><\/p>\n
BalloonTipClicked<\/strong><\/p>\n
This event occurs when the balloon tip is clicked. Use this event to react to user clicks in the ToolTip balloon.<\/p>\n
$notifyicon1_BalloonTipClicked<\/span>=<\/span>{\n    <\/span>Write-Host<\/span> <\/span>'The Balloon Tip was Clicked'<\/span>\n}<\/span><\/pre>\n
\"BalloonTip<\/strong><\/p>\n
<\/strong> <\/p>\n
Clicked <\/strong>& DoubleClicked<\/strong><\/p>\n
These events occur when the system tray icon is clicked. If you need more information such as which mouse button was used, then it is recommended to use the MouseClick events (See below).<\/p>\n
MouseClick<\/strong><\/p>\n
This event occurs when a user clicks on the system tray icon.<\/p>\n
[System.Windows.Forms.LabelEditEventHandler]<\/strong><\/p>\n\n\n\n\n\n\n\n\n\n
Properties<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
Button<\/td>\nGets which mouse button was pressed.<\/td>\n<\/tr>\n
Clicks<\/td>\nGets the number of times the mouse button was pressed and released.<\/td>\n<\/tr>\n
Delta<\/td>\n(Not applicable)<\/td>\n<\/tr>\n
Location<\/td>\nGets the location of the mouse during the generating mouse event.<\/td>\n<\/tr>\n
X<\/td>\nGets the x-coordinate of the mouse during the generating mouse event.<\/td>\n<\/tr>\n
Y<\/td>\nGets the y-coordinate of the mouse during the generating mouse event.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
 <\/p>\n
$notifyicon1_MouseClick<\/span>=<\/span>[System.Windows.Forms.MouseEventHandler]{\n<\/span>#Event Argument: $_ = [System.Windows.Forms.MouseEventArgs]<\/span>\n    <\/span>Write-Host<\/span> <\/span>\"System Tray Icon Mouse Click: $($_.Button) Clicks: $($_.Clicks)\"<\/span>\n}<\/span><\/pre>\n
MouseDoubleClick<\/strong> <\/p>\n
These events occur when a user double clicks on a system tray icon. This event has the same arguments as the MouseClick event.<\/p>\n
$notifyicon1_MouseDoubleClick<\/span>=<\/span>[System.Windows.Forms.MouseEventHandler]{\n<\/span>#Event Argument: $_ = [System.Windows.Forms.MouseEventArgs]<\/span>\n    <\/span>Write-Host<\/span> <\/span>\"System Tray Icon Mouse Double Click: $($_.Button) Clicks: $($_.Clicks)\"<\/span>\n}<\/span><\/pre>\n
Important Methods:<\/font><\/strong><\/p>\n
ShowBalloonTip<\/strong><\/p>\n
This method displays a balloon tip in the taskbar for the specified time period.<\/p>\n
 <\/p>\n
[void]<\/span> ShowBalloonTip<\/span>([<\/span>int] <\/span>timeout<\/span>)<\/font><\/span><\/p>\n
Note: The method uses the properties of the NotifyIcon to display the balloon tip. Therefore they must be set before calling this method.<\/p>\n
<\/font><\/span><\/p>\n
$NotifyIcon<\/span>.ShowBalloonTip(<\/span>0<\/span>)<\/span><\/pre>\n
<\/span> <\/pre>\n
[void]<\/span> ShowBalloonTip<\/span>([<\/span>int] <\/span>timeout, [<\/span>string] <\/span>tipTitle, [<\/span>string<\/span>] <\/span>tipText, [<\/span>ToolTipIcon] <\/span>tipIcon<\/span><\/span><\/span>)<\/font><\/span><\/p>\n
Note: This variation, displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period. You need not set the NotifyIcon\u2019s properties if you use this method variation.<\/p>\n
$NotifyIcon<\/span>.ShowBalloonTip(<\/span>$Timeout<\/span>, <\/span>$BalloonTipTitle<\/span>, <\/span>$BalloonTipText<\/span>, <\/span>$BalloonTipIcon<\/span>)<\/span><\/pre>\n
<\/font><\/strong> <\/p>\n
Helper Function:<\/font><\/strong><\/p>\n
The following is a helper function that allows you to display the NotifyIcon. The help function also assigns the calling executable\u2019s icon, if the NotifyIcon\u2019s Icon property hasn\u2019t been assigned.<\/p>\n
function<\/span> <\/span>Show-NotifyIcon<\/span>\n{\n<\/span><#\n    .SYNOPSIS\n        Displays a NotifyIcon's balloon tip message in the taskbar's notification area.\n    \n    .DESCRIPTION\n        Displays a NotifyIcon's a balloon tip message in the taskbar's notification area.\n        \n    .PARAMETER NotifyIcon\n         The NotifyIcon control that will be displayed.\n    \n    .PARAMETER BalloonTipText\n         Sets the text to display in the balloon tip.\n    \n    .PARAMETER BalloonTipTitle\n        Sets the Title to display in the balloon tip.\n    \n    .PARAMETER BalloonTipIcon    \n        The icon to display in the ballon tip.\n    \n    .PARAMETER Timeout    \n        The time the ToolTip Balloon will remain visible in milliseconds. \n        Default: 0 - Uses windows default.\n#><\/span>\n     <\/span>param<\/span>(\n      [Parameter(Mandatory <\/span>=<\/span> <\/span>$true<\/span>, Position <\/span>=<\/span> <\/span>0<\/span>)]\n      [ValidateNotNull()]\n      [System.Windows.Forms.NotifyIcon]<\/span>$NotifyIcon<\/span>,\n      [Parameter(Mandatory <\/span>=<\/span> <\/span>$true<\/span>, Position <\/span>=<\/span> <\/span>1<\/span>)]\n      [ValidateNotNullOrEmpty()]\n      [String]<\/span>$BalloonTipText<\/span>,\n      [Parameter(Position <\/span>=<\/span> <\/span>2<\/span>)]\n      [String]<\/span>$BalloonTipTitle<\/span> <\/span>=<\/span> <\/span>''<\/span>,\n      [Parameter(Position <\/span>=<\/span> <\/span>3<\/span>)]\n      [System.Windows.Forms.ToolTipIcon]<\/span>$BalloonTipIcon<\/span> <\/span>=<\/span> <\/span>'None'<\/span>,\n      [Parameter(Position <\/span>=<\/span> <\/span>4<\/span>)]\n      [int]<\/span>$Timeout<\/span> <\/span>=<\/span> <\/span>0<\/span>\n     )\n    \n    <\/span>if<\/span>(<\/span>$NotifyIcon<\/span>.Icon <\/span>-eq<\/span> <\/span>$null<\/span>)\n    {\n        <\/span>#Set a Default Icon otherwise the balloon will not show<\/span>\n        <\/span>$NotifyIcon<\/span>.Icon <\/span>=<\/span> [System.Drawing.Icon]<\/span>::<\/span>ExtractAssociatedIcon([System.Windows.Forms.Application]<\/span>::<\/span>ExecutablePath)\n    }\n    \n    <\/span>$NotifyIcon<\/span>.ShowBalloonTip(<\/span>$Timeout<\/span>, <\/span>$BalloonTipTitle<\/span>, <\/span>$BalloonTipText<\/span>, <\/span>$BalloonTipIcon<\/span>)\n}<\/span><\/pre>\n
Example Use:<\/p>\n
Show-NotifyIcon<\/span> <\/span>-NotifyIcon<\/span> <\/span>$notifyicon1<\/span> <\/span>-BalloonTipText<\/span> <\/span>$textboxText<\/span>.Text `<\/span>\n<\/span> <\/span>-BalloonTipTitle<\/span> <\/span>$textboxTitle<\/span>.Text -BalloonTipIcon<\/span> <\/span>$combobox1<\/span>.SelectedItem<\/span><\/span><\/pre>\n
 <\/p>\n
You can download the NotifyIcon Sample<\/a> from our Downloads<\/a> section.<\/p>\n","protected":false},"excerpt":{"rendered":"
The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PowerShell Studio 2012, details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms. Last time we took a look at the […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[705,509,575,644,25],"tags":[641,704,28,633,327],"class_list":["post-4114","post","type-post","status-publish","format-standard","hentry","category-powershell-studio-2012","category-primalforms-software-news","category-primalforms-2011-software-news","category-spotlight-on-controls","category-windows-powershell","tag-controls","tag-notifyicon","tag-powershell","tag-primalforms-2011","tag-winform"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/4114","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=4114"}],"version-history":[{"count":7,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/4114\/revisions"}],"predecessor-version":[{"id":4272,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/4114\/revisions\/4272"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=4114"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=4114"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=4114"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}