Creates an Automation object.
[Ok :=] CREATE(Automation [,NewServer] [,OnClient])
A variable that has previously been declared.
If NewServer is false (the default), CREATE will try to reuse an already running instance of the automation server referenced by Automation before creating a new instance. If NewServer is true, CREATE will always create a new instance of the automation server.
If OnClient is false (the default), then the Automation object is created on the Microsoft Dynamics NAV Server. If OnClient is true, then the Automation object is created on the client.
This parameter is only valid when you run the function on the RoleTailored client. On the Classic client, the Automation object is always created on the client.
Property Value/Return Value
true if the Automation object could be created; otherwise, false.
If the return is not tested, execution will terminate with a run-time error.
CREATE creates (instantiates) the automation server referenced by the Automation variable. While an OCX (custom control) is instantiated implicitly, Automation variables must be created explicitly.
If you have an array of OCXs, each control will be created when its first member is accessed.
If you have an array of automation servers, you have to call
CREATE on each element individually. The
variable can be used independently on each element.
The automation object that is created can be explicitly destroyed by the. The object will be destroyed implicitly when the Automation variable goes out of scope.
An Automation variable can only be created once. You will get a run-time error if you try to create an Automation a second time, without calling CLEAR first. You will also get a run-time error if you try to create an OCX variable.