FORM.DIALOG()
Syntax
Last_Button as C = FORM.DIALOG( Form_Name as C [, Window_Name as C [, Filter as C, [ Order as C [, QueryFlags as C [, Horiz_Position as C [, Vert_Position as C [, ShowNewRecord as L ]]]]]]] )
|
Argument |
|
Description |
|
Form_Name |
V5 |
The name of the form to open. |
|
Window_Name |
V5 |
Optional. Not applicable. |
|
Filter |
V5 |
Optional. Default = ".T." (All records). A character filter expression that evaluates to a logical value and selects the records to show in the dialog. This filter is in addition to any filter specified in the form's Properties dialog box. |
|
Order |
V5 |
Optional. Default = record order. A character order expression that sorts selected records. |
|
QueryFlags |
V5 |
Optional. Sort instructions.
|
|
Horiz_Position |
V5 |
Optional. Horizontal position of dialog. Overrides any position settings defined in the form's Properties dialog box. Options are:
|
|
v6 |
An absolute position in pixels. | |
|
Vert_Position |
V5 |
Optional. Vertical position of dialog. Overrides any position settings defined in the form's Properties dialog box. Options are:
|
|
v6 |
An absolute position in pixels. | |
|
ShowNewRecord |
V5 |
Optional. If ShowNewRecord is .T., and if the user specifies a Filter and no records satisfy the filter condition, then Alpha Five will open the form ready to accept a new record. However, if ShowNewRecord is .F. then Alpha Five does not open the dialog box, and the function returns "NoRecordsFound". |
Description
The <FORM>.DIALOG() method opens Form_Name as a dialog box. When the user closes the dialog, the object name of the last button pressed is stored in Last_Button. See Opening a Dialog Box for more information.
Supported By
Alpha Five Version 5 and Above
Limitations
Desktop applications only.
Example
|
xx = form.dialog("edit_customer_info", "", "recno()= 7711", "lastname", "", "right", "center", .f.) ? xx = "NoRecordsFound" |
See Also
Form Functions and Methods, Writing Expressions