JVCL Help:TJvTrayIcon

From Project JEDI Wiki
Jump to navigationJump to search
JEDI Visual Component Library Help

Search in JVCL Help

 
Search in all projects
 

Class Hierarchy

TJvTrayIcon
run\JvTrayIcon.pas


Summary

Adds an icon to the tray.

run\JvTrayIcon.pas


Pascal

 run\JvTrayIcon.pas
 TJvTrayIcon = class(TJvComponent);


Description

  1. JVCLInfo

Use TJvTrayIcon to add an icon to the taskbar notification area. Applications commonly put icons in the status area of the taskbar - also called "tray" - to serve as status indicators. For example, an application might put a printer icon in the status area to show that a print job is under way. The status area is located at the right edge of the taskbar (if the taskbar is horizontal) or at the bottom (if the taskbar is vertical).
You can provide additional information when the user performs mouse actions, such as moving the mouse pointer over the icon or clicking the icon. Use the OnContextPopup, OnClick, OnDblClick, OnMouseDown, OnMouseMove and OnMouseMove events for this purpose.
Typically, clicking the icon causes the application to display a window with additional information, right-clicking displays a shortcut menu, and double-clicking executes the default shortcut menu command.
The default behavior of TJvTrayIcon is to automatically hide the application's button on the taskbar, if the user minimizes the application and not to react on mouse clicks on the tray icon. Use property Visibility to alter this behavior. For example, include tvRestoreClick in Visibility, to automatically restore the minimized application when the user clicks the tray icon with the left button. Use DropDownMenu or PopupMenu to display a shortcut menu, when the user clicks the icon.
Use the Animated, Delay and Icons properties to set up an animation in the tray. When Animated is set to true, TJvTrayIcon will start iterating through the image list specified by Icons and display each icon for Delay milliseconds in the notification area. SetAnimated to false to stop the animation.
Call BalloonHint to display a cartoon-style "balloon" with a stem pointing to the icon in the taskbar notification area. Not all systems support balloon ToolTips: check AcceptBalloons to determine if balloon ToolTips are supported. Use the OnBalloonClick, OnBalloonHide and OnBalloonShow to react on user events.

run\JvTrayIcon.pas


About

Navigation

run\JvTrayIcon.pas



Contribute to this help topic

This documentation wiki is based on the collaborative effort of Project JEDI users. Your edits are welcome in order to improve documentation quality: edit this page