TouchEvent  - AS3

Alt tuşunun etkin mi (true) yoksa devre dışı mı (false) olduğunu belirtir. Yalnızca Windows ve Linux işletim sistemleri için desteklenir.

Command tuşunun etkin olup olmadığını gösterir (yalnızca Mac'te).

Mac OS'de, commandKey özelliğinin değeri, ctrlKey özelliğinin değeriyle aynıdır. Bu özellik Windows veya Linux'ta her zaman false olur.

Mac'te Control tuşunun etkin olup olmadığını, Windows veya Linux'ta Ctrl tuşunun etkin olup olmadığını belirtir.

Windows veya Linux'ta Ctrl tuşunun etkin olup (true) olmadığını (false) gösterir. Macintosh'ta, Ctrl tuşunun veya Command tuşunun etkin olup olmadığını belirtir.

Birinci temas noktasının fare olaylarına eşlenip eşlenmediğini belirtir.

İlgili API Öğeleri

true olursa, relatedObject özelliği, güvenlik sanal alanlarıyla ilgili nedenlerden dolayı null değerine ayarlanır. relatedObject öğesinin nominal değeri, başka bir güvenlik sanal alanındaki DisplayObject öğesine başvuruysa, bu sanal alan sınırı içinde her iki yönde de izin olmadığı sürece relatedObject öğesi null değerine ayarlanır. Bir SWF dosyasından Security.allowDomain() öğesi çağrılarak veya bir görüntü dosyası sunucusundan ilke dosyası sağlanarak ve görüntü yüklenirken LoaderContext.checkPolicyFile özelliği ayarlanarak izin oluşturulur.

İlgili API Öğeleri

Bu dokunma girdisi sırasının işletim sistemi tarafından iptal edildiğini bildirir.

Dokunma olayları çeşitli nedenlerden dolayı iptal edilebilir (örn. bir kalem stilusu kullanımda olduğundan avuç içinin meydana getirdiği bir dokunmanın reddedilmesi). isTouchPointCanceled, yalnızca bir touchEnd olayında true olabilir.

Olayın kapsayan hareket grafiğine göre gerçekleştiği yatay koordinat.

Olayın kapsayan hareket grafiğine göre gerçekleştiği dikey koordinat.

Aygıtla temas şiddetini belirten, 0.0 ile 1.0 arasında bir değer. Aygıt basıncın algılanmasını desteklemiyorsa, değer 1.0 olur.

Olay ile ilgili bir ekran listesi nesnesine bir başvuru. Örneğin bir touchOut olayı oluştuğunda, relatedObject, işaretleme aygıtının şimdi işaret ettiği görüntüleme listesi nesnesini temsil eder. Bu özellik, touchOut, touchOver, touchRollOut ve touchRollOver olayları için geçerlidir.

Bu özelliğin değeri, iki durumda null olabilir: ilgili bir nesne yoksa veya bir ilgili nesne varsa ancak bu sizin erişemediğiniz bir güvenlik sanal alanındaysa. Bu nedenlerden hangisinin geçerli olduğunu belirlemek için isRelatedObjectInaccessible() özelliğini kullanın.

İlgili API Öğeleri

Shift tuşunun etkin mi (true) yoksa devre dışı mı (false) olduğunu belirtir.

Temas alanının genişliği.

Temas alanının yüksekliği.

Olayın global Sahne Alanı koordinatlarında gerçekleştiği yatay koordinat. Bu özellik, localX özelliği ayarlandığında hesaplanır.

Olayın global Sahne Alanı koordinatlarında gerçekleştiği dikey koordinat. Bu özellik, localY özelliği ayarlandığında hesaplanır.

Olayın zamanını milisaniyelere göre bildirir.

Bildirilen zamanlar uygulamanın çalışmaya başladığı zamana göredir. Örnekler arabelleğinde bir noktalar sırası döndüren olaylar için bu zaman damgası, arabellekteki son örnek için geçen zamanı yansıtır.

İlgili API Öğeleri

Dokunmanın, bir stilusun ana ucu veya silgi ucu tarafından meydana getirildiğini bildirir.

Bir dokunma olayı, parmak veya diğer stilus olmayan girdi yöntemleri veya yüksek frekanslı hareket takibinin desteklenmediği bir stilus tarafından meydana getiriliyorsa bu özellik TouchEventIntent.UNKNOWN değerini bildirir.

TouchEventIntent sınıfı, bu özelliğe ait olası değerler için aşağıdaki sabitleri tanımlar:

• TouchEventIntent.ERASER
• TouchEventIntent.PEN
• TouchEventIntent.UNKNOWN

İlgili API Öğeleri

Dokunma noktasına atanmış benzersiz bir tanımlama numarası (int olarak).

Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; 

var mySprite:Sprite = new Sprite(); 
mySprite.graphics.beginFill(0x336699); 
mySprite.graphics.drawRect(0,0,40,40); 
addChild(mySprite); 

var myTextField:TextField = new TextField(); 
addChild(myTextField); 
myTextField.width = 200; 
myTextField.height = 20; 

var touchMoveID:int = 0; 
 
mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); 
function onTouchBegin(event:TouchEvent) { 
    if(touchMoveID != 0) { 
        myTextField.text = "already moving. ignoring new touch";     
        return; 
    } 
    touchMoveID = event.touchPointID; 
 
    myTextField.text = "touch begin" + event.touchPointID; 
    stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
} 
function onTouchMove(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch"; 
        return; 
    } 
    mySprite.x = event.stageX; 
    mySprite.y = event.stageY; 
    myTextField.text = "touch move" + event.touchPointID; 
} 
function onTouchEnd(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch end"; 
        return; 
    } 
    touchMoveID = 0; 
    stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
    myTextField.text = "touch end" + event.touchPointID; 
}

Dokunma olayları hakkındaki bilgileri içeren bir Event nesnesi oluşturur. Event nesneleri, olay dinleyicilerine parametre olarak iletilir.

TouchEvent nesnesinin bir kopyasını oluşturur ve her özelliğin değerini, orijinal ile aynı olacak şekilde ayarlar.

Belirtilen ByteArray nesnesini, çok noktalı bir dokunma olayı için yüksek frekanslı verilerle günceller.

buffer parametresinin başvurduğu ByteArray nesnesi bu ve bundan önceki dokunma olayı arasındaki veri noktalarına ait değerlerle güncellenir. Her bir örnek için üçer kayar nokta değeri eklenir: bir x koordinatı, a y koordinatı ve basınç değeri. Sahne koordinatlarında bildirilen konum değerleri. Basınç, 0 ile 1 arasında bir değer olarak bildirilir. Örnekler, düzenli zaman aralıklarıyla kaydedilir. Tam frekans, aygıt donanımı ve donanım sürücülerine bağlıdır. Genel örnek frekansları yaklaşık 133 Hz'dir. Dokunma olaylarının tam aralıklarla gönderilmediğini unutmayın. Benzer olaylar için arabellek, farklı örnek sayıları içerebilir. Arabellekteki son örnek, bu dokunma olayı nesnesinin stageX, stageY ve pressure özellikleriyle aynı verileri içerir.

Bir örnek arabelleği, proximityMove ve touchMove olayları için gönderilen olay nesnelerinde yer alır.

Parametreler

İlgili API Öğeleri

function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var samples:ByteArray = new ByteArray();
        event.getSamples( samples, true );
        samples.position = 0;     // rewind to beginning of array before reading
        
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        while( samples.bytesAvailable > 0 )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

var samples:ByteArray = new ByteArray();

function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var sampleCount:uint = event.getSamples( samples, true );         
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        for( var i:int; i < sampleCount; i++ )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

Belirtilen dizindeki donanım düğmesine basıldığını bildirir.

Parametreler

TouchEvent nesnesinin tüm özelliklerini içeren bir dize döndürür. Dize şu biçimdedir:

[TouchEvent type=value bubbles=value cancelable=value ... ]

Flash Player veya Adobe AIR'i, bu olayın işlenmesi tamamlandıktan sonra ekran değişmişse ekranı oluşturmaya yönlendirir.

Bir PROXIMITY_BEGIN dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_END dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_MOVE dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_OUT dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_OVER dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_ROLL_OUT dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir PROXIMITY_ROLL_OVER dokunma olayı nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_BEGIN dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_END dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_MOVE dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_OUT dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_OVER dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_ROLL_OUT dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_ROLL_OVER dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Bir TOUCH_TAP dokunma olay nesnesinin type özelliği değerini tanımlar.

Gönderilen TouchEvent nesnesi şu özelliklere sahiptir:

İlgili API Öğeleri

Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;

var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();

mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);

mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);

function taphandler(e:TouchEvent): void {
    myTextField.text = "I've been tapped";
    myTextField.y = 50;
    addChild(myTextField);
}