lsxECLPS Class

The lsxECLPS class performs operations on a connection’s presentation space.

The lsxECLPS object is associated with a Personal Communications connection when the lsxECLPS object is created. You cannot change the connection that is associated with an lsxECLPS object. If you want to manipulate the presentation space of a different connection, you must create a new lsxECLPS object associated with that connection.

There are three ways to create an lsxECLPS object:
  1. Create a new lsxECLPS object by passing a Personal Communications connection name as a parameter on the new statement. A Personal Communications connection name is a single, alphabetic character from A-Z or a-z. The following is an example of creating an lsxECLPS object that is associated with Personal Communications connection A:
    ' Create an lsxECLPS object associated with PCOMM connection A
    dim myPSObj as new lsxECLPS("A")
  2. Create a new lsxECLPS object by passing a Personal Communications connection handle as a parameter on the new statement. A Personal Communications connection handle is a long integer and is usually obtained by querying the lsxECLConnection object corresponding to the target Personal Communications connection (see lsxECLConnMgr Class and lsxECLConnection Class for more information on the properties and methods of those objects). The following is an example of creating an lsxECLPS object using a Personal Communications connection handle:
     dim myPSObj as lsxECLPS
     dim myCMgrObj as new lsxECLConnMgr
     
    ' Create a new lsxECLPS object associated with the first PCOMM connection
    ' found in lsxECLConnList
     set myPSObj = new lsxECLPS(myCMgrObj.lsxECLConnList(1).Handle)
  3. Create an lsxECLSession object and an lsxECLPS object is automatically created. Access the lsxECLPS attribute to get to the lsxECLPS object contained in the lsxECLSession object. The following is an example of accessing the lsxECLPS object contained in an lsxECLSession object:
    dim myPSObj as lsxECLPS
    dim mySessionObj as lsxECLSession
     
    ' Create a new lsxECLSession object associated with PCOMM connection A
    set mySessionObj = new lsxECLSession("A")
    ' Get the lsxECLPS object from the lsxECLSession object
    set myPSObj = mySessionObj.lsxECLPS
Note:
In the presentation space, the first row coordinate is row 1 and the first column coordinate is column 1. Therefore, the top, left position has a coordinate of row 1, column 1.