FoxTray

0.2.3

This is the documentation for FoxTray a tray icon class for the FOX Toolkit. To begin take a look at the Readme section.

Readme

FoxTray -- A system tray icon for FOX Toolkit

Table of Contents
  1. Installation
  2. Warning
  3. Usage


1. Installation
    
    To install FoxTray just copy the contents of the src directory into
    your project an compile the file x11/FXTrayIcon.cpp or 
    win32/FXTrayIcon.cpp, depending on the platform you are targeting,
    into your program. Use the usual compiler settings, to compile a 
    FOX application.

    Microsoft Windows Issue

    If you are installing FXTrayIcon, when targeting Windows, you have
    to change the file fxicon.h!

    Add the following line to the FXIcon class
        
        friend class FXTrayIcon;

    This is needed, because FOX doesn't let you access the Windows 
    specific representation of an icon.

2. Warning
    
    DO NOT RELY on the icon to be displayed. Make sure the application
    works without the tray icon. The icon is displayed as soon as a
    tray is detected, but there may be no tray at all.

3. Usage

    First you need to create a class of the type FX::FXTrayApp class 
    instead of FX::FXApp. If you forget this step, some Messages will not
    be processed an the icon may not display at all.

    Include the file FXTrayIcon.h to use the 
    FX::FXTrayIcon class. See documentation for details.

Changelog

0.2.3 - 2008-10-18:

Fixed some issues with less known tray managers.

Added size hints, for better sizing behavior.

0.2.2 - 2008-09-21:

Fixed a bug with a metaClass wich could crash the 
application.

0.2.1 - 2008-09-21:

The icon is now recreated if the tray is restarted. Also the
icon is shown, if the tray was not started on application 
launch.

0.2 - 2008-08-29:

Added FXTrayIcon::setIcon
Added FXTrayIcon::getIcon
Added FXTrayIcon::setText
Added FXTrayIcon::getText

Fixed X11 icon alignment

Copying

FoxTray, system tray icon for the FOX Toolkit

Copyright (c) 2008, Hendrik Rittich
All rights reserved.

Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions are
met:

    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in 
      the documentation and/or other materials provided with the 
      distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

---