Usage Notes

Because ECLPageSettings is derived from ECLConnection, you can obtain all the information contained in an ECLConnection object. See ECLConnection Class for more information.

The ECLPageSettings object is created for the connection identified upon construction. You can create an ECLPageSettings object by passing the connection ID (a single alphabetical character from A to Z) or the connection handle (usually obtained from the ECLConnection object). There can be only one Z and I Emulator for Windows connection with a given name or handle open at one time.

The ECLSession class creates an instance of this object. If the application does not need other services provided by ECLSession, you can create this object independently. Otherwise, consider creating an ECLSession object and use the objects created by ECLSession. See ECLSession Class for more information.

Each method supports only certain connection types of the connection associated with the ECLPageSettings object. The supported connection types are provided in each method section. If a method is called on an unsupported connection, an exception is thrown. Use the method GetConnType to determine the connection type.

CPI, LPI and FontSize are dependent on the property FaceName. Therefore, if CPI, LPI, and FontSize are set before the FaceName is set, and if the values are not valid for the FaceName property, then different CPI, LPI, or FontSize values might be reconfigured in the connection. You should set the FaceName value before setting the CPI, LPI, or FontSize. Or you can query CPI, LPI, and FontSize each time you set FaceName to ensure that they use the desired values.