Embeds an OI form by name so you can embed multiple forms.

Syntax

Send_Message(Ctrl, "OLE.AddNamedForm", Handle, Name, FitWidth, FitHeight)

Parameters

ParameterDescription
HandleThe windows handle to the form to embed.
NameThe string that uniquely identifies this form for future reference.
FitWidthFlag determining whether to use the form's width or the SRP Panel's width
FitHeightFlag determining whether to use the form's height or the SRP Panel's height

Remarks

The AddNamedForm method embeds an OI form inside the scrollable SRP Panel Control. Unlike the SetForm method, which only allows one form to be embedded, you can call this method over and over again to add as many forms as you want. All you have to do is include a unique name of the form so you can identify it later.

Calling this method does not show the form. 

To show a form you have added, use the ActiveForm property.

The FitWidth and FitHeight parameters define the resizing behavior of the form. By default, the form's SIZE dimensions are used. So, if the form is bigger than the SRP Panel Control, then scroll bars appear which allow the user to scroll the form as desired. However, if you want the form to be autosized to fit the dimensions of the SRP Panel Control, set eiter of these flags to true. For example, if you set FitWidth to 1, then there will never be a horizontal scroll bar because the width of the form will always equal the width of the SRP Panel Control.

Example

// Add two windows to the form, then show the second one
NewWindow = Start_Window("MY_FIRST_WINDOW") 
Handle = Get_Property(NewWindow, "HANDLE") 
Send_Message(@Window:".OLE_PANEL", "OLE.AddNamedForm", Handle, "FORM_A", 1, 0)
NewWindow = Start_Window("MY_SECOND_WINDOW") 
Handle = Get_Property(NewWindow, "HANDLE") 
Send_Message(@Window:".OLE_PANEL", "OLE.AddNamedForm", Handle, "FORM_B", 1, 0)
Set_Property(@Window:".OLE_PANEL", "OLE.ActiveForm", "FORM_B")

See Also

ActiveForm, RemoveAllNamedForms, RemoveNamedForm

  • No labels