webInputType

Type: Character

Availability: Read or write at any time

The webInputType property of a TextBox control contains the type of input that is accepted by a text box on a Web page.

You can assign the webInputType property to each text box on a Web page.

The types of input that can be accepted are listed in the following table.

TextBox Class Constant Value Description
Web_InputType_File 'F' Uploading a file from a Web session
Web_InputType_Hidden 'H' Specifies whether the text box is displayed on a Web page (see the enabled property)
Web_InputType_Password 'P' Specifies whether characters are displayed in a text box (see the passwordField property)
Web_InputType_Text 'T' Single line text box (the default)
Web_InputType_TextArea 'A' Multiple line text box

If your JADE application accepts file input in text boxes on a Web page (by using the webInputType property of a TextBox control with the Web_InputType_File setting to upload a file from a Web session), you can use the fileTransferDirectory parameter in the [Jadehttp Files] section of the jadehttp.ini file to specify the directory to which the file is written. This parameter controls the directory in which any files transferred using the HTML InputType=file option are placed. By default, any transferred files are placed in the same directory as the jadehttp library.

The format of the text property value of the text box control is:

<source-file-name>;<destination-file-path><destination-file-name>

The source-file-name value is the name (excluding the path) of the originating file on the client workstation from which the file was loaded (that is, the workstation that is running the Web browser).

A semicolon character (;) separates this and the destination-file-path and destination-file-name values, which are the full path to which the file is written (uploaded) and the name of that file; for example:

UsefulStuff.doc;d:\jade\bin\txf188.tmp

In this example, accessing the txf188.tmp file in the specified directory opens a document file that contains the information in the UsefulStuff.doc file uploaded via the Web browser.

To provide increased security for applications running in HTML thin client mode if you use the webInputType property of a TextBox control with the Web_InputType_File setting to upload a file from a Web session, you must process each text file that is transferred in the event that resulted in the file upload (for example, in the click method of a Completed button).

To prevent malicious use of files uploaded to Web-enabled applications, the files are removed as soon as the event that resulted in their upload has completed. You should therefore process the file immediately or move it into a directory that is not available from the Web if you require that file for future processing.