Note: This is a work in progress and many formatting issues have been fixed. Read more about the project on the home page.

lockText

set [the] lockText of field to trueOrFalse

The lockText property returns or sets whether the user can edit the text within a specified field. It corresponds to the Lock Text check box in a Field Info dialog box. The default value is false (meaning the field is unlocked).

When a field is locked, it can receive the system messages mouseDown, mouseDoubleClick, mouseStillDown, and mouseUp when the user clicks it.

Before a field can act as a list field, its lockText property must be set to true.

Examples

set the lockText of card field 1 to true

set the lockText of the target to false -- if the target is a field

set the lockText of me to true -- if in a field script

Placeholders

field

An expression that identifies a field by name, number, or id using one of the following forms (in AppleScript, use “background” in place of “bkgnd”):

card field id posInteger [[of] card]

card field text [of card] -- name

card field posInteger [of card]

ordinal card field [of card]

[bkgnd] field id posInteger [of card]

[bkgnd] field text [of card] -- name

[bkgnd] field posInteger [of card]

ordinal [bkgnd] field [of card]

For example:

card field id 3894

card field "My Notes"

card field 1

first card field

background field 3 of card 1

When used inside a field script in HyperTalk: `me`

When a field receives a message: `[the] target`

A field can also be referred to as a part when you’re talking about its position among all buttons and fields within the same card or background.

`trueOrFalse`

Any expression that evaluates to the HyperTalk and AppleScript constants true or false.

For example:

true

false

the hilite of bg btn "Yes"

fld "Zip" contains "95014"

the short name of this stack is "Fred"


    
      
                HyperTalk Reference


    
      
        
        
                        address
                            autoHilite
                            autoSelect
                            autoTab
                            blindTyping
                            bottom
                            bottomRight
                            brush
                            cantAbort
                            cantDelete
                            cantModify
                            cantPeek
                            centered
                            checkMark
                            commandChar
                            cursor
                            debugger
                            dialingTime
                            dialingVolume
                            dontSearch
                            dontWrap
                            dragSpeed
                            editBkgnd
                            enabled
                            environment
                            family
                            filled
                            fixedLineHeight
                            freeSize
                            grid
                            height
                            hilite
                            icon
                            ID 
                            itemDelimiter
                            language
                            left
                            lineSize
                            location
                            lockErrorDialogs
                            lockMessages
                            lockRecent
                            lockScreen
              lockText
              longWindowTitles
                            markChar
                            marked
                            menuMessage
                            messageWatcher
                            multiple
                            multipleLines
                            multiSpace
                            name
                            number (property)
                            numberFormat
                            owner
                            partNumber
                            pattern
                            polySides
                            powerKeys
                            printMargins
                            printTextAlign
                            printTextFont
                            printTextHeight
                            printTextSize
                            printTextStyle
                            rectangle
                            reportTemplates
                            right
                            script
                            scriptEditor
                            scriptingLanguage
                            scriptTextFont
                            scriptTextSize
                            scroll
                            sharedHilite
                            sharedText
                            showLines
                            showName
                            showPict
                            size
                            stacksInUse
                            style
                            suspended
                            textAlign
                            textArrows
                            textFont
                            textHeight
                            textSize
                            textStyle
                            titleWidth
                            top
                            topLeft
                            traceDelay
                            userLevel
                            userModify
                            variableWatcher
                            version
                            visible
                            wideMargins
                            width
                            zoomed

lockText

Examples

Related Topics

Placeholders

field

trueOrFalse

`trueOrFalse`