События

Работа с событиями в DroidScript происходит легко, что будет рассмотрено на примере компоновщика.

Компоновщики могут реагировать на действия пользователей. Для этого они имеют следующие методы:

В качестве единственного параметра в них задаётся функция обратного вызова (ФОВ), в которую, в зависимости от источника и вида события, могут передаваться или не передаваться параметры.

До версии DroidScript 1.42 в качестве функции обратного вызова callback в DroidScript для любого метода-обработчика можно было указать только название глобальной функции или имя глобальной функции в кавычках в качестве параметра метода eval:

Любые другие способы задания параметра callback, включая обращения к анонимным функциям, функциям-выражениям, функциям с параметрами и т.п. приводили к ошибке времени выполнения. Это создавало трудности, так как была невозможна явная передача параметров обработчику и приходилось создавать большое количество глобальных функций для каждого элемента управления.

Начиная с версии 1.42 в качестве обработчика событий можно указывать также анонимную функцию:

и функциональное выражение:

var myFunc = function(){ alert(); }

Если объект не имеет методов SetOnTouchDown, SetOnTouchMove и SetOnTouchUp, то при вызове ФОВ в метода SetOnTouch аргументы ей не передаются:

btn.SetOnTouch( AS );

function AS( t ){
alert( t ); // undefined
}

Если объект имеет методы SetOnTouchDown, SetOnTouchMove, SetOnTouchUp, то в случае использования вместе с ними метода SetOnTouch последний будет перехватывать события down, move, up, получая от системы объект события со следующими полями:

Скопируйте пример и посмотрите работу событий.

var _$_ = [];
_$_[ 'controls' ] = [];

function OnStart(){

var _layMain = (function(){
    
    	var _object = app.CreateLayout( "linear", "left, top, vertical, fillXY" );
        _object.SetBackColor( '#ff660000' );
        _object.SetOnTouch( touch );
        _object.SetOnLongTouch( touchLong );
        _object.SetOnTouchDown( touchDown );
        _object.SetOnTouchMove( touchMove );
        _object.SetOnTouchUp( touchUp );
        
        return _object;
        
    })();

var _txtTitle = (function(){
    
    	var _object = app.CreateText( "Событие", "Top" );
        _object.SetTextSize(16);
        
        return _object;
        
    })();

var _txeEvents = (function(){
    
    	var _object = app.CreateTextEdit( "", 0.5, 0.8, "readOnly, noKeyboard" );
        _object.SetTextSize( 14 );
        _object.SetBackColor( '#ff666666' );
        
        return _object;
        
    })();
    
    _layMain.AddChild( _txtTitle );
    _layMain.AddChild( _txeEvents );
    
    app.AddLayout( _layMain );

_$_[ 'controls' ] = _txeEvents;
    
}

function touch( ev ){
    
    var _txe = _$_[ 'controls' ];
    _txe.SetText( 
        _txe.GetText()+
        '\nКороткое прикосновение:' +
        '\nsource - '+ ev.source.GetType() +
        '\naction - '+ ev.action +
        '\ncount - '+ ev.count +
        '\nX - ' + ev.X +
        '\nY - ' + ev.Y +
        '\nx - ' + ev.x +
        '\ny - ' + ev.y +
        '\n---------------------'
        );
}

function touchLong( ev ){
    
    
    var _txe = _$_[ 'controls' ];
    _txe.SetText( _txe.GetText()+'\nДолгое прикосновение' );
}

function touchDown( ev ){

var _txe = _$_[ 'controls' ];
    _txe.SetText( 
        _txe.GetText()+
        '\nПрикосновение:' +
        '\nsource - '+ ev.source.GetType() +
        '\naction - '+ ev.action +
        '\ncount - '+ ev.count +
        '\nX - ' + ev.X +
        '\nY - ' + ev.Y +
        '\nx - ' + ev.x +
        '\ny - ' + ev.y +
        '\n---------------------'
        );
}

function touchMove( ev ){
    
    var _txe = _$_[ 'controls' ];
    _txe.SetText( 
        _txe.GetText()+
        '\nДвижение:' +
        '\nsource - '+ ev.source.GetType() +
        '\naction - '+ ev.action +
        '\ncount - '+ ev.count +
        '\nX - ' + ev.X +
        '\nY - ' + ev.Y +
        '\nx - ' + ev.x +
        '\ny - ' + ev.y +
        '\n---------------------'
        );
}

function touchUp( ev ){
    
    var _txe = _$_[ 'controls' ];
    _txe.SetText( 
        _txe.GetText()+
        '\nОтпускание:' +
        '\nsource - '+ ev.source.GetType() +
        '\naction - '+ ev.action +
        '\ncount - '+ ev.count +
        '\nX - ' + ev.X +
        '\nY - ' + ev.Y +
        '\nx - ' + ev.x +
        '\ny - ' + ev.y +
        '\n---------------------'
        );
}

В этом примере определены обработчики SetOnTouchDown, SetOnTouchMove, SetOnTouchUp, но их вызов не производится из-за перехвата всех событий обработчиком SetOnTouch.

Для группировки реакции на события от многих объектов можно использовать функцию роутера событий, как это показано в примере ниже.

Выполнить

В этом примере каждому объекту добавлено по два свойства - параметр и действие, благодаря которым в роутере можно определить источник события и вызвать для него требуемон действие.

При использовании функции-роутера событий необходимо проверять входные параметры. Без данной проверки возможны ошибки, так как в одних случаях аргумент будет объектом, в других строкой или числом, а в третьих аргумента вообще не будет.

При помощи опции конструктора компоновщика TouchThrough ему можно запретить захват событий. В этом случае события будут проходить сквозь него, что позволит создать многослойный интерфейс путем наложения компоновщиков друг на друга и обработки событий на нижних слоях.