  TInputDialog and TMessageDialog Components for Borland Delphi
  =============================================================
  
  Copyright (c) 1995 OfficeSoft LLC. All Rights Reserved.

  Author:
    Christopher S. Lim		
    OfficeSoft LLC
    517 Cobb Court
    La Puente, CA 91746
    Compuserve: 74542,1670
    Internet: 74542.1670@compuserve.com

  Disclaimer:
    Use this program at your own risk. OfficeSoft LLC provides no
    warranties, expressed or implied.

  Overview:
    TInputDialog and TMessageDialog are components that encapsulate the
    Delphi InputQuery and MessageDlg functions, respectively.
    The TInputDialog and TMessageDialog components will greatly simplify
    creating and maintaining message and input boxes in your applications.
    These components add a number of enhancements such as the ability to 
    specify formatting strings and multi-line messages. 
    At design time, you can immediately view the dialog box by 
    double-clicking on the component.

  
  Distribution License:
    TInputDialog and TMessageDialog object code are distributed as freeware.
    You may freely upload this program to any public bulletin board such
    as the Internet, Compuserve, Prodigy, America On-Line, etc.
    You may not sell the program or package it as part of another library.  
    Shareware distributors may, however, distribute the program for a small
    fee to cover their distribution costs.
    You may not modify, add, delete or replace any of the distribution 
    files without the permission of the author.

  Source Code Availability:    
    The source code is available separately and is not freeware. 
    Having the source code gives you the ability to recompile
    the components to work with future versions of Delphi. 

    To register and receive the source code, please send a check 
    or money order in the amount of US$25 to:

       OfficeSoft LLC
       517 Cobb Court
       La Puente, CA 91746
       USA

    If you are a member of Compuserve, you can register via 
    Compuserve's SWREG forum (GO SWREG). The Registration ID
    is 8386, or you can search for the keyword "MSGDLG".
    There is a surcharge for ordering via SWREG.

===========================================================================
Packing List:

  README.TXT	This file
  MSGDLG.DCU	Object file
  MSGDLG.DCR	Resource file

===========================================================================
Installation:

  1. Place the distribution files in the Delphi LIB directory or in another
     directory.
  2. Run Delphi and select Options | Install Components.
  3. Check that the Search Path contains the directory with the distribution
     files.
  4. Click on the Add button and enter "MSGDLG"
  5. Click OK.
 
The components will be installed in the Dialogs page of the component palette.


===========================================================================

Component Description and Documentation: 

  TInputDialog
  ============

    Property Declarations:
      Caption: String;
      Prompt: String;
      Text: String;
      Cursor: TCursor;

    Method Declarations:
      function Execute : Boolean
      function ExecuteFmt(const Args : array of const) : Boolean

    Design Note:
      In Design mode, you can double click the component at any time to
      preview the dialog box.

    Description:
      TInputDialog encapsulates the Delphi InputQuery function.
      The purpose of TInputDialog is to display an input dialog box
      ready for the user to enter a string in its edit box.

      The Caption property is the caption of the
      dialog box.

      The Prompt property is the text that prompts the user to
      enter input in the edit box.

      The Text property is the string that
      appears in the edit box when the dialog box first appears.
      At run-time, if the user changes the string in the edit box 
      and chooses OK, use the Text property to read the new value.

      The Cursor property specifies the mouse cursor type when the dialog
      box is visible.

      Use the Execute method to display the input dialog box.
      The Execute method returns TRUE if the user chooses OK, and FALSE
      if the user chooses CANCEL or presses the Esc key.

      The ExecuteFmt method is similar to the Execute method except that
      the Prompt property is treated as an Object Pascal format string.
      For more information on format strings, refer to the description of
      the Format function in Delphi's on-line help.
      You pass a series of arguments when you call ExecuteFmt.
      For example:

        with InputDialog1 do
        begin
          Prompt := 'Enter %s name:';
          if IsMale then
            ExecuteFmt(['his'])  {Displays 'Enter his name:' }
          else
            ExecuteFmt(['her']);  {Displays 'Enter her name:' }
        end;

=========================================================================

 TMessageDialog
 ==============
    Property Declarations:
      Text: String;
      MsgType: TMsgDlgType;
      Buttons: TMsgDlgButtons;
      HelpContext: LongInt;
      LineSeparator: string;
      Cursor: TCursor;

    Method Declarations:
      function Execute : Boolean
      function ExecuteFmt(const Args : array of const) : Boolean

    Design Note:
      In Design mode, you can double click the component at any time to
      preview the dialog box.

    Description:
      TMessageDialog encapsulates the Delphi MessageDlg function.
      The purpose of TMessageDialog is to display a message dialog box
      in the center of your screen. The message box displays the value
      of the Text property.

      The MsgType property determines the type of the message box that
      appears. These are the possible values:

          MsgType         Meaning
          -------         -------
          mtWarning       A message box containing a yellow exclamation point
                          symbol
          mtError         A message box containing a red stop sign.
          mtInformation   A message box containing a blue "i"
          mtConfirmation  A message box containing a green question mark.
          mtCustom        A message box containing no bitmap. The caption of
                          the message box is the name of the application's
                          executable file.

      The Buttons property determines which buttons appear in the message box.

      The HelpContext property determines which Help screen is available for
      the message box. (For more information on the HelpContext property,
      refer to the Delphi on-line help.)

      The LineSeparator property allows you to display the value of the
      Text property as multiple lines. The LineSeparator property defines
      the string used to indicate the start of a new line. By default,
      LineSeparator is defined to be '\n'.  For example:

        with MessageDialog1 do
        begin
          Text := 'Line 1\nLine 2\nLine 3';
          Execute; { displays message as:
                          Line 1
                          Line 2
                          Line 3
                    }
        end;

      Note that the Text property is an Object Pascal string and
      is limited to 256 characters total.

      The Cursor property specifies the mouse cursor type when the dialog
      box is visible.

      The Execute method returns the value of the button that the user
      selected. These are the possible values:

        Return Value    If the User chose...
        ------------    ------------------
        mrOK            OK button
        mrCancel        Cancel button
        mrAbort         Abort button
        mrRetry         Retry button
        mrIgnore        Ignore button
        mrYes           Yes button
        mrNo            No button
        mrAll           All button

      The ExecuteFmt method is similar to the Execute method except that
      the Text property is treated as an Object Pascal format string.
      For more information on format strings, refer to the description of
      the Format function in Delphi's on-line help.
      You pass a series of arguments when you call ExecuteFmt.
      For example:
        with MessageDialog1 do
        begin
          Text := 'The database has %d records';
          ExecuteFmt([Table1.RecordCount]);
        end;


*** END OF FILE ***

