DOCUMENT:Q124717 12-FEB-2000 [foxpro] TITLE :How to Use the FXALERT() Function in FOXTOOLS.MLB PRODUCT :Microsoft FoxPro PROD/VER:MACINTOSH:2.6a,3.0b OPER/SYS: KEYWORDS:kbcode ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Visual FoxPro for Macintosh, version 3.0b - Microsoft FoxPro for Macintosh, version 2.6a ------------------------------------------------------------------------------- SUMMARY ======= The FXALERT() function in FOXTOOLS.MLB (FOXTOOLS.CFM or FOXTOOLS.SLM in Visual FoxPro for Macintosh), displays an alert and waits for a user response. One of three icons can be displayed in the alert dialog box based on the type of alert chosen . FXALERT returns a value representing the user exit action. Because of the presence of the function, the user can take advantage of the Macintosh system interface and pause the execution of an application without requiring an additional READ level. MORE INFORMATION ================ Sample Code - Example Syntax for FXALERT Function ------------------------------------------------- The following code is an example of the syntax required to use the FXALERT function. The following code is an example of the syntax required to use the FXALERT function. *** Begin Code *** * *************************************************************** * The sample program named MY_ALERT.PRG uses the FOXTOOLS * * Library function FXALERT. The program prompts the user to * * enter a message or stop to quit the program. If the user * * enters a message other than "stop," the program requests an * * icon value of 0=Caution, 1=Stop, or 2=Note. After the user * * chooses an icon, the program displays the selected icon and * * entered message in an alert dialog box. Once the FXALERT * * function is activated, the user is allowed to choose either * * Yes or No. After the user selects the push button prompt in * * the dialog, the screen is cleared and a message is * * displayed as a wait window displaying the choice made. The * * cycle continues until stop is entered in the message area. * * NOTE: No READ CYCLE was required for the push button prompts* * or the FXALERT dialog interface. * * ************************************************************* * WARNING: Make sure all work is saved before running this code. SET LIBRARY TO SYS(2004)+"FOXTOOLS.MLB" ADDITIVE * Use the following line with FoxPro for Macintosh * SET LIBRARY TO SYS(2004)+"FOXTOOLS.CFM" ADDITIVE ACTIVATE WINDOW SCREEN && refresh main FoxPro window flag = .t. && Set Flag for DO WHILE DO WHILE flag CLEAR ACCEPT "Please Enter a Message or Stop -->" TO msg If UPPER(msg) = "STOP" EXIT ELSE INPUT " 0 = Caution, 1 = Stop, 2 = Note -->" TO fx_icon reply = FXALERT((fx_icon),259,-1,-1,(msg)) If reply = 1 && Determine button pressed WAIT WINDOW "(Yes) was Pressed" TIMEOUT 3 Else WAIT WINDOW "(No) was Pressed" TIMEOUT 3 ENDIF ENDIF ENDDO SET LIBRARY TO && Close FOXTOOLS.MLB Library. CLEAR && Clear Screen *** End Code *** The following information describes the syntax and parameters for the FXALERT function. It is an excerpt from the FoxTools ReadMe file. FXALERT() Syntax ---------------- Syntax: FXALERT(, , , [, ] [, ][, ][, ]) NOTE: If the FOXTOOLS.MLB is not referenced the following Program Error is generated "File Does Not Exist." Specifies a number that indicates the icon to be displayed on the alert. 0=CAUTION; 1=STOP; 2=NOTE. Specifies the resource number. FOXTOOLS contains the same twelve alerts provided in the FOXUSER file of FoxBASE+ for Macintosh. In FOXTOOLS, the resource numbers are 257 through 268 instead of 1 through 12 as in FoxBASE+ for Macintosh. An alert contains different possible push button combinations which you can choose. For example, resource number 259 contains the push buttons "Yes" and "No" with the focus initially on the "Yes" push button. , Specify the coordinates, measured in pixels from the top left of the screen, at which the alert will be placed. Use a value of -1 for and/or to accept the default position. The default position is centered. NOTE: Regardless of the coordinates specified in and/or , the alert will always come up centered on the screen. [, ][, ][, ][, ] Specify text that will appear on the alert. The following table shows the push buttons displayed on each of the twelve alerts with the default focus push button shown in parentheses. Res# Button 1 Button 2 Button 3 Note ---------------------------------------------------------------- 257 (Continue) 258 (OK) 259 (Yes) No 260 Yes (No) 261 (Yes) No Cancel 262 Yes (No) Cancel 263 (Continue) Bigger alert than 257 264 (OK) Bigger alert than 258 265 (Yes) No Bigger alert than 259 266 Yes (No) Bigger alert than 260 267 (Yes) No Cancel Bigger alert than 261 268 Yes (No) Cancel Bigger alert than 262 REFERENCES ========== FoxTools Readme file in FoxPro:Goodies:Misc folder for FoxPro for Macintosh versions 2.x. FoxTools Help file in the Visual FoxPro:Goodies folder for Visual FoxPro for Macintosh version 3.0. Additional query words: vFoxMac FoxMac msgbox messagebox box message alert ====================================================================== Keywords : kbcode Technology : kbHWMAC kbOSMAC kbVFPsearch kbAudDeveloper kbFoxproSearch kbFoxPro260aMac kbVFP300bMac Version : MACINTOSH:2.6a,3.0b ============================================================================= 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. Copyright Microsoft Corporation 2000.