User-Defined Function to Center Messages on a Row

Last reviewed: April 30, 1996
Article ID: Q108679
The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, version 3.0
  • Microsoft FoxPro for Windows, versions 2.5, 2.5a, and 2.5b
  • Microsoft FoxPro for MS-DOS, versions 2.0, 2.5, 2.5a, and 2.5b

SUMMARY

CENTMESS(), the user-defined function (UDF) shown below, centers a message in a row or column. CENTMESS() subtracts the length of the message from the length of the output area, divides the results by 2, and displays the message at the passed row and computed column.

If a message is being sent to a window:

  • Use WCOLS() to return the number of columns in a window.
  • Use WROWS() to return the number of rows in a window.

For example, to center an output message in the last row of a window, you would use the following syntax:

   =CENTMESS(WROWS()-1,WCOLS(),"This is the message to center")

MORE INFORMATION

   * In the following example, the output area is the desktop.

   CLEAR
   SET TALK OFF
   SET CURSOR OFF
   =CENTMESS(15,SCOL(),"This is the message to center")


   ******************************************************************
   * Function..: CENTMESS
   * Notes.....: This function centers messages based on their length
   *             and the length of the output area.
   *
   * Parameters: Mrow - The row the message will be displayed on.
   *             Mlen - The length used to compute the center of the
   *                    message.
   *             Mess - The message to display.
   ******************************************************************
   FUNCTION centmess
   PARAMETER Mrow, Mlen, Mess
   Mcol = (Mlen - LEN(Mess)) / 2
   @ Mrow, Mcol SAY Mess
   RETURN(.T.)


Additional reference words: VFoxWin 3.00 FoxDos FoxWin 2.50 2.50 2.50a
2.50b
KBCategory: kbprg kbcode
KBSubcategory: FxprgGeneral


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: April 30, 1996
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.