Admin Production rocket
Current Publication

CreateControl(String) Method

Reflection Desktop .NET API Guide V17.1
Rocket® Reflection Desktop (formerly a product of Micro Focus or formerly a product of Open Text) documentation that was created prior to Rocket Software's acquisition of certain products from OpenText may contain outdated references to "Micro Focus” or “OpenText”, which are trademarks of OpenText. Rocket Software is not affiliated with Micro Focus or OpenText and has rebranded these products as Rocket® products.
The session path.
CreateControl(String) Method
In This Topic
Creates a control from a saved session file. The method returns a control instantiated from a previously saved session file.
Syntax

                     
                     
'Declaration
 

                     
                     
Public Overloads Function CreateControl( _
   ByVal sessionFilePath As String _
) As Object

                  

                     
                     
'Usage
 

                     
                     
Dim instance As Application
Dim sessionFilePath As String
Dim value As Object
 
value = instance.CreateControl(sessionFilePath)

                  

                     
                     
public object CreateControl( 
   string sessionFilePath
)

                  

Parameters

sessionFilePath
The session path.

Return Value

Created control.
Exceptions
Exception Description
API Service has not been initialized.
Example

using System;
using System.Collections.Generic;
using System.Text;
using Attachmate.Reflection.Framework;
using Attachmate.Reflection.Emulation.IbmHosts;
using Attachmate.Reflection.UserInterface;

namespace OpenASession
{
    class Program
    {
        static void Main(string[] args)
        {
            //Start a visible instance of Reflection or get the instance running at the given channel name
            Application app = MyReflection.CreateApplication("myWorkspace", true);

            //Create a terminal from the session document file
            string sessionPath = Environment.GetEnvironmentVariable("USERPROFILE") + @"\Documents\Micro Focus\Reflection\gettingStarted.rd3x";
            IIbmTerminal terminal = (IIbmTerminal)app.CreateControl(sessionPath);

            //Make the session visible in the workspace
            IFrame frame = (IFrame)app.GetObject("Frame");
            frame.CreateView(terminal);
        }
    }
}  
                                 

                                        
See Also