-CONTENTS-

• title
  
• package
  
• release
  
• target
  
• installation
  
• usage
  
• sources
  
• contact
  
• history
  
• license
  

-TITLE-

TmpAnimatedCursors is a non visual component to simplify management and usage of animated cursors within delphi applications

-PACKAGE-

TmpAnimatedCursors component for borland delphi

-RELEASE-

v 0.01, may 27, 2001

-TARGET-

borland delphi 4.xx

-INSTALLATION-

• copy or extract mpanicur.pas, mpanicurreg.pas, mpanicurreg.dfm and mpanicurreg.dcr into a folder included in delphi's search path (like $(DELPHI)\lib).
• select "component"->"install component" in delphi's main menu.
• type mpanicurreg.pas into the "unit name" edit box.
• select "OK".
• after the component package is opened in delphi, click "compile".
• then, after recompilation of the package, you should find the component on the "mirkes.de" component palette tab.

-USAGE-

TmpAnimatedCursors is a non visual component, just one single TmpAnimatedCursors component should be placed in an application, it's cursors can be accessed from all forms and components.

doubleclick the component to open the cursor management dialog, it's quite similar to delphi's editor for TImageList items.

by pressing the "add" button, you can add animated (and also still) cursors to the list by selecting them in a file selection dialog. the listview in the lower corner shows a preview of all cursors in the list, the upper left panel displays the currently selected cursor with animation.

each of the cursor items has the following properties:

• CursorID: TCursor (r/w)
  the index to the Screen.Cursors[x] array (the cursor image will be stored there). by setting a form's/component's Cursor or DragCursor property to this number, it will use that cursor image. Delphi's and the system's cursors cannot be overwritten by TmpAnimatedCursors, so the CursorID number must be greater than zero.
  
  
• Description: string (r/w)
  this is a descriptive string for the cursor image (e.g. "smiley" for a smiley cursor). it's initial value is read from the original cursor file's name. you can change the description by modifying the text of the cursor image in the listview. you can also use those descriptions in the object editor; to set a form's cursor to that smily cursor, just type "_cr_smiley" in the Cursor property field of the object editor (or choose it from the list).
  
  

to set a component's cursor to a TmpAnimatedCursors item by description at runtime (e.g. to set Form1.Cursor to the cursor called "smiley"), use the mpAniCurIDToCursor routine:

Form1.Cursor := mpAniCurIDToCursor('smiley');

-SOURCES-

included

-CONTACT-

markus stephany, losheim am see, saarland, germany
mailto:merkes@mirkes.de
http://www.mirkes.de

-HISTORY-

version 0.01

initial release

-LICENSE-

    --------------------------------------------------------------------------------
    TmpAnimatedCursors Copyright (C) 2001 markus stephany                                           
                                                                                                                  
    This package is free software; you can redistribute it and/or modify                                         
    it under the terms of either:                                                                                
                                                                                                                 
    a) the GNU General Public License as published by the Free                                                   
    Software Foundation; either version 2, or (at your option) any                                               
    later version, or                                                                                            
                                                                                                                 
    b) the Clarified Artistic License as used by the authors of NCFTP                                            
    version 3.0.2.                                                                                               
                                                                                                                 
    This package is distributed in the hope that it will be useful,                                              
    but WITHOUT ANY WARRANTY; without even the implied warranty of                                               
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU                                            
    General Public License / Clarified Artistic License for more details.                                                            
                                                                                                                 
    You should have received a copy of the GNU General Public License                                            
    along with this package in the file named "COPYING"; if not,                                                 
    write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,                                     
    Boston, MA 02111-1307, USA.                                                                                  
                                                                                                                 
    You should also have received a copy of the Clarified Artistic                                               
    License along with this package in the file named "ARTISTIC"; if not,                                        
    you may find a copy at http://www.mirkes.de/downloads/ARTISTIC.txt                                           
    --------------------------------------------------------------------------------

-END-