lsxECLWinMetrics Class

The lsxECLWinMetrics class performs operations on a connection window. It allows you to perform window rectangle and position manipulation (for example, SetWindowRect, Ypos or Width), as well as window state manipulation (for example, Visible or Restored).

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

There are three ways to create an lsxECLWinMetrics object:
  • Create a new lsxECLWinMetrics 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 lsxECLWinMetrics object that is associated with Personal Communications connection A:
    ' Create an lsxECLWinMetrics object associated with PCOMM connection A
    dim myWMetObj as new lsxECLWinMetrics("A")
  • Create a new lsxECLWinMetrics 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, lsxECLConnList Class and lsxECLConnection Class for more information on the properties and methods of those objects). The following is an example of creating an lsxECLWinMetrics object using a Personal Communications connection handle:
     dim myWMetObj as lsxECLWinMetrics
     dim myConnObj as new lsxECLConnection
     
     ' Create a new lsxECLWinMetrics object using a connection handle
      set myWMetObj = new
                     lsxECLWinMetrics(myConnObj.Handle)
  • Create an lsxECLSession object and an lsxECLWinMetrics object is automatically created. Access the lsxECLWinMetrics attribute to get to the lsxECLWinMetrics object contained in the lsxECLSession object. The following is an example of accessing the lsxECLWinMetrics object contained in an lsxECLSession object:
    dim myWMetObj as lsxECLWinMetrics
    dim mySessObj as lsxECLSession
     
    ' Create a new lsxECLSession object associated with PCOMM connection A
    set mySessObj = new lsxECLSession("A")
    ' Get the lsxECLWinMetrics object from the lsxECLSession object
    set myWMetObj = mySessObj.lsxECLWinMetrics