Carbon


TXNFocus

Header: MacTextEditor.h Carbon status: Supported

Makes the scroll bars and insertion point active for a TXNObject.

void TXNFocus (
    TXNObject iTXNObject, 
    Boolean iBecomingFocused
);
Parameter descriptions
iTXNObject

A variable of type TXNObject. Pass the text object you want to receive focus.

iBecomingFocused

A Boolean value. If set to true, the text object receives focus; its scroll bars and insertion point are active and text input appears at the insertion point. If set to false, the text object’s scroll bars and inserting point are inactive.

DISCUSSION

You can use this function in conjunction with the TXNActivate function to make scroll bars active while text input is not focused. This behavior is often desirable for windows with multiple text areas that are scrollable.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)