event.phase

概述

一个 字符串，用于标识事件在 userInput 序列中发生的位置。可以是以下值之一：

• "began" — 在设备上，这是“键盘已出现”事件；根据您的界面设计，您可能需要在键盘出现时调整屏幕内容。在桌面应用程序中，当字段获得焦点时会发生此事件，例如当用户在其中单击时。

• "ended" — 当文本字段/框失去焦点时发送此事件，例如当用户触摸其他字段或隐藏键盘时。

• "submitted" — 对于 TextField 对象，当用户按下“回车”键完成编辑时，会触发此事件。这不适用于 TextBox 对象，因为按下“回车”键会添加新行。

• "editing" — 当用户在字段中键入或修改文本时会发生此事件。在此阶段，event 表中还存在其他几个键（有关完整列表，请参阅 userInput 文档）。

示例

local defaultField

local function textListener( event )

    if ( event.phase == "began" ) then
        -- User begins editing "defaultField"

    elseif ( event.phase == "ended" or event.phase == "submitted" ) then
        -- Output resulting text from "defaultField"
        print( event.target.text )

    elseif ( event.phase == "editing" ) then
        print( event.newCharacters )
        print( event.oldText )
        print( event.startPosition )
        print( event.text )
    end
end

-- Create text field
defaultField = native.newTextField( 150, 150, 180, 30 )
defaultField:addEventListener( "userInput", textListener )