readme.htm

免费控件PicShow的最新版本

    <BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>ThreadPriority: 
    TThreadPriority<BR>
    TThreadPriority = (tpIdle, tpLowest, tpLower, tpNormal, tpHigher, tpHighest, 
    tpTimeCritical)<BR>
    </B> Determines the thread's scheduling priority relative to other threads 
    in the process.</FONT></LI>
</UL>
<P><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><A NAME="METHODS"></A></B></FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><A NAME="METHODS"></A><BR>
  <FONT SIZE="4">KEY METHODS</FONT></B></FONT></P>
<UL>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>procedure Clear;<BR>
</B>Clears the client area of the control. Notice that calling this method does not clear the image loaded in to the <I>Picture</I> property.<BR>
    <BR>
  </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">    <B>procedure 
      Execute;<BR>
    </B> Initials the transition and if <I>Manual</I> property is set false, starts 
      it. If <I>Manual</I> property is set to true, after calling this method you 
      can change the value of <I>Progress</I> property.<BR>
    <BR>
  </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>function GetStyleNames(Names: TStrings): Integer ;<BR>
  </B> Adds the name of built-in transition effects to the list specified by the Names parameter. The function returns the number of entries added to the list.<BR>
      <BR>
  </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>procedure 
      Stop;<BR>
    </B>Stops the running transition.</FONT></LI>
</UL>
<P><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><A NAME="EVENTS"></A><BR>
  <FONT SIZE="4">KEY EVENTS</FONT></B></FONT></P>
<UL>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnAfterNewFrame: 
    TCustomDrawEvent<BR>
    TCustomDrawEvent = procedure(Sender: TObject; Picture, Screen: TBitmap) of 
    object<BR>
    </FONT></B><FONT SIZE="2"> This event is triggered just after creating a new 
    frame of the transition and before drawing it on the control's client area. 
    The Picture parameter is the original image and the Screen parameter is the 
    content of the control's client area after the new transition frame.<BR>
    <FONT COLOR="#990000">When PicShow is running in Threaded mode, this event 
    occurs in control's thread.</FONT><BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>OnBeforeNewFrame: 
    TCustomDrawEvent<BR>
    </B></FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">TCustomDrawEvent 
    = procedure(Sender: TObject; Picture, Screen: TBitmap) of object<BR>
    </FONT></B><FONT SIZE="2"> This event is triggered just before creating a 
    new frame of the transition. </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">The 
    Picture parameter is the original image and the Screen parameter is the content 
    of the control's client area before the new transition frame.</FONT><FONT SIZE="2"><BR>
    </FONT><FONT SIZE="2" COLOR="#990000">When PicShow is running in Threaded 
    mode, this event occurs in control's thread.</FONT><FONT SIZE="2"> <BR>
    </FONT></FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnChange: 
    TNotifyEvent </FONT></B><FONT SIZE="2">(TPicShow only)</FONT><B><FONT SIZE="2"><BR>
    </FONT></B><FONT SIZE="2">Occurs when content of <I>Picture</I> property has 
    changed.</FONT><BR>
    <BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnStart: 
    </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"> TCustomDrawEvent<BR>
    TCustomDrawEvent = procedure(Sender: TObject; Picture, Screen: TBitmap) of 
    object</FONT><FONT SIZE="2"><BR>
    </FONT></B><FONT SIZE="2"> Occurs before beginning of the transition. After 
    calling <I>Execute</I> Method, the control copies the loaded image into a 
    bitmap and use it for transition purpose. </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">The 
    Picture parameter is the original image and the Screen parameter is the content 
    of the control's client area just before any transition.</FONT> <FONT SIZE="2">When 
    this event is triggered, you can load another image into the component for 
    the next transition.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnStop: 
    TNotifyEvent<BR>
    </FONT></B><FONT SIZE="2"> Occurs when transition is completed or aborted.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnComplete: 
    TNotifyEvent<BR>
    </FONT></B><FONT SIZE="2"> Occurs when the transition effect has compeleted 
    normally. If transition stops by calling <I>Stop</I> method, this event does 
    not occur.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>OnProgress: 
    TNotifyEvent<BR>
    </B>Occurs just after drawing a frame of the transition on the client area 
    of the control.<BR>
    </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2" COLOR="#990000">When 
    PicShow is running in Threaded mode, this event occurs in control's thread.</FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"> 
    <BR>
    <BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnCustomDraw: 
    TCustomDrawEvent<BR>
    TCustomDrawEvent = procedure(Sender: TObject; Picture, Screen: TBitmap) of 
    object<BR>
    </FONT></B><FONT SIZE="2"> If <I>Style</I> property set to 0, this event is 
    triggered when the control needs to create a new frame of the transition. 
    </FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"> The Picture 
    parameter is the original image and the Screen parameter is the content of 
    the control's client area, which should be updated.</FONT><FONT SIZE="2"><BR>
    </FONT><FONT SIZE="2" COLOR="#990000">When PicShow is running in Threaded 
    mode, this event occurs in control's thread.</FONT><FONT SIZE="2"> <BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnMouseEnter: 
    TNotifyEvent<BR>
    </FONT></B><FONT SIZE="2"> Occurs when the mouse pointer moves over the control.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnMouseLeave: 
    TNotifyEvent<BR>
    </FONT></B><FONT SIZE="2">Occurs when the mouse pointer moves off from over 
    the control.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnAfterLoadPicture: 
    TNotifyEvent </FONT></B><FONT SIZE="2">(TDBPicShow only)</FONT><B><FONT SIZE="2"><BR>
    </FONT></B><FONT SIZE="2">Occurs when a new picture is loaded into the control.</FONT><BR>
    <BR>
    </FONT></LI>
  <LI> <FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnBeforeLoadPicture: 
    TNotifyEvent </FONT></B><FONT SIZE="2">(TDBPicShow only)</FONT><B><FONT SIZE="2"><BR>
    </FONT></B><FONT SIZE="2">Occurs when a new picture is being load into the 
    control.<BR>
    <BR>
    </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><FONT SIZE="2">OnGetCraphicClass: 
    TGetGraphicClassEvent</FONT></B><FONT SIZE="2">(TDBPicShow only)</FONT><B><FONT SIZE="2"><BR>
    TGetGraphicClassEvent = procedure(Sender: TObject; var GraphicClass: TGraphicClass) 
    of object; <BR>
    </FONT></B><FONT SIZE="2">Occurs when a new picture is about to load into 
    the control. TDBPicShow can recognize JPEG images stored in blob fields, however 
    it treats all other graphic formats as bitmap. This event gives this opportunity 
    to the application to specify the graphic class type of the data in the blob 
    field.</FONT></FONT></LI>
</UL>
<P><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><A NAME="LIMITATION" ID="LIMITATION"></A><BR>
  <FONT SIZE="4">LIMITATION</FONT></B></FONT></P>
<BLOCKQUOTE>
  <P><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">The control 
          does not support image transparency. The transparent area of the  images with transparency, will fill with the control's color. </FONT></P>
</BLOCKQUOTE>
<P><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><A NAME="HISTORY"></A></B><B></B></FONT><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><B><BR>
<FONT SIZE="4">HISTORY</FONT></B></FONT></P>
<UL>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>4.04 (July 1, 2006)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
</FONT></FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2">- Added detection of Exif JPEG format to TDBPicShow (Thanks to <a href="mailto:[e-mail]">Nest King</a>).<br>
- 
Fixed AV Exception of TDBPicShow occured by assigning JPEG images to the field.<B>
<BR>
<br>
  </B></FONT></FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>4.03 (April 28, 2006)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
  - Four new transition effects are added (168-171). <BR>
  <BR>
  </FONT></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>4.02 (April 24, 2006)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
  - Some minor optimizations are applied.<BR>
  - By adding light reflaction effect, unroll transitions are improved (14-15 and 31-32).<BR>
  - Fifteen new transition effects are added (153-167). <br>
  <BR>
  </FONT></FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>4.01 (April 16, 2006)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    - Some more optimizations are applied.<BR>
    - The new <EM>GetStyleNames</EM> method is added.<BR>
    - The provided demo program is improved.<BR>
    <BR>
  </FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>4.00 (April 14, 2006)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
  - The code is entirely reviewed and optimized. The new code is much faster than before, so that slide show of large images is possible now.<BR>
  - The visual effect of some transition styles are improved. <BR>
  - Two new transition effects are added (151 and 152).
  <BR>
  - For compatibility with Delphi's TImage control, <EM>StretchFile</EM> property is renamed to <EM>Proportional</EM>. Also, its behavior is adapted to the <EM>proportional</EM> property the TImage control. <BR>
  - New <EM>FrameColor</EM> and <EM>FrameWidth</EM> properties are added.
  <BR>
  - For Delphi 4 and higher, all the Delphi controls' standard properties and events are added (New Properties:</FONT>
    <FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"> BevelEdges, BevelInner,         BevelOuter,         BevelKind,         BevelWidth,  BorderWidth, Constraints, DocSite, DragKind; New Events: OnCanResize, OnConstrainedResize, OnDockDrop, OnDockOver, OnEndDock, OnStartDock, OnUnDock).<BR>
    <BR>
    </FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>3.10 (November 
    25, 2004)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    - The new property <I>ExactTiming</I> added (Thanks to <A HREF="mailto:[e-mail]">Hertwig 
    van Zwietering</A>).<BR>
    <BR>
  </FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>3.09 (August 
    12, 2004)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    - The wrong signature of bitmap files fixed (Thanks to <A HREF="mailto:[e-mail]">Stefano 
    P.</A>).<BR>
    <BR>
    </FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>3.08 (December 
    6, 2003)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    - Native support for Windows Metafile (WMF) and Enhanced Metafile (EMF) image 
    formats added to TDPicShow.<BR>
    <BR>
    </FONT></LI>
  <LI><B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version </B>3.07 (November 
    17, 2003)</FONT></B><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><BR>
    - The rotational effects (119..122) are optimized.<BR>
    </FONT><BR>
  </LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version 3.06 (September 
    8, 2003)<BR>
    </B>- The bug in setting StyleName property fixed (Thanks to <A HREF="mailto:[e-mail]">Terry 
    Bogard</A>).<B><BR>
    <BR>
    </B></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version 3.05 (July 
    26, 2003)<BR>
    </B>- The definition of the <I>OnStart</I> event changed. Now the event passes 
    the original image and its underlying screen as two bitmaps to the handler.<BR>
    - The new property <I>OverDraw</I> is added. When this property is True, the 
    control draws the new transition over the last one, otherwise before starting 
    a new transition it clears the screen to the background.<B><BR>
    <BR>
    </B></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B> Version 3.04 (July 
    12, 2003)</B><BR>
    - The bug on uninitialized off-screen bitmap fixed (Thanks to <A HREF="mailto:[e-mail]">Miguel 
    Gastelumendi Dargent</A>).<BR>
    </FONT><BR>
  </LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version 3.03 (July 
    6, 2003)<BR>
    </B>- The bug of corrupted image after loading it to TDBPicShow fixed.<B><BR>
    <BR>
    </B></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B> Version 3.02 (May 
    29, 2003)<BR>
    </B>- The bad result on rendering stretched images on Windows 2000 and XP 
    fixed.<B><BR>
    <BR>
    </B></FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B> Version 3.01 (May 
    8, 2003)</B><BR>
    - The code related to thread's termination optimized (Thanks to <A HREF="mailto:[e-mail]">Viatcheslav 
    V. Vassiliev</A>).<BR>
    <BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version 3.00 (February 
    16, 2003)</B><BR>
    - Transition effects moved to a separate unit.<BR>
    - The number effects increased to 150 effects.<BR>
    <BR>
    </FONT></LI>
  <LI><FONT FACE="Verdana, Arial, Helvetica, sans-serif" SIZE="2"><B>Version 2.81.3 (January 
    11, 2003)</B><BR>
    - Known bugs of TDBPicShow fixed (Thanks to <A HREF="mailto:[e-mail]">Vicente