GUI ScreenIO for Windows

 ScreenIO.com


LowerCase

This API transforms data to lower case according to the rules of the alphabet in use on the workstation.  Because it is sensitive to foreign alphabets it will work properly with alphabets in all single-byte alphabet countries.

Client/Server issues

This API will convert data based on the country code/alphabet of the client.  If you want to use the setting on the server (which is much more efficient as there is no need to transfer the data to the client across the network) you can select this as follows:

     SET WIN32API-EXECUTE-API-ON-SERVER TO TRUE

Files

Files available to copy to your system:

Usage

     COPY WIN32API.
     COPY GSUPLOW.


     
* ------------------------: Call the API.

*
     MOVE my-source-data TO GSUL-DATA-TO-CONVERT
     SET API-LOWERCASE TO TRUE.
     SET GSUL-DATA-LENGTH TO LENGTH OF 
           GSUL-DATA-TO-CONVERT
     CALL 'GSWINAPI' USING WIN32API-PARMS
                           GSUL-DATA-LENGTH
                           GSUL-DATA-TO-CONVERT
                           WIN32API-C
                           WIN32API-D
                           WIN32API-E
                           WIN32API-F.

Parameters specific to this function

GSUL-DATA-LENGTH

This field specifies the length of the data you wish to convert.  Be sure to set it to the length of the third argument (GSUL-DATA-TO-CONVERT).  Setting this field too large can corrupt following field or lead to protection exceptions as the API will try to convert data for the full length specified in this field.

GSUL-DATA-TO-CONVERT

This field is provided for your convenience.  To use this field, move the data you wish to convert to this field, call the API, and then move the data back to your source field.  In this way, you can be assured that the data will not corrupt your storage.  (This does not relieve you of the responsibility of setting GSUL-DATA-LENGTH properly).

NOTE:  It may be more efficient and convenient to call this API with the actual data-name that you wish to convert substituted for the field GSUL-DATA-TO-CONVERT.  This is perfectly permissible as long as you set the length field properly.

WIN32API-PARMS - Used in all GSWINAPI calls

This argument is standard for all Calls to GSWINAPI. It is used to select the desired API or function, and to return the status of the operation.

WIN32API-RC

Used to return the status of a call to GSWINAPI.  A value of zero is a failure, any other value indicates success. 

The value returned, (if greater than zero) is the actual number of characters converted.

Recommended usage is to test the 88-level value WIN32API to see if it worked, then to use the text error message to see why it failed.

* ------------------------: If function failed,
*                         :   display the error in a message box.
*
     IF WIN32API-FAILED
       MOVE WIN32API-ERROR-TEXT TO panel-MESSAGE-TEXT
       SET panel-MESSAGE-IN-MESSAGEBOX TO TRUE.

WIN32API-ERROR-CODE

Error code that was returned by Windows.  This is not generally useful unless you have the Windows Platform SDK documentation available to you.

WIN32API-ERROR-TEXT

Plain-text error message that describes why the operation failed.

WIN32API-A through WIN32API-F

The number of these present varies depending on how many arguments are used by the desired function.  These are not used, but must be present because this CALL requires seven arguments.


2000-2006 Norcom, all rights reserved 

TOC

Send feedback to Norcom