Progress
Language Reference


SENSITIVE Attribute

Indicates whether a widget can receive input focus or events. Indicates whether certain Progress objects can receive events.

Data Type: LOGICAL

Access: Readable/Writeable

Applies To: Browse, Button, Combo-box, Control-frame, Dialog-box, Editor, Field-group, Fill-in, Frame, Image, Literal, Menu, Menu-item, Radio-set, Rectangle, Selection-list, Slider, Sub-menu, Text, Toggle-box, Window Server-socket Object Handle, Socket Object Handle

For widgets, if the SENSITIVE attribute is TRUE, the user can give input focus to the widget or can select, move, or resize it (if other attributes are set). A field-level widget must be specified in a frame before you can set the SENSITIVE attribute. The ENABLE statement implicitly sets this attribute to TRUE, and the DISABLE statement sets it to FALSE.

If the READ-ONLY attribute is TRUE for the widget, the SENSITIVE attribute has no effect except to grey out the widget in some environments.

For the socket and server socket objects, the SENSITIVE attribute indicates whether the object can receive events. The default value of this attribute is TRUE for socket and server socket objects.

If the SENSITIVE attribute is set to FALSE for the socket object, Progress will not execute the READ-RESPONSE procedure for the socket even if the READ-RESPONSE event occurs.

If the SENSITIVE attribute is set to FALSE for the server socket object, Progress will stop accepting connections on the port associated with the server socket.

NOTE: If an application knows it will not receive data on a socket during some period of time, it should set this attribute to FALSE. This allows the application to run more efficiently since Progress does not monitor the socket if its SENSITIVE attribute is set to FALSE. Data can still be written to an insensitive socket object. When the attribute is set to TRUE, Progress checks the socket for data.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095