w3mvDInit

 Syntax   Parameters   Example Programs   Examples

 w3mvDInit allows you to use an mvDesigner form with FlashCONNECT.

Syntax  

call w3mvdInit  ( Formname , Options)  

Parameters

Formname

In

The name of the mvDesigner form. If "", the current form is reused. If the FlashCONNECT application is being called from a forms constructor or destructor (w3TriggerEvent equal to $construct or $destruct), the Formname must be "". If called from an mvDesigner remote form, the next form must also be a remote form. If called from an mvDesigner window, the next form must also be an mvDesigner window.

Options

In

Options which control the display of the form:

  • p_FN_Popup

If set, the new form displays over the current form. If this option is used, a Formname must be specified. If no Formname is specified, this option is ignored.

  • p_FN_CloseTopWindow

If set, the current top window is closed and the values in this message are applied to the previous form.

To set both options, add them together. 0 or "" indicates no options are set.  

 

The following table describes the interaction between the Formname parameter and the options parameter (see parameter descriptions that follow.) The results assume that there are up to three forms involved. Forms A and B are already open with Form A as the bottom form and Form B on top of Form A. If specified, Form C is the form in the call.

FormName Specified

CloseTop Window

PopUp

Results

Data applies to form

Resulting forms

Initial State

-

-

Two windows open; B is on top of A.

-

A,B

 

FormName Specified

CloseTop Window

PopUp

Results

Data applies to form

Resulting forms

Yes

No

No

Top window is closed; new window is opened using specified form. Data in message applies new window.

C

A,C

Yes

No

Yes

New form is opened as is a  top window. Data in message applies new window.

C

A,B,C

Yes

Yes

No

Unsupported. Currently behaves as if p_FN_PopUp was set. Future behavior may change.

 -

 -

Yes

Yes

Yes

Top window is closed, and new window is opened using specified form. Data in message applies new window.

C

A,C

No

No

No

No windows change. Data in message applies top window.

B

A,B

No

No

Yes

Invalid. Currently acts like p_FN_PopUP was not set.

-

-

No

Yes

No

Top window is closed. Data in message applies previous window.

A

A

No

Yes

Yes

Invalid. Currently acts like p_FN_PopUP was not set.

-

-

Example Programs

mvD.Test2

mvDCompile

w3admin.w3apps

w3mvDTimeoutTest

mvDEchoP

w3mvDDiscardEventTest

restartFlashCONNECT

persistentConnection

w3mvDTestSelection

mvDEcho

w3mvDProgressTest

w3mvDPopUpTest

mvDId

EchomvD

mvD.TestTree

w3mvDlogonTest

mvD.Test1

Examples

call w3mvDInit("rfRegForm","")          ;* use new form

call w3mvDInit("","")                   ;* apply to current form

call w3mvDInit("rfNewForm", p_FN_Popup) ;* Show form as popup

call w3mvDInit("", p_FN_CloseTopWindow) ;* Close popup, apply change to previous window

call w3mvDInit("rfNewForm", p_FN_Popup+p_FN_CloseTopWindow);*Close top window, pop new top window and show it