Paket | flash.display |
Sınıf | public class Stage |
Miras Alma | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tarayıcıda çalışan SWF içeriği için (Flash® Player'da) Sahne Alanı, Flash içeriğinin gösterildiği alanın tamamını temsil eder. Masaüstü işletim sistemlerinde AIR'de çalışan içerik için, her NativeWindow nesnesi, karşılık gelen bir Stage nesnesine sahiptir.
Stage nesnesi global olarak erişilemez. Bu öğeye DisplayObject örneğinin stage
özelliği aracılığıyla erişmeniz gerekir.
Stage sınıfında, bu sınıfın özellikleri ve yöntemleri miras aldığı bir çok üst sınıf bulunur: DisplayObjectContainer, InteractiveObject, DisplayObject, ve EventDispatcher. Bu özelliklerin ve yöntemlerin bir çoğu, Stage nesnelerine uygulanamaz veya Stage nesnesi üzerinde çağrıldığında güvenlik kontrolleri gerektirir. Güvenlik kontrolleri gerektiren özellikler ve yöntemler Stage sınıfının bir parçası olarak belgelendirilir.
Ayrıca, şu miras alınan özellikler Stage nesnelerine uygulanamaz. Bunları ayarlamaya çalıştığınızda IllegalOperationError atılır. Bu özellikler her zaman okunabilir, ancak ayarlanamadığı için her zaman varsayılan değerler içerir.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
enterFrame
, exitFrame
, frameConstructed
ve render
gibi olayların kullanıldığı her durumda Stage nesnesine bir başvurunun var olması garanti edilemediği için Stage sınıfının bir parçası olmasını beklediğiniz bu olaylar, Stage olayları olamaz. Bu olaylar Stage nesnesi tarafından gönderilemediği için, onun yerine DisplayObject örnekleri tarafından tek tek gönderilir; başka bir deyişle, bu olayları dinlemek için herhangi bir DisplayObject örneğine bir olay dinleyicisi ekleyebilirsiniz. DisplayObject sınıfının parçası olan bu olaylar, kendilerinin belirli bir DisplayObject örneğini hedefleyen olaylardan ayırt edilmesi için broadcast olayları olarak adlandırılır. Diğer iki yayınlama olayı, activate
ve deactivate
, DisplayObject üst sınıfı olan EventDispatcher öğesine aittir. activate
ve deactivate
olaylarının tüm DisplayObject örnekleri tarafından gönderilmesinin yanı sıra aynı zamanda tüm EventDispatcher örnekleri ve diğer EventDispatcher alt sınıflarının örnekleri tarafından da gönderilmesi hariç, bu olaylar DisplayObject broadcast olaylarına benzer davranış gösterir. broadcast olayları hakkında daha fazla bilgi için bkz. DisplayObject sınıfı.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
Bu InteractiveObject örneği için geçerli erişilebilirlik uygulaması (AccessibilityImplementation). | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Bu görüntüleme nesnesi için geçerli erişilebilirlik seçenekleri. | DisplayObject | ||
align : String
Flash Player'da veya tarayıcıda sahne alanının hizalamasını belirten bir StageAlign sınıfı değeri. | Stage | ||
allowsFullScreen : Boolean [salt okunur]
Bu sahne alanının, tam ekran modunun kullanımına izin verip vermediğini belirtir.
| Stage | ||
allowsFullScreenInteractive : Boolean [salt okunur]
Bu sahne alanının, metin giriş moduyla birlikte tam ekran modunun kullanımına izin verip vermeyeceğini belirtir
| Stage | ||
alpha : Number
Belirtilen nesnenin alfa saydamlık değerini gösterir. | DisplayObject | ||
autoOrients : Boolean
Aygıt yönlendirmesi değiştiğinde sahne alanının otomatik olarak değiştirilip değiştirilmediğini belirtir. | Stage | ||
blendMode : String
Hangi karışım modunun kullanılacağını belirten bir BlendMode sınıfı değeri. | DisplayObject | ||
blendShader : Shader [salt yazılır]
Ön planı ve arka planı karıştırmak için kullanılacak bir gölgelendirici ayarlar. | DisplayObject | ||
browserZoomFactor : Number [salt okunur]
Tarayıcı yakınlaştırma faktörünü belirtir. | Stage | ||
cacheAsBitmap : Boolean
true olarak ayarlanırsa, Flash çalışma zamanları, görüntüleme nesnesinin dahili bir bitmap temsilini önbelleğe alır. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Bu Matrix nesnesi null olmazsa, görüntüleme nesnesinin cacheAsBitmap true olarak ayarlandığı zaman nasıl oluşturacağını tanımlar. | DisplayObject | ||
color : uint
SWF arka plan rengi. | Stage | ||
colorCorrection : String
Görüntüler için Flash çalışma zamanı renk düzeltmesini denetler. | Stage | ||
colorCorrectionSupport : String [salt okunur]
Flash çalışma zamanının renk düzeltmesini destekleyen bir işletim sisteminde çalışıp çalışmadığını ve ana (birincil) monitördeki renk profilinin Flash çalışma zamanı tarafından okunup anlaşılabilir olup olmadığını belirtir. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [salt okunur]
Sahne alanının etkili piksel ölçekleme faktörünü belirtir | Stage | ||
contextMenu : NativeMenu
Bu nesneyle ilişkilendirilen bağlam menüsünü belirtir. | InteractiveObject | ||
deviceOrientation : String [salt okunur]
Aygıtın fiziksel yönlendirmesi. | Stage | ||
displayState : String
Hangi görüntüleme durumunun kullanılacağını belirten bir StageDisplayState sınıfı değeri. | Stage | ||
doubleClickEnabled : Boolean
Nesnenin doubleClick olaylarını alıp almadığını belirtir. | InteractiveObject | ||
filters : Array
Geçerli olarak görüntüleme nesnesiyle ilişkilendirilmiş her filtre nesnesini içeren dizinli bir dizi. | DisplayObject | ||
focus : InteractiveObject
Klavye odaklı etkileşimli nesne; veya odak ayarlanmadıysa ya da odaktaki nesne, çağıran nesnenin erişime sahip olmadığı güvenlik sanal alanına aitse null. | Stage | ||
focusRect : Object
Bu nesnenin bir odak dikdörtgeni görüntüleyip görüntülemediğini belirtir. | InteractiveObject | ||
frameRate : Number
Sahne alanının kare hızını alır ve ayarlar. | Stage | ||
fullScreenHeight : uint [salt okunur]
Tam ekran boyutuna hemen girilirse, bu duruma geçerken kullanılacak monitör yüksekliğine geri döner. | Stage | ||
fullScreenSourceRect : Rectangle
Flash çalışma zamanını, sahne alanının belirli bir bölgesini tam ekran moduna ölçekleyecek şekilde ayarlar. | Stage | ||
fullScreenWidth : uint [salt okunur]
Tam ekran boyutuna hemen girilirse, bu duruma geçerken kullanılacak monitör genişliğine geri döner. | Stage | ||
height : Number [geçersiz kıl]
Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. | Stage | ||
loaderInfo : LoaderInfo [salt okunur]
Bu görüntüleme nesnesinin ait olduğu dosyayı yükleme hakkında bilgi içeren bir LoaderInfo nesnesi döndürür. | DisplayObject | ||
mask : DisplayObject
Çağıran görüntüleme nesnesi belirtilen mask nesnesiyle maskelenir. | DisplayObject | ||
metaData : Object
Meta veri SWF dosyasında PlaceObject4 aracılığıyla söz konusu DisplayObject örneğinin yanında depolanmışsa, DisplayObject örneğinin meta veri nesnesini alır. | DisplayObject | ||
mouseChildren : Boolean [geçersiz kıl]
Nesnenin alt öğelerinin, fare veya kullanıcı girdi aygıtı etkin olduğunu belirtir. | Stage | ||
mouseEnabled : Boolean
Bu nesnenin fare veya diğer kullanıcı girdisi iletileri alıp almadığını belirtir. | InteractiveObject | ||
mouseLock : Boolean
Fare kilidini etkinleştirmek için true olarak ayarlayın. | Stage | ||
mouseX : Number [salt okunur]
Farenin veya kullanıcı girdi aygıtı konumunun x koordinatını piksel olarak belirtir. | DisplayObject | ||
mouseY : Number [salt okunur]
Farenin veya kullanıcı girdi aygıtı konumunun y koordinatını piksel olarak belirtir. | DisplayObject | ||
name : String
DisplayObject öğesinin örnek adını belirtir. | DisplayObject | ||
nativeWindow : NativeWindow [salt okunur]
Bu Stage öğesini içeren NativeWindow nesnesi başvurusu. | Stage | ||
needsSoftKeyboard : Boolean
Bu InteractiveObject örneği odak aldığında sanal bir klavyenin (ekrandaki yazılım klavyesi) görüntülenip görüntülenmemesi gerektiğini belirtir. | InteractiveObject | ||
numChildren : int [geçersiz kıl] [salt okunur]
Bu nesnenin alt öğelerinin sayısını döndürür. | Stage | ||
opaqueBackground : Object
Görüntüleme nesnesinin belirli bir arka plan rengiyle opak olup olmadığını belirtir. | DisplayObject | ||
orientation : String [salt okunur]
Sahne alanının geçerli yönlendirmesi. | Stage | ||
parent : DisplayObjectContainer [salt okunur]
Bu görüntüleme nesnesini içeren DisplayObjectContainer nesnesini belirtir. | DisplayObject | ||
quality : String
Hangi oluşturma kalitesinin kullanıldığını belirten bir StageQuality sınıfı değeri. | Stage | ||
root : DisplayObject [salt okunur]
Yüklü bir SWF dosyasındaki bir görüntüleme nesnesi için root özelliği, görüntüleme listesi ağaç yapısının o SWF dosyası tarafından temsil edilen kısmındaki en üst görüntüleme nesnesidir. | DisplayObject | ||
rotation : Number
DisplayObject örneğinin başlangıç yönlendirmesinden itibaren döndürülmesini derece olarak belirtir. | DisplayObject | ||
rotationX : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren x ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | ||
rotationY : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren y ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | ||
rotationZ : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren z ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | ||
scale9Grid : Rectangle
Etkin durumdaki geçerli ölçekleme ızgarası. | DisplayObject | ||
scaleMode : String
Hangi ölçek modunun kullanılacağını belirten bir StageScaleMode sınıfı değeri. | Stage | ||
scaleX : Number
Nesnenin, kayıt noktasından itibaren uygulandığı haliyle yatay ölçeğini (percentage) belirtir. | DisplayObject | ||
scaleY : Number
Nesnenin kayıt noktasından itibaren uygulandığı haliyle nesnenin dikey ölçeğini (percentage) belirtir. | DisplayObject | ||
scaleZ : Number
Nesnenin kayıt noktasından itibaren uygulandığı haliyle nesnenin derinlik ölçeğini (percentage) belirtir. | DisplayObject | ||
scrollRect : Rectangle
Görüntüleme nesnesinin kaydırma dikdörtgeni sınırları. | DisplayObject | ||
showDefaultContextMenu : Boolean
Flash çalışma zamanı bağlam menüsünde varsayılan öğelerin gösterileceğini veya gizleneceğini belirtir. | Stage | ||
softKeyboard : String
Yazılım klavyesinin görünümünü kontrol eder. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Yazılım klavyesi görüntülendiğinde ekranda kalması gereken alanı belirtir (iOS'ta kullanılabilir değildir) | InteractiveObject | ||
softKeyboardRect : Rectangle [salt okunur]
Geçerli olarak bir sanal klavyeyle kaplanan, sahne alanını belirten bir Dikdörtgen. | Stage | ||
stage : Stage [salt okunur]
Görüntüleme nesnesinin Sahne Alanı. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [salt okunur]
3 boyutlu içeriği görüntülemek için kullanılabilen Stage3D nesnelerinin listesi. | Stage | ||
stageFocusRect : Boolean
Nesnelerin odakta olduklarında ışıyan bir kenarlık görüntüleyip görüntülemeyeceğini belirtir. | Stage | ||
stageHeight : int
Sahne Alanı'nın piksel olarak geçerli yüksekliği. | Stage | ||
stageVideos : Vector.<StageVideo> [salt okunur]
Harici videoları oynatmak için kullanılabilen StageVideo nesnelerinin listesi. | Stage | ||
stageWidth : int
Sahne Alanı'nın geçerli genişliğini piksel olarak belirtir. | Stage | ||
supportedOrientations : Vector.<String> [salt okunur]
Geçerli aygıt tarafından desteklenen yönlendirmeler. | Stage | ||
supportsOrientationChange : Boolean [statik] [salt okunur]
Uygulamanın sahne alanı yönlendirmesindeki (ve aygıt döndürmesindeki) değişikleri destekleyip desteklemediği. | Stage | ||
tabChildren : Boolean [geçersiz kıl]
Nesnenin alt öğelerinin sekme tuşuna tepki verip vermediğini belirler. | Stage | ||
tabEnabled : Boolean
Bu nesnenin sekme sırasında olup olmadığını belirtir. | InteractiveObject | ||
tabIndex : int
SWF dosyasındaki nesnelerin sekme sıralamasını belirtir. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [geçersiz kıl] [salt okunur]
Bu DisplayObjectContainer örneği için bir TextSnapshot nesnesi döndürür. | Stage | ||
transform : flash.geom:Transform
Bir görüntüleme nesnesinin matrisi, renk dönüşümü ve piksel sınırları ile ilgili özellikleri olan bir nesne. | DisplayObject | ||
visible : Boolean
Görüntüleme nesnesinin görünür olup olmadığı. | DisplayObject | ||
vsyncEnabled : Boolean
Bu, temel alınan grafik çözümünün geçerli vsync durumunu temsil eder. Sonraki VSYNC durumu için beklemeden hemen oluşturabilmek için vsync seçeneğini etkinleştirebilir/devre dışı bırakabiliriz. | Stage | ||
width : Number [geçersiz kıl]
Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. | Stage | ||
wmodeGPU : Boolean [salt okunur]
GPU bileşiminin kullanılabilir ve kullanımda olup olmadığını belirtir. | Stage | ||
x : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre x koordinatını belirtir. | DisplayObject | ||
y : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre y koordinatını belirtir. | DisplayObject | ||
z : Number
3B üst kabına göre DisplayObject örneğinin z ekseni boyunca z koordinatı konumunu belirtir. | DisplayObject |
Yöntem | Tanımlayan: | ||
---|---|---|---|
[geçersiz kıl]
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. | Stage | ||
[geçersiz kıl]
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. | Stage | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [geçersiz kıl]
EventDispatcher nesnesi olan bir event listener nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | Stage | ||
Güvenlik kısıtlamalarının, DisplayObjectContainer.getObjectsUnderPoint() yönteminin belirtilen point noktası ile çağrılması sonucunda döndürülen listeden görüntüleme nesnelerinin çıkarılmasına neden olup olmayacağını belirtir. | DisplayObjectContainer | ||
objectToFocus tarafından belirtilen etkileşimli nesneye, direction parametresiyle belirtilen odak yönüyle klavye odağı ayarlar. | Stage | ||
Belirtilen görüntüleme nesnesinin, DisplayObjectContainer örneğinin alt öğesi mi, yoksa örneğin kendisi mi olduğunu belirler. | DisplayObjectContainer | ||
[geçersiz kıl]
Olay akışına bir olay gönderir. | Stage | ||
Görüntüleme nesnesinin alanını targetCoordinateSpace nesnesinin koordinat sistemine göre tanımlayan bir dikdörtgen döndürür. | DisplayObject | ||
Belirtilen dizinde bulunan alt görüntüleme nesnesi örneğini döndürür. | DisplayObjectContainer | ||
Belirtilen ad ile var olan alt görüntüleme nesnesini döndürür. | DisplayObjectContainer | ||
Bir alt DisplayObject örneğinin dizin konumunu döndürür. | DisplayObjectContainer | ||
Belirtilen noktanın altında olan ve bu DisplayObjectContainer örneğinin alt öğesi (veya alt alt öğesi vb.) olan nesnelerin bir dizisini döndürür. | DisplayObjectContainer | ||
targetCoordinateSpace parametresince tanımlanan koordinat sistemini esas alarak ve her tür çizgi ve şekli dışarıda bırakarak görüntüleme nesnesinin sınırlarını tanımlayan bir dikdörtgen döndürür. | DisplayObject | ||
point nesnesini, Sahne Alanı (global) koordinatlarından görüntüleme nesnesinin (yerel) koordinatlarına dönüştürür. | DisplayObject | ||
Sahne Alanı (global) koordinatlarından iki boyutlu noktayı üç boyutlu görüntüleme nesnesinin (yerel) koordinatlarına dönüştürür. | DisplayObject | ||
[geçersiz kıl]
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | Stage | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
obj görüntüleme nesnesinin sınırlayıcı kutusuyla örtüşüp örtüşmediğini veya kesişip kesişmediğini görmek için görüntüleme nesnesinin sınırlayıcı kutusunu değerlendirir. | DisplayObject | ||
Görüntüleme nesnesinin x ve y parametreleriyle belirtilen noktayla örtüştüğünü veya kesiştiğini görmek için görüntüleme nesnesini değerlendirir. | DisplayObject | ||
invalidate() yönteminin çağrılması, Flash çalışma zamanlarının bir sonraki görüntüleme listesi oluşturma fırsatında (örneğin, oynatma kafası yeni bir kareye ilerlediğinde) görüntüleme nesnelerini uyarması için Flash çalışma zamanlarına sinyal verir. | Stage | ||
Stage.focus özelliğinin güvenlik nedeniyle null değeri gönderip göndermeyeceğini belirler. | Stage | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Üç boyutlu görüntüleme nesnesinin (yerel) koordinatlarının üç boyutlu noktasını, Sahne Alanı (global) koordinatlarındaki iki boyutlu noktaya dönüştürür. | DisplayObject | ||
point nesnesini, görüntüleme nesnesinin (yerel) koordinatlarından Sahne Alanı (global) koordinatlarına dönüştürür. | DisplayObject | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Belirtilen alt DisplayObject örneğini DisplayObjectContainer örneğinin alt öğe listesinden kaldırır. | DisplayObjectContainer | ||
[geçersiz kıl]
DisplayObjectContainer nesnesinin alt öğe listesinde belirtilen dizin konumundan bir alt DisplayObject öğesini kaldırır. | Stage | ||
Tüm alt DisplayObject örneklerini DisplayObjectContainer örneğinin alt öğe listesinden kaldırır. | DisplayObjectContainer | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Sanal bir klavye yükseltir. | InteractiveObject | ||
Sahne alanını, belirtilen en boy oranına sahip bir yönlendirmeye ayarlar. | Stage | ||
[geçersiz kıl]
Mevcut bir alt öğenin görüntüleme nesnesi kabındaki konumunu değiştirir. | Stage | ||
Sahne alanını, belirtilen yönlendirmeye ayarlar. | Stage | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Kökü bu nesnede bulunan tüm MovieClip öğelerinin zaman çizelgesinde yürütülmesini özyinelemeli olarak durdurur. | DisplayObjectContainer | ||
Belirtilen iki alt nesnenin z sırasını (önden arkaya sıra) takas eder. | DisplayObjectContainer | ||
[geçersiz kıl]
Alt öğe listesinde belirtilen iki dizin konumundaki alt öğe nesnelerinin z sırasını (önden arkaya sıra) takas eder. | Stage | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
[geçersiz kıl]
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | Stage |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
Görüntüleme listesine bir görüntüleme nesnesi eklendiğinde gönderilir. | DisplayObject | |||
Doğrudan veya görüntüleme nesnesini içeren alt ağacın eklenmesiyle, sahne alanı görüntüleme listesine bir görüntüleme nesnesi eklenmek üzereyken gönderilir. | DisplayObject | |||
Stage nesnesinin browserZoomFactor özelliği değiştirildiğinde gönderilir. | Stage | |||
Kullanıcı, metin bağlam menüsünden 'Temizle' (veya 'Sil') seçeneğini belirlediğinde gönderilir. | InteractiveObject | |||
Kullanıcı aynı InteractiveObject üzerindeyken işaretleme aygıtının ana düğmesine basıp bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı hareketi, AIR uygulamasında bulunan bu etkileşimli nesneyle ilişkilendirilmiş bağlam menüsünü tetiklediğinde gönderilir. | InteractiveObject | |||
Kullanıcı, kopyalama işlemi için platforma özel hızlandırıcı tuş kombinasyonunu etkinleştirdiğinde veya metin bağlam menüsünden 'Kopyala' seçeneğini belirlediğinde gönderilir. | InteractiveObject | |||
Kullanıcı, kesme işlemi için platforma özel hızlandırıcı tuş kombinasyonunu etkinleştirdiğinde veya metin bağlam menüsünden 'Kes' seçeneğini belirlediğinde gönderilir. | InteractiveObject | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Bir InteractiveObject nesnesinin doubleClickEnabled bayrağı true olarak ayarlanmışsa, kullanıcı işaretleme aygıtının ana düğmesini aynı InteractiveObject üzerindeyken çok kısa süre içinde art arda iki kez basıp bıraktığında gönderilir. | InteractiveObject | |||
[broadcast olayı] Oynatma kafası yeni bir kareye girerken gönderilir. | DisplayObject | |||
[broadcast olayı] Oynatma kafası geçerli kareden çıkarken gönderilir. | DisplayObject | |||
Bir görüntüleme nesnesi odağı aldıktan sonra gönderilir. | InteractiveObject | |||
Bir ekran nesnesi odaktan çıktıktan sonra gönderilir. | InteractiveObject | |||
[broadcast olayı] Kare görüntüleme nesnelerinin yapıcıları çalıştırıldıktan sonra ancak kare komut dosyaları çalıştırılmadan önce gönderilir. | DisplayObject | |||
Stage nesnesi tam ekran moduna girdiğinde veya tam ekran modundan çıktığında gönderilir. | Stage | |||
Kullanıcı bir InteractiveObject örneği ile dokunmatik yüzeyin kenarı boyunca temas noktası oluşturduğunda (örneğin Apple TV için Siri Remote dokunmatik yüzeyinin kenarına dokunarak) gönderilir. Bazı aygıtlar bu teması birden fazla dokunma olayının birleşimi olarak da yorumlayabilir. | InteractiveObject | |||
Kullanıcı, dokunma etkin bir aygıtta aynı InteractiveObject örneği üzerinde iki temas noktasına bastığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonunda veya tablette bir görüntüleme nesnesinin üzerine iki parmakla basıp parmakları serbest bırakma). | InteractiveObject | |||
Kullanıcı dokunmatik etkin bir aygıtta InteractiveObject örneğinin üzerindeyken bir temas noktası hareket ettirdiğinde gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette görüntüleme nesnesi üzerinde bir parmağı soldan sağa hareket ettirme). | InteractiveObject | |||
Kullanıcı InteractiveObject örneği ile bir temas noktasında döndürme hareketi uyguladığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonunda veya tablette ekrana iki parmakla dokunup parmakları döndürme). | InteractiveObject | |||
Kullanıcı InteractiveObject örneği ile bir temas noktasında kaydırma hareketi uyguladığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonunda veya tablette ekrana üç parmakla dokunup ardından onları paralel bir şekilde görüntüleme nesnesi üzerinden hareket ettirmek). | InteractiveObject | |||
Kullanıcı bir InteractiveObject örneği ile temas noktası oluşturup sonra dokunma etkin aygıta dokunduğunda gönderilir (örn. dokunmatik ekranı olan bir cep telefonunda veya tablette bir menüyü açmak için ekran nesnesinin üzerine birkaç parmağını koyup sonra da menü öğesini seçmek için bir parmağınla dokunma). | InteractiveObject | |||
Kullanıcı InteractiveObject örneği ile bir temas noktasında yakınlaştırma hareketi uyguladığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonunda veya tablette ekrana iki parmakla dokunup ardından görüntüleme nesnesinden parmakları çabucak yanlara açma). | InteractiveObject | |||
Bu olay, IME ile satır içi girdiyi destekleyen herhangi bir istemciye gönderilir. | InteractiveObject | |||
Kullanıcı bir tuşa bastığında gönderilir. | InteractiveObject | |||
Kullanıcı klavye aracılığıyla gezinerek odağı değiştirme girişiminde bulunduğunda gönderilir. | InteractiveObject | |||
Kullanıcı bir tuşu bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı, aynı InteractiveObject üzerinde kullanıcının işaretleme aygıtının orta düğmesine basıp düğmeyi bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı InteractiveObject örneğinin üzerinde işaretleme aygıtının orta düğmesine bastığında görüntülenir. | InteractiveObject | |||
Kullanıcı işaretleme aygıtı düğmesini InteractiveObject örneğinin üzerinde bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı InteractiveObject örneğinin üzerinde işaretleme aygıtı düğmesine bastığında gönderilir. | InteractiveObject | |||
Kullanıcı bir işaretleme aygıtı kullanarak odağı değiştirme girişiminde bulunduğunda gönderilir. | InteractiveObject | |||
İşaretçi sahne alanından dışarı çıktığında Stage nesnesi tarafından gönderilir. | Stage | |||
Kullanıcı, işaretleme aracını, bir InteractiveObject üzerindeyken hareket ettirdiğinde gönderilir. | InteractiveObject | |||
Kullanıcı, işaretleme aygıtını bir InteractiveObject üzerinden dışarı taşıdığında gönderilir. | InteractiveObject | |||
Kullanıcı, işaretleme aygıtını, bir InteractiveObject üzerinde hareket ettirdiğinde gönderilir. | InteractiveObject | |||
Kullanıcı işaretleme aygıtı düğmesini InteractiveObject örneğinin üzerinde bıraktığında gönderilir. | InteractiveObject | |||
Fare tekerleği bir InteractiveObject örneği üzerinde döndüğünde gönderilir. | InteractiveObject | |||
Kullanıcı sürükleme hareketini bıraktığında sürükleme başlatıcı InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Hedef InteractiveObject tarafından, sürüklenen bir nesne üzerine bırakıldığında ve bırakma DragManager.acceptDragDrop() öğesine yapılan bir çağrıyla kabul edildiğinde gönderilir. | InteractiveObject | |||
Sürükleme hareketi sınırının içine girdiğinde, InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Bir sürükleme hareketi sınırının dışına çıktığında, InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Sürükleme hareketi sınırının içinde kalırken sürekli olarak InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Sürükleme işleminin başlangıcında, DragManager.doDrag() çağrısında sürükleme başlatıcı olarak belirlenen InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Bir sürükleme işlemi sırasında, DragManager.doDrag() çağrısında sürükleme başlatıcı olarak belirlenen InteractiveObject tarafından gönderilir. | InteractiveObject | |||
Sahne yönlendirmesi değişmeye başladığında, Stage nesnesi tarafından gönderilir. | Stage | |||
Sahne yönlendirmesi değişmeye başladığında, Stage nesnesi tarafından dağıtılır. | Stage | |||
Kullanıcı, yapıştırma işlemi için platforma özel hızlandırıcı tuş kombinasyonunu etkinleştirdiğinde veya metin bağlam menüsünden 'Yapıştır' seçeneğini belirlediğinde gönderilir. | InteractiveObject | |||
Kullanıcı, etkin bir stilusu ekranın yakınlık algılaması eşiğinin altına indirirse gönderilir. | InteractiveObject | |||
Kullanıcı, etkin bir stilusu ekranın yakınlık algılaması eşiğinin üzerinde olacak şekilde kaldırdığında gönderilir. | InteractiveObject | |||
Kullanıcı, yakınlık algılaması eşiğinde kalırken, ekranın üzerine etkin bir stilus taşıdığında gönderilir. | InteractiveObject | |||
Kullanıcı, ekranın yakınlık algılama eşiğinde kalırken bu InteractiveObject öğesinden etkin bir stilusu uzaklaştırdığında gönderilir. | InteractiveObject | |||
Kullanıcı, ekranın yakınlık algılama eşiğinde kalırken, bu InteractiveObject öğesinin üzerine doğrudan etkin bir stilus taşıdığında gönderilir. | InteractiveObject | |||
Kullanıcı, ekranın yakınlık algılama eşiğinde kalırken, InteractiveObject öğesi ve onun alt öğelerinin herhangi birinden etkin bir stilusu uzaklaştırdığında gönderilir. | InteractiveObject | |||
Kullanıcı; görüntüleme listesindeki öğelerin nesne ağacının dışında kalan (ekranın yakınlık algılama eşiğindeyken) bu InteractiveObject üzerine etkin bir stilus taşırsa gönderilir. | InteractiveObject | |||
Kullanıcı düğmeye önce bir InteractiveObject örneği üzerinde bastıktan ve ardından işaretleme aygıtını InteractiveObject örneğinin üzerinden çektikten sonra, kullanıcı işaretleme aygıtı düğmesini bıraktığı zaman gönderilir. | InteractiveObject | |||
Görüntüleme listesinden bir ekran nesnesi kaldırılmak üzereyken gönderilir. | DisplayObject | |||
Ya doğrudan ya da ekran nesnesini içeren alt ağacın kaldırılmasıyla, sahne görüntüleme listesinden bir ekran nesnesi kaldırılmak üzereyken gönderilir. | DisplayObject | |||
[broadcast olayı] Ekran güncellenmek ve oluşturulmak üzereyken gönderilir. | DisplayObject | |||
Stage nesnesinin scaleMode özelliği StageScaleMode.NO_SCALE olarak ayarlandığında ve SWF dosyası yeniden boyutlandırıldığında gönderilir. | Stage | |||
Kullanıcı, aynı InteractiveObject üzerinde kullanıcının işaretleme aygıtının sağ düğmesine basıp düğmeyi bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı InteractiveObject örneğinin üzerinde işaretleme aygıtı düğmesine bastığında gönderilir. | InteractiveObject | |||
Kullanıcı işaretleme aygıtı düğmesini InteractiveObject örneğinin üzerinde bıraktığında gönderilir. | InteractiveObject | |||
Kullanıcı, işaretleme aygıtını bir InteractiveObject üzerinden dışarı taşıdığında gönderilir. | InteractiveObject | |||
Kullanıcı, işaretleme aracını, bir InteractiveObject üzerinde hareket ettirdiğinde gönderilir. | InteractiveObject | |||
Kullanıcı, tümünü seçme işlemi için platforma özel hızlandırıcı tuş kombinasyonunu etkinleştirdiğinde veya metin bağlam menüsünden 'Tümünü Seç' seçeneğini belirlediğinde gönderilir. | InteractiveObject | |||
Sanal klavye yükseltildikten hemen sonra gönderilir. | InteractiveObject | |||
Sanal klavye yükseltildikten hemen önce gönderilir. | InteractiveObject | |||
Sanal klavye indirildikten hemen sonra gönderilir. | InteractiveObject | |||
stageVideos özelliğinin durumu değiştiğinde, Stage nesnesi tarafından gönderilir. | Stage | |||
Nesnenin tabChildren bayrağının değeri değiştiğinde gönderilir. | InteractiveObject | |||
Nesnenin tabEnabled bayrağı değiştiğinde gönderilir. | InteractiveObject | |||
Nesnenin tabIndex özelliğinin değeri değiştiğinde gönderilir. | InteractiveObject | |||
Bir kullanıcı bir veya birkaç metin karakteri girdiğinde gönderilir. | InteractiveObject | |||
Kullanıcı, dokunmatik etkin bir aygıta ilk temas ettiğinde gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablete parmakla dokunma). | InteractiveObject | |||
Kullanıcı, dokunmatik etkin bir aygıt ile teması kaldırdığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette parmağı kaldırma). | InteractiveObject | |||
Kullanıcı aygıta dokunduğunda gönderilir ve temas noktası kaldırılana kadar sürekli olarak gönderilir. | InteractiveObject | |||
Kullanıcı dokunmatik etkin bir aygıtta temas noktasını InteractiveObject örneğinden dışarı doğru hareket ettirdiğinde gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette bir parmağını bir görüntüleme nesnesinden diğerine sürükleme). | InteractiveObject | |||
Kullanıcı dokunmatik etkin bir aygıtta InteractiveObject örneğinin üzerinde temas noktasını hareket ettirdiğinde gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette bir parmağını görüntüleme nesnesinin dışındaki bir noktadan, görüntüleme nesnesinin üzerindeki bir noktaya sürükleme). | InteractiveObject | |||
Kullanıcı temas noktasını dokunmatik bir aygıtta bir InteractiveObject örneğinden uzağa hareket ettirdiğinde gönderilir (bir cep telefonunda veya dokunmatik ekranlı bir tablet bilgisayarda ekran nesnesinden ekran nesnesinin dışına parmağını sürüklemesi gibi). | InteractiveObject | |||
Kullanıcı dokunmatik etkin bir aygıtta InteractiveObject örneğinin üzerinde temas noktasını hareket ettirdiğinde gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette bir parmağını görüntüleme nesnesinin dışındaki bir noktadan, görüntüleme nesnesinin üzerindeki bir noktaya sürükleme). | InteractiveObject | |||
Kullanıcı, dokunmatik etkin bir aygıtta temasın başlatıldığı aynı InteractiveObject örneği üzerinde temas noktasını kaldırdığında gönderilir (örn. dokunmatik ekranı olan bir cep telefonu veya tablette görüntüleme nesnesi üzerindeki tek bir noktaya bir parmakla basıp parmağı serbest bırakma). | InteractiveObject | |||
Vsync özelliğinin durumu değiştirildiğinde, Stage nesnesi tarafından gönderilir. | Stage |
align | özellik |
align:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Flash Player'da veya tarayıcıda sahne alanının hizalamasını belirten bir StageAlign sınıfı değeri. Şunlar, geçerli değerlerdir:
Değer | Dikey Hizalama | Yatay |
---|---|---|
StageAlign.TOP | Üst | Orta |
StageAlign.BOTTOM | Alt | Orta |
StageAlign.LEFT | Orta | Sol |
StageAlign.RIGHT | Orta | Sağ |
StageAlign.TOP_LEFT | Üst | Sol |
StageAlign.TOP_RIGHT | Üst | Sağ |
StageAlign.BOTTOM_LEFT | Alt | Sol |
StageAlign.BOTTOM_RIGHT | Alt | Sağ |
align
özelliği yalnızca, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunan bir nesne için kullanılabilir. Bunu önlemek için Stage sahibi, Security.allowDomain()
yöntemini veya Security.alowInsecureDomain()
yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
Uygulama
public function get align():String
public function set align(value:String):void
İlgili API Öğeleri
allowsFullScreen | özellik |
allowsFullScreenInteractive | özellik |
allowsFullScreenInteractive:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11.3, AIR 1.0 |
Bu sahne alanının, metin giriş moduyla birlikte tam ekran modunun kullanımına izin verip vermeyeceğini belirtir
Uygulama
public function get allowsFullScreenInteractive():Boolean
autoOrients | özellik |
autoOrients:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Aygıt yönlendirmesi değiştiğinde sahne alanının otomatik olarak değiştirilip değiştirilmediğini belirtir.
Bu özelliğin başlangıç değeri, uygulama açıklamasının autoOrients
öğesinden türetilir ve varsayılan olarak false
değerini verir. Özellik false
olarak değiştirilirken, davranış garanti edilmez. Bazı aygıtlarda, sahne alanı geçerli yönlendirmede kalır. Diğerlerinde, sahne alanı yönlendirmesi, aygıt tarafından tanımlı bir "standart" yönlendirmeye geçiş yapar ve bundan sonra başka yönlendirme değişikliği gerçekleşmez.
AIR profil desteği: Bu özellik mobil aygıtlarda desteklenir ancak masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında Stage.supportsOrientantionChange
özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Uygulama
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
İlgili API Öğeleri
browserZoomFactor | özellik |
browserZoomFactor:Number
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 15 |
Tarayıcı yakınlaştırma faktörünü belirtir. Tarayıcı yakınlaştırma faktöründeki bir değişiklik sahnenin ölçekleme faktörünü etkiler.
Uygulama
public function get browserZoomFactor():Number
color | özellik |
colorCorrection | özellik |
colorCorrection:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Görüntüler için Flash çalışma zamanı renk düzeltmesini denetler. Yalnızca ana monitöre, aygıtın belirli renk niteliklerini belirten geçerli bir ICC renk profili atanırsa renk düzeltmesi çalışır. Flash çalışma zamanı varsayılan olarak ana bilgisayarının (bu genellikle bir tarayıcıdır) renk düzeltmesiyle eşleşmeye çalışır.
Geçerli sistemde ve varsayılan durumda renk düzeltmesinin kullanılabilir olup olmadığını belirlemek için Stage.colorCorrectionSupport
özelliğini kullanın. Renk düzeltmesi kullanılabilirse, sahne alanındaki tüm renklerin en standart renk alanı olan sRGB renk alanında olduğu varsayılır. Renk düzeltmesi sırasında girdi aygıtlarının kaynak profilleri göz önünde bulundurulmaz. Herhangi bir renk düzeltme uygulanmaz; yalnızca sahne alanı çıktısı ana monitörün ICC renk profiliyle eşleşir.
Genelde, renk yönetiminin etkinleştirilmesinin avantajları arasında tahmin edilebilir ve tutarlı renk, daha iyi dönüştürme, doğru sağlama ve daha etkili medyalar arası çıktı yer alır. Ancak aygıtların birbirinden farklı skala ve orijinal görüntülere sahip olması nedeniyle, renk yönetimi mükemmel dönüştürme sağlamaz. Ayrıca renk yönetimi, özel veya düzenlenmiş profil gereksinimini de ortadan kaldırmaz. Renk yönetimleri, tarayıcılara, işletim sistemlerine (OS), OS uzantılarına, çıktı aygıtlarına ve uygulama desteğine bağlıdır.
Renk düzeltmesinin uygulanması, Flash çalışma zamanı performansını düşürür. Tüm SWF filmleri örtülü sRGB profillerine sahip belgeler olarak değerlendirildiğinden Flash çalışma zamanının renk düzeltmesi, belge stilinde renk düzeltmesidir. SWF dosyasını (belge) görüntü renk alanına görüntülerken Flash çalışma zamanına renkleri düzeltmesini bildirmek için Stage.colorCorrectionSupport
özelliğini kullanın. Flash çalışma zamanları, girdi aygıtları (kamera/tarayıcı/vb.) arasındaki farkları değil, yalnızca monitörler arasındaki farkları telafi eder.
Üç olası değer, flash.display.ColorCorrection sınıfında karşılık gelen sabitleri içeren dizelerdir:
"default"
:Ana bilgisayar sistemiyle aynı renk düzeltmesini kullanır."on"
: Her zaman renk düzeltmesi uygular."off"
: Asla renk düzeltmesi uygulamaz.
Uygulama
public function get colorCorrection():String
public function set colorCorrection(value:String):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
Stage.colorCorrection
değeri ColorCorrection sınıfından bir değer değilse işleyici bir hata bildirir.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | özellik |
colorCorrectionSupport:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5 |
Flash çalışma zamanının renk düzeltmesini destekleyen bir işletim sisteminde çalışıp çalışmadığını ve ana (birincil) monitördeki renk profilinin Flash çalışma zamanı tarafından okunup anlaşılabilir olup olmadığını belirtir. Bu özellik aynı zamanda ana bilgisayar sistemindeki (bu genellikle tarayıcıdır) varsayılan renk düzeltmesi durumunu döndürür. Geçerli olarak döndürülen değerler şunlar olabilir:
Üç olası değer, flash.display.ColorCorrectionSupport sınıfında karşılık gelen sabitleri içeren dizelerdir:
"unsupported"
: Renk düzeltmesi kullanılamaz."defaultOn"
: Her zaman renk düzeltmesi uygular."defaultOff"
: Asla renk düzeltmesi uygulamaz.
Uygulama
public function get colorCorrectionSupport():String
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
DEFAULT_ON
mu yoksa DEFAULT_OFF
mu olduğunu görmek için stage.colorCorrectionSupport
değerini kontrol eder. Özellik değerlerin ikisi birdense, metin alanı geçerli değeri görüntüler. Yoksa, değer DEFAULT_ON
da DEFAULT_OFF
da değildir, metin alanı "desteklenmez" yazısını görüntüler.
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | özellik |
contentsScaleFactor | özellik |
contentsScaleFactor:Number
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 11.5 |
Sahne alanının etkili piksel ölçekleme faktörünü belirtir Bu değer standart ekranlarda ve HiDPI (Retina ekran) ekranlarda 1'dir. Sahne alanı, HiDPI ekranlarda oluşturulduğunda, sahne alanı ölçekleme modu StageScaleMode.NO_SCALE olarak ayarlanmış olsa bile piksel çözünürlüğü iki kat artar. Stage.stageWidth ve Stage.stageHeight, klasik piksel birimlerinde raporlanmaya devam eder.
Uygulama
public function get contentsScaleFactor():Number
deviceOrientation | özellik |
deviceOrientation:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Aygıtın fiziksel yönlendirmesi.
Kaydırmalı klavyelere sahip aygıtlarda klavyenin durumu aygıtın yönlendirmesini belirlerken ivmeölçer tarafından algılanan dönüşten daha yüksek önceliğe sahiptir. Bu yüzden klavyesi yanda bulunan, dikey en boy oranına sahip bir aygıtta, kullanıcı aygıtı nasıl tutarsa tutsun, klavye açık olduğunda deviceOrientation
özelliği ROTATED_LEFT
öğesini bildirir.
Bu özellik için değerleri ayarlarken veya karşılaştırırken StageOrientation sınıfında tanımlı sabitleri kullanın.
AIR profil desteği: Bu özellik mobil aygıtlarda desteklenir ancak masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında Stage.supportsOrientationChange
özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Uygulama
public function get deviceOrientation():String
İlgili API Öğeleri
displayState | özellik |
displayState:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Hangi görüntüleme durumunun kullanılacağını belirten bir StageDisplayState sınıfı değeri. Şunlar, geçerli değerlerdir:
StageDisplayState.FULL_SCREEN
AIR uygulamasını veya Flash Player'daki içeriğini, sahne alanını kullanıcının ekranının tamamına genişletecek şekilde ayarlar. Sınırlı yazdırılmayan tuş kümesi hariç olmak üzere klavye girişi devre dışı bırakılır.StageDisplayState.FULL_SCREEN_INTERACTIVE
, klavye girdisine izin verilerek sahne alanını kullanıcının ekranının tamamına genişletecek şekilde uygulamasını ayarlar. (Flash Player 11.3'ten itibaren AIR ve Flash Player'da kullanılabilirdir.)StageDisplayState.NORMAL
Sahne alanını tekrar standart sahne alanı görüntüleme moduna ayarlar.
Tam ekran modundaki filmin ölçeklendirme davranışı, scaleMode
ayarlarıyla belirlenir. (Stage.scaleMode
özelliğini veya HTML dosyasında SWF dosyasının embed
etiketi ayarlarını kullanın.) Uygulama tam ekran moduna geçerken scaleMode
özelliği noScale
olarak ayarlanmışsa, Stage nesnesinin width
ve height
özellikleri güncellenir ve Stage nesnesi bir resize
olayı gönderir. Başka bir ölçek modu ayarlanmışsa, sahne alanı ve içeriği yeni ekran boyutlarını dolduracak şekilde ölçeklenir. Stage nesnesi orijinal width
ve height
değerlerini korur ve resize
olayı göndermez.
Şu sınırlandırmalar HTML sayfasında yürütülen SWF dosyalarına (bağımsız Flash Player veya AIR çalışma zamanı kullananlar değil) uygulanır:
- Tam ekran modunu etkinleştirmek için, örnekte de görüldüğü gibi
allowFullScreen
öğesi"true"
değerine ayarlıyken, SWF dosyasını içeren HTML sayfasındakiobject
veembed
etiketlerineallowFullScreen
parametresini ekleyin:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
SWF gömme etiketlerini oluşturmak için HTML sayfası aynı zamanda bir komut dosyası kullanabilir. Komut dosyası uygun
allowFullScreen
ayarlarını sokacak şekilde dosyayı değiştirmeniz gerekir. Flash Professional ve Flash Builder tarafından oluşturulan HTML sayfaları, SWF dosyalarına başvuru gömmek içinAC_FL_RunContent()
işlevini kullanır ve aşağıdaki örnekte de görüldüğü gibiallowFullScreen
parametre ayarlarını eklemeniz gerekir:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- Kullanıcı tarafından fareyle tıklatıldığında veya klavyede bir tuşa basıldığında yanıt olarak tam ekran modu başlatılır; film, kullanıcı girdisi olmadan
Stage.displayState
öğesini değiştiremez. Flash çalışma zamanları, tam ekran modunda klavye girdisini kısıtlar. Kabul edilebilir tuşlar arasında, tam ekran modunu sonlandıran klavye kısayolları ve oklar, boşluk, Shift ve Tab tuşları gibi yazdırma dışındaki tuşlar yer alır. (Ek tuşlardan girişi desteklemek için tam ekran etkileşimli modu kullanın.) Tam ekran modunu sonlandıran klavye kısayolları şunlardır: Escape (Windows, Linux ve Mac), Control+W (Windows), Command+W (Mac) ve Alt+F4. - Flash Player 9.0.115.0 sürümünden itibaren, tam ekran, penceresiz modda da aynı pencere modunda çalıştığı gibi çalışır. Pencere Modunu (HTML'de
wmode
) Opak Penceresiz (opaque
) veya Saydam Penceresiz (transparent
) olarak ayarladıysanız, tam ekran başlatılabilir, ancak tam ekran penceresi her zaman opak kalır. - Klavye etkileşimini destekleyen tam ekran etkileşimli modu etkinleştirmek için örnekte de görüldüğü gibi
allowFullScreenInteractive
öğesi"true"
olarak ayarlıyken, SWF dosyasını içeren HTML sayfasındakiobject
veembed
etiketlerineallowFullScreenInteractive
parametresini ekleyin:<param name="allowFullScreenInteractive" value="true" /> ...
Bu sınırlamalar, bağımsız Flash Player'da veya AIR'de çalışan SWF içeriği için mevcut değildir.
Tam ekran moduna girerken Flash çalışma zamanı kullanıcılara tam ekran modunda olduklarını ve tam ekran modundan çıkmak için Escape tuşuna basabileceklerini bildirmek için SWF içeriğinin üzerinde kısa bir süreliğine bir bildirim görüntüler.
Tam ekran etkileşimli moduna girilirken, Flash Player SWF içeriğinin üzerinde bir onay istemi görüntüler. Bu, kullanıcıların genişletilmiş klavye girişine (yazdırılabilir tuşlar da dahildir) erişime izin vermelerine olanak tanır ve kullanıcılara tam ekran etkileşimli modundan çıkmak için Escape tuşuna basabileceklerini bildirir. Onay isteminin görünüşü/konumu konusunda varsayımlarda bulunmamanız gerekir. FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
olayını dinleyerek kullanıcıların genişletilmiş klavye girişlerine izin verip vermediğini belirleyebilirsiniz.
Tam ekran modunda çalışan AIR içeriği için, video içeriği oynatılırken ve video duruncaya kadar veya tam ekran modundan çıkılıncaya kadar sistem ekran koruyucusu ve güç tasarrufu seçenekleri devre dışı bırakılır.
Linux'ta, displayState
öğesinin StageDisplayState.FULL_SCREEN
veya StageDisplayState.FULL_SCREEN_INTERACTIVE
olarak ayarlanması eşzamansız bir işlemdir.
Uygulama
public function get displayState():String
public function set displayState(value:String):void
Atar
SecurityError — Stage nesnesinin displayState özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın. Bir kullanıcı yanıtı olmadan ayarlar iletişim kutusu görüntülenirken displayState özelliğinin ayarlanmaya çalışılması veya param ya da embed HTML etiketinin allowFullScreen niteliğinin true değerine ayarlanmaması bir güvenlik hatası atar.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
displayState
özelliği değiştirilerek tam ekran deneyiminin nasıl oluşturulacağını gösteren etkileşimli bir gösteri oluşturur. Not: Tam ekran, güvenlik nedenlerinden dolayı yalnızca kullanıcının bir tuşu tıklatması veya bir tuşa basması gibi belirli durumlarda tetiklenebilir. Tarayıcıda çalıştırılırken allowFullScreen özelliğinin true değerine ayarlanması gerekir.
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | özellik |
focus:InteractiveObject
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Klavye odaklı etkileşimli nesne; veya odak ayarlanmadıysa ya da odaktaki nesne, çağıran nesnenin erişime sahip olmadığı güvenlik sanal alanına aitse null
.
Uygulama
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Atar
Error — Odak hedefe ayarlanamazsa bir hata atar.
|
Örnek ( Bu örnek nasıl kullanılır? )
myTF
metin alanına ayarlar. iOS, Android mobil aygıtları ve tvOS aygıtında, kullanıcının yazılım klavyesini etkinleştirmek için metin alanına tıklaması gerekir. Bu kodu geliştirici araç arabirimi dahilinde test ederseniz, ana bilgisayar (tarayıcı veya araç) çoğu tuş basımlarını ilk yorumladığı için yalnızca birkaç tuşa erişiminiz olabilir. Bu örneğin istendiği gibi işe yaradığını görmek için onu derleyin ve SWF dosyasını çalıştırın.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | özellik |
frameRate:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sahnenin kare hızını alır ve ayarlar. Kare hızı, saniye başına kare olarak tanımlanır. Varsayılan olarak hız, yüklenen birinci SWF dosyasının kare hızına ayarlanır. Kare hızının geçerli aralığı, saniye başına 0,01 - 1000 kare arasıdır.
Not: Hedef platform yeterince hızlı olmadığından veya oynatıcı, görüntüleme aygıtının dikey boş zamanlamasıyla senkronize edildiğinden, bir uygulama yüksek kare hızı ayarlarını izleyemeyebilir. Bazı durumlarda, hedef platform yüksek CPU kullanımını tahmin ederse, maksimum kare hızını düşürmeyi de seçebilir.
Adobe AIR'de çalışan içerik için, bir Stage nesnesinin frameRate
özelliğinin ayarlanması, tüm Stage nesnelerinin (farklı NativeWindow nesneleri tarafından kullanılan) kare hızını değiştirir.
Uygulama
public function get frameRate():Number
public function set frameRate(value:Number):void
Atar
SecurityError — Stage nesnesinin frameRate özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
fullScreenHeight | özellik |
fullScreenHeight:uint
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Tam ekran boyutuna hemen girilirse, bu duruma geçerken kullanılacak monitör yüksekliğine geri döner. Kullanıcının birden çok monitörü varsa, kullanılan monitör, o anda sahne alanının çoğunun bulunduğu monitördür.
Not: Kullanıcının değeri alması ile tam ekran boyutuna geçişi arasında tarayıcıyı bir monitörden diğerine taşıma fırsatı varsa, değer yanlış olabilir. Olay işleyicisinde Stage.displayState
öğesini StageDisplayState.FULL_SCREEN
değerine ayarlayan bir değeri alırsanız, değer doğru olur.
Bu, monitörün piksel yüksekliği olup, Stage.align
öğesi StageAlign.TOP_LEFT
değerine ve Stage.scaleMode
öğesi StageScaleMode.NO_SCALE
değerine ayarlandığında elde edilen sahne alanı yüksekliğiyle aynıdır.
Uygulama
public function get fullScreenHeight():uint
İlgili API Öğeleri
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Örnek ( Bu örnek nasıl kullanılır? )
enterFullScreen()
olay işleyicisini tetikler, bu durumda fullScreenSourceRect
özelliği ayarlanır ve tam ekran moduna girilir. fullScreenSourceRect
özelliğini ayarlamak için, olay işleyicisi kırmızı karenin konumu ve boyutlarıyla işe başlar. Daha sonra, kırmızı karenin en boy oranını (enin boya bölümü) tam ekran genişlik ve yüksekliğindeki sahne alanının en boy oranıyla karşılaştırır, böylece dikdörtgeni (fullScreenSourceRect
) ekranın en boy oranıyla eşleşecek şekilde genişletebilir. Sonuç olarak kırmızı kare, her yandan görünebilir yeşil arka plan ile monitörün tüm yüksekliğini kaplar. En boy oranı eşleşmediyse, yeşil arka plan yerine, varsayılan olarak beyaz olan sahne alanının arka plan rengi her yandan görünür.
Not: Bu örneği tarayıcıda test edin. Flash Yayınlama Ayarları iletişim kutusundaki HTML sekmesinde, Yalnızca Flash - Tam Ekrana İzin Ver şablonunu seçin. Flash Player sürüm 9.0.115.0'ı belirtin ve Biçimler sekmesinde Flash ve HTML biçimlerinin seçildiğinden emin olun. Ardından tarayıcıda sonuç HTML dosyasını yayınlayın ve açın.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | özellik |
fullScreenSourceRect:Rectangle
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Flash çalışma zamanını, sahne alanının belirli bir bölgesini tam ekran moduna ölçekleyecek şekilde ayarlar. Varsa, Flash çalışma zamanı donanımda ölçekleme işlemi yapar, bunun için kullanıcının bilgisayarındaki grafik ve video kartı kullanılır ve genellikle bu şekilde, yazılım ölçeklemeye göre içeriği daha hızlı görüntüler.
Bu özellik geçerli bir dikdörtgene ayarlandığında ve displayState
özelliği tam ekran moduna ayarlandığında, Flash çalışma zamanı belirtilen alanı ölçekler. ActionScript içinde piksel olarak gerçek Sahne Alanı boyutu değişmez. Flash çalışma zamanı, standart “Tam ekran modundan çıkmak için Esc tuşuna basın“ mesajını barındırmak için dikdörtgenin boyutuna minimum bir sınır uygular. Bu sınır genellikle 260 x 30 piksel civarındadır ancak platforma ve Flash çalışma zamanı sürümüne göre değişiklik gösterebilir.
Bu özellik yalnızca Flash çalışma zamanı tam ekran modunda değilken ayarlanabilir. Bu özelliği doğru şekilde kullanmak için, ilk olarak bu özelliği ayarlayın, ardından kod örneklerinde gösterildiği gibi displayState
özelliğini tam ekran moduna ayarlayın. Not: Flash Player 15 ve sonraki sürümlerde bu özellik Flash çalışma zamanı tam ekran modundayken bile ayarlanabilir.
Ölçeklemeyi etkinleştirmek için, fullScreenSourceRect
özelliğini bir rectangle nesnesine ayarlayın.
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Ölçeklemeyi devre dışı bırakmak için, ActionScript 3.0'da fullScreenSourceRect=null
değerini ve ActionScript 2.0'da undefined
değerini ayarlayın.
stage.fullScreenSourceRect = null;
Son kullanıcı, varsayılan olarak etkin durumdaki donanım ölçeklemeyi devre dışı bırakmak için Flash Player Görüntüleme Ayarları içinde de seçim yapabilir. Daha fazla bilgi için, bkz. www.adobe.com/go/display_settings_tr.
Uygulama
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
İlgili API Öğeleri
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Örnek ( Bu örnek nasıl kullanılır? )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Donanım ölçeklemesiyle tam ekran modunu kullanmadan önce şu koşulların karşılanması gerekir:
- Flash Player sürüm 9.0.115.0 veya sonraki bir sürümün yanı sıra, bunu destekleyen bir geliştirme aracı gereklidir.
- HTML şablonlarının tam ekranı desteklemesi için değiştirilmesi gerekir.
object
veembed
etiketi içinallowFullScreen
niteliğinintrue
değerine ayarlanması gerekir. (SWF gömülme etiketleri oluşturan komut dosyalarının da tam ekrana izin vermesi gerekir.) Flash Builder için kullanılabilen dosyalar örneği için, şu makaleye bakın: Flash Player 9'da tam ekran modunu keşfetme. - Uygulamanızın bir FLV dosyasına izni ve erişimi olması gerekir. Bu örnekte Flash Video (FLV) dosyasının SWF dosyasıyla aynı dizinde olduğu varsayılır.
- Kullanıcının tam ekran erişimine izin vermesi gerekir.
- Donanım ölçekleme hakkında daha fazla bilgi için, Flash Player ile ilgili şu makaleye bakın: Yüksek tanımlamalı H.264 video ve AAC ses için Flash Player desteğini keşfetme.
FLV dosyası, NetConnection ve NetStream nesneleri kullanılarak yüklenir. FLV dosyası SWF dosyasıyla aynı dizinde olduğundan ve HTTP üzerinden bağlanacağından, NetConnection.connect()
yönteminin parametresi null
değerine ayarlanır. connect
NetConnection nesnesi, netStatusHandler()
yöntemini çağıran bir netStatus
olayı göndererek durumunu bildirir. netStatusHandler()
yöntemi, bağlantının başarılı olup olmadığını kontrol eder ve connectStream()
yöntemini çağırır, bu çağrı, parametre olarak NetConnection nesnesini alan bir NetStream nesnesi oluşturur. Bu ayrıca bir video nesnesi oluşturur ve NetStream nesnesini video nesnesine ekler. Daha sonra video nesnesi, görüntüleme listesine eklenir ve akış oynatılacak şekilde ayarlanır. FLV video dosyası meta veri veya işaret noktası içermediğinden, bir AsyncError
olayı gönderilir. Olayı işlemesi için bir dinleyicinin kurulması gerekir. Burada dinleyici kurulur ve olayı yok sayar. Ayrıca NetStream nesnesi için başka bir netStatus
olayı dinleyicisi kurulur. Akış bulunmazsa, bu bir hata mesajı görüntüler. (Akış veya bağlantı için bildirilen herhangi bir sayıda farklı durum bilgilerini işlemek için netStatusHandler()
öğesinin kullanılabileceğini unutmayın.)
Yüklenen bir SWF dosyasının özellikleri ve yöntemleri erişilebilir olduğunda, createMouseListener()
yöntemi çağrılır. Bu, sahne alanında fare tıklatıldığında sahne alanı için bir olay dinleyicisi oluşturur. toggleFullScreen()
yöntemi, görüntüleme modunun tam ekran modunda mı yoksa normal ekran modunda mı olduğunu kontrol eder. Normal ekran modundaysa, video nesnesinin boyutu, video akışının boyutuna ayarlanır. fullScreenSourceRect
özelliği, video nesnesinin boyutlarıyla eşleşen bir dikdörtgene ayarlanır. Ardından Stage.displayMode
özelliği tam ekran moduna ayarlanır ve bu da kaynak dikdörtgendeki videonun tam ekran alanını dolduracak şekilde genişlemesine neden olur. Sistem gereksinimleri karşılanırsa, tam ekran video oluşturma performansını artırmak için makinenin grafik donanımı kullanılır ve görüntüleme durumu tam ekran moduna ayarlanır. Tam ekran moduna geçiş yaparken oluşabilecek herhangi bir güvenlik hatasını yakalamak için try...catch
kullanılır. (fullScreenSourceRect
özelliği ayarlandıktan sonra görüntüleme durumunun tam ekran moduna ayarlanması gerektiğini unutmayın.) Normal ekran moduna geçmeden önce, video nesnesinin genişliği ve yüksekliği, kaydedilen orijinal video nesnesinin genişliğine ve yüksekliğine geri ayarlanır. Aksi takdirde, tam ekran modu için video nesnesine yapılan değişiklikler genişlik ve yüksekliği belirler.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | özellik |
fullScreenWidth:uint
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Tam ekran boyutuna hemen girilirse, bu duruma geçerken kullanılacak monitör genişliğine geri döner. Kullanıcının birden çok monitörü varsa, kullanılan monitör, o anda sahne alanının çoğunun bulunduğu monitördür.
Not: Kullanıcının değeri alması ile tam ekran boyutuna geçişi arasında tarayıcıyı bir monitörden diğerine taşıma fırsatı varsa, değer yanlış olabilir. Olay işleyicisinde Stage.displayState
öğesini StageDisplayState.FULL_SCREEN
değerine ayarlayan bir değeri alırsanız, değer doğru olur.
Bu, monitörün piksel genişliği olup, Stage.align
öğesi StageAlign.TOP_LEFT
değerine ve Stage.scaleMode
öğesi StageScaleMode.NO_SCALE
değerine ayarlandığında elde edilen sahne alanı genişliğiyle aynıdır.
Uygulama
public function get fullScreenWidth():uint
İlgili API Öğeleri
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Örnek ( Bu örnek nasıl kullanılır? )
enterFullScreen()
olay işleyicisini tetikler, bu durumda fullScreenSourceRect
özelliği ayarlanır ve tam ekran moduna girilir. fullScreenSourceRect
özelliğini ayarlamak için, olay işleyicisi kırmızı karenin konumu ve boyutlarıyla işe başlar. Daha sonra, kırmızı karenin en boy oranını (enin boya bölümü) tam ekran genişlik ve yüksekliğindeki sahne alanının en boy oranıyla karşılaştırır, böylece dikdörtgeni (fullScreenSourceRect
) ekranın en boy oranıyla eşleşecek şekilde genişletebilir. Sonuç olarak kırmızı kare, her yandan görünebilir yeşil arka plan ile monitörün tüm yüksekliğini kaplar. En boy oranı eşleşmediyse, yeşil arka plan yerine, varsayılan olarak beyaz olan sahne alanının arka plan rengi her yandan görünür.
Not: Bu örneği tarayıcıda test edin. Flash Yayınlama Ayarları iletişim kutusundaki HTML sekmesinde, Yalnızca Flash - Tam Ekrana İzin Ver şablonunu seçin. Flash Player sürüm 9.0.115.0'ı belirtin ve Biçimler sekmesinde Flash ve HTML biçimlerinin seçildiğinden emin olun. Ardından tarayıcıda sonuç HTML dosyasını yayınlayın ve açın.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | özellik |
height:Number
[geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. Yükseklik, görüntüleme nesnesi içeriğinin sınırları esas alınarak hesaplanır. height
özelliğini ayarladığınızda, şu kodda gösterildiği gibi scaleY
özelliği de uygun şekilde ayarlanır:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
TextField ve Video nesneleri dışında, içeriği olmayan bir görüntüleme nesnesinin (örn. boş bir hareketli grafik) height
öğesini farklı bir değere ayarlasanız da, bu nesnenin yüksekliği 0 olur.
Uygulama
override public function get height():Number
override public function set height(value:Number):void
Atar
SecurityError — Stage nesnesinin height özelliğine başvurulması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
| |
IllegalOperationError — Çağıran nesne Stage sahibi (ana SWF dosyası) olsa da, bir Stage nesnesinin height özelliğini ayarlamak her zaman kuraldışıdır.
|
mouseChildren | özellik |
mouseChildren:Boolean
[geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nesnenin alt öğelerinin, fare veya kullanıcı girdi aygıtı etkin olduğunu belirtir. Bir nesne etkinleştirilmişse, kullanıcı, fare veya kullanıcı girdi aygıtı kullanarak o nesneyle etkileşim kurabilir. Varsayılan değer true
şeklindedir.
Bir Sprite sınıfı örneğiyle (SimpleButton sınıfını kullanmak yerine) düğme oluşturduğunuzda, bu özellik yararlıdır. Düğme oluşturmak için bir Sprite örneğini kullandığınızda, ek Sprite örnekleri eklemek için addChild()
yöntemini kullanarak düğmeyi süslemeyi seçebilirsiniz. Üst örneğin hedef nesne olmasını beklediğinizde, alt öğe olarak eklediğiniz Sprite örnekleri mouse olayının hedef nesnesi olabildiğinden, bu işlem beklenmeyen bir davranışa yol açabilir. Üst örneğin, fare olaylarının hedef nesneleri görevini görmesini sağlamak için, üst örneğin mouseChildren
özelliğini false
değerine ayarlayabilirsiniz.
Bu özelliğin ayarlanmasıyla herhangi bir olay gönderilmez. Etkileşimli işlevler oluşturmak için addEventListener()
yöntemini kullanmanız gerekir.
Uygulama
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Atar
SecurityError — Stage nesnesinin mouseChildren özelliğine başvurulması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
mouseLock | özellik |
mouseLock:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11.2, AIR 3.2 |
Fare kilidini etkinleştirmek için true
olarak ayarlayın. Fare kilidinin etkinleştirilmesi imleci devre dışı bırakır ve farenin sınırsız hareketine olanak tanır. Fare kilidini yalnızca masaüstü uygulamaları için tam ekran modunda etkinleştirebilirsiniz. Fare kilidini tam ekran modunda olmayan veya mobil aygıtlardaki uygulamalarda ayarlamak kural dışı bir durum oluşturur.
Şu durumda fare kilidi otomatik olarak devre dışı bırakılır ve fare imleci tekrar görünür hale gelir:
- Kullanıcı Esc tuşunu (tüm platformlar), Control-W (Windows), Command-W (Mac) veya Alt-F4 (Windows) tuşlarını kullanarak tam ekran modundan çıkabilir.
- Uygulama penceresi odağı kaybeder.
- Tüm özel iletişim kutuları dahil olmak üzere ayar kullanıcı arabirimlerinin hepsi görünür.
- Dosya yükleme iletişim kutusu gibi bir yerel iletişim kutusu gösterilir.
Tam ekran modundan çıkarken bu özellik otomatik olarak false
ayarına getirilir.
mouseMove
olayı gibi fare hareketiyle ilişkili olan olaylar, olay nesnesini temsil etmek için MouseEvent sınıfını kullanır. Fare kilidi devre dışıyken farenin konumunu belirlemek için MouseEvent.localX
ve MouseEvent.localY
özelliklerini kullanın. Fare kilidi etkinken farenin konumunu belirlemek için MouseEvent.movementX
ve MouseEvent.movementY
özelliklerini kullanın. movementX
ve movementY
özellikleri, fare konumunun kesin koordinatlarını değil fare konumunda son olaydan itibaren gerçekleşmiş olan değişiklikleri içerir.
Not: Uygulama tam ekran modundayken, Sahne Alanı'nın dışındaki görüntüleme nesnelerine iliştirilen fare olay dinleyicileri gönderilmez. Bu nedenle, mouseLock
öğesi true
olduğunda fare deltalarını ve başka herhangi bir fare olayını almak için fare olay dinleyicilerini Stage nesnesine iliştirin.
Uygulama
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
İlgili API Öğeleri
nativeWindow | özellik |
nativeWindow:NativeWindow
[salt okunur] Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Lite 4 |
Bu Stage öğesini içeren NativeWindow nesnesi başvurusu.
Pencere, yerel işletim sistemi penceresini temsil eder, Stage ise pencerenin barındırdığı içeriği temsil eder. Bu özellik yalnızca NativeWindow sınıfını destekleyen platformlarda AIR'de çalışan içerik için geçerlidir. Diğer platformlarda bu özellik null
değerine sahip olur. Flash Player'da (bir tarayıcıda çalışan içerik), bu özellik de null
olur.
Uygulama
public function get nativeWindow():NativeWindow
numChildren | özellik |
numChildren:int
[salt okunur] [geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bu nesnenin alt öğelerinin sayısını döndürür.
Uygulama
override public function get numChildren():int
Atar
SecurityError — Stage nesnesinin numChildren özelliğine başvurulması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
orientation | özellik |
orientation:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Sahne alanının geçerli yönlendirmesi. Bu özellik, StageOrientation sınıfında sabitler olarak tanımlanan dört değerden birine ayarlanır:
StageOrientation sabiti | Stage yönlendirmesi |
---|---|
StageOrientation.DEFAULT | Ekran varsayılan yönlendirmededir (sağ taraf yukarı). |
StageOrientation.ROTATED_RIGHT | Ekran sağa döndürülür. |
StageOrientation.ROTATED_LEFT | Ekran sola döndürülür. |
StageOrientation.UPSIDE_DOWN | Ekran baş aşağı döndürülür. |
StageOrientation.UNKNOWN | Uygulama, ekranın başlangıçtaki yönlendirmesini henüz belirlememiştir. orientationChange olayı için bir olay dinleyicisi ekleyebilirsiniz. |
Sahne yönlendirmesini ayarlamak için setOrientation()
yöntemini kullanın.
Önemli: yönlendirme özelliği, 2.6 ad alanından itibaren Android aygıtlarda desteklenir.
Uygulama
public function get orientation():String
İlgili API Öğeleri
quality | özellik |
quality:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hangi oluşturma kalitesinin kullanıldığını belirten bir StageQuality sınıfı değeri. Şunlar, geçerli değerlerdir:
StageQuality.LOW
—Düşük oluşturma kalitesi. Grafiklerin kenarları yumuşatılmaz ve bitmap'ler düzgünleştirilmez ancak çalışma alanları yine de doku eşleme özelliğini kullanır.StageQuality.MEDIUM
—Orta oluşturma kalitesi. 2 x 2 piksel ızgara kullanılarak grafiklerin kenarları yumuşatılır, bitmap düzgünleştirme,Bitmap.smoothing
ayarına bağlıdır. Çalışma zamanları doku eşleme özelliğini kullanır. Bu ayar, metin içermeyen filmler için uygundur.StageQuality.HIGH
—Yüksek oluşturma kalitesi. 4 x 4 piksel ızgara kullanılarak grafiklerin kenarları yumuşatılır, bitmap düzgünleştirme,Bitmap.smoothing
ayarına bağlıdır. Çalışma zamanları doku eşleme özelliğini kullanır. Bu, Flash Player'ın kullandığı varsayılan oluşturma kalitesidir.StageQuality.BEST
—Çok yüksek oluşturma kalitesi. 4 x 4 piksel ızgara kullanılarak grafiklerin kenarları yumuşatılır.Bitmap.smoothing
true
olursa, çalışma zamanı daha az yapı üreten yüksek kaliteli bir aşağı ölçek algoritması kullanır (ancakBitmap.smoothing
öğesitrue
olarak ayarlanmış şekildeStageQuality.BEST
öğesinin kullanılması, performansı büyük ölçüde yavaşlatır ve önerilen bir ayar değildir).
Daha yüksek kalite, ölçeklenen bitmap'lerin daha iyi oluşturulmasını sağlar. Ancak daha yüksek ayarlar, sayısal olarak hesaplı değildir. Özellikle ölçeklenen video oluşturulurken daha yüksek kalite ayarlarının kullanılması kare hızını azaltabilir.
BitmapData.draw()
yöntemi Stage.quality
özelliğinin değerini kullanır. Alternatif olarak, geçerli Stage.quality
değerini yok sayarak quality
parametresini yöntemde belirtmenizi sağlayan BitmapData.drawWithQuality()
yöntemini kullanabilirsiniz.
Adobe AIR'nin masaüstü profilinde, quality
öğesi StageQuality.BEST
veya StageQuality.HIGH
olarak ayarlanabilir (varsayılan değer: StageQuality.HIGH
). Bunun başka bir değere ayarlanmaya çalışılması herhangi bir etki oluşturmaz (ve özellik de değişmeden kalır). AIR'nin mobil profilinde dört kalite ayarının hepsi mevcuttur. Mobil aygıtlarda varsayılan değer StageQuality.MEDIUM
değeridir.
Adobe AIR'de çalışan içerik için, bir Stage nesnesinin quality
özelliğinin ayarlanması, tüm Stage nesnelerinin (farklı NativeWindow nesneleri tarafından kullanılan) oluşturma kalitesini değiştirir.
quality
özelliğinden etkilenmez.
Uygulama
public function get quality():String
public function set quality(value:String):void
Atar
SecurityError — Stage nesnesinin quality özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
İlgili API Öğeleri
scaleMode | özellik |
scaleMode:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hangi ölçek modunun kullanılacağını belirten bir StageScaleMode sınıfı değeri. Şunlar, geçerli değerlerdir:
StageScaleMode.EXACT_FIT
— Uygulamanın tamamı, orijinal en boy oranı korunmaya çalışılmadan, belirtilen alanda görünür. Bozulma meydana gelebilir ve uygulama uzatılmış veya sıkıştırılmış görünebilir.StageScaleMode.SHOW_ALL
— Uygulamanın tamamı, bozulma olmadan ve uygulamanın orijinal en boy oranı korunarak, belirtilen alanda görünür. Kenarlıklar, uygulamanın iki kenarında görüntülenebilir.StageScaleMode.NO_BORDER
— Uygulamanın tamamı, bozulma olmadan ancak bir miktar kırpma olması olasılığıyla uygulamanın orijinal en boy oranı korunarak, belirtilen alanı doldurur.StageScaleMode.NO_SCALE
— Uygulamanın tamamı sabitlenir, böylece Player penceresinin boyutu değişse de uygulama olduğu gibi kalır. Oynatıcı penceresi, içerikten küçükse kırpılma meydana gelebilir.
Uygulama
public function get scaleMode():String
public function set scaleMode(value:String):void
Atar
SecurityError — Stage nesnesinin scaleMode özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
İlgili API Öğeleri
showDefaultContextMenu | özellik |
showDefaultContextMenu:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Flash çalışma zamanı bağlam menüsünde varsayılan öğelerin gösterileceğini veya gizleneceğini belirtir.
showDefaultContextMenu
özelliği true
değerine (varsayılan) ayarlıysa, tüm bağlam menüsü öğeleri görüntülenir. showDefaultContextMenu
özelliği false
değerine ayarlıysa, yalnızca Ayarlar ve Hakkında... menü öğeleri görüntülenir.
Uygulama
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Atar
SecurityError — Stage nesnesinin showDefaultContextMenu özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
softKeyboardRect | özellik |
softKeyboardRect:Rectangle
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.6, Flash Player 10.2 |
Geçerli olarak bir sanal klavyeyle kaplanan, sahne alanını belirten bir Dikdörtgen. Sanal klavye yükseltilmediğinde, Dikdörtgenin bileşenleri (0,0,0,0) şeklindedir.
Uygulama
public function get softKeyboardRect():Rectangle
İlgili API Öğeleri
stage3Ds | özellik |
stage3Ds:Vector.<Stage3D>
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11, AIR 3 |
3 boyutlu içeriği görüntülemek için kullanılabilen Stage3D nesnelerinin listesi.
Bir kerede yalnızca sınırlı sayıda Stage3D nesnesi kullanabilirsiniz. Kullanılabilen Stage3D nesnelerinin sayısı platforma ve mevcut donanıma bağlıdır.
Bir Stage3D nesnesi bir StageVideo nesnesinin önüne ve Flash görüntüleme listesinin arkasına çizer.
Uygulama
public function get stage3Ds():Vector.<Stage3D>
İlgili API Öğeleri
stageFocusRect | özellik |
stageFocusRect:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Nesnelerin odakta olduklarında ışıyan bir kenarlık görüntüleyip görüntülemeyeceğini belirtir.
Uygulama
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Atar
SecurityError — Stage nesnesinin stageFocusRect özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
stageHeight | özellik |
stageHeight:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sahne Alanı'nın piksel olarak geçerli yüksekliği.
Kullanıcı pencereyi yeniden boyutlandırdığında Stage.scaleMode
özelliğinin değeri StageScaleMode.NO_SCALE
olarak ayarlanırsa, SWF dosyasının kapladığı ekran alanının yeni yükseklik boyutunu yansıtmak için stageHeight
özelliği değişirken, Sahne Alanı içeriği boyutunu korur. (Diğer ölçek modlarında, stageHeight
özelliği her zaman SWF dosyasının orijinal yüksekliğini yansıtır.) resize
olayı için bir olay dinleyicisi ekleyebilir ve sonra yeniden boyutlandırılan Flash çalışma zamanı penceresinin gerçek piksel boyutunu belirlemek için Stage sınıfının stageHeight
özelliğini kullanabilirsiniz. Olay dinleyicisi, kullanıcı pencereyi yeniden boyutlandırdığında ekran içeriğinin nasıl ayarlandığını denetlemenize izin verir.
stageHeight
özelliğini ayarladığınızda Air for TV aygıtları masaüstü aygıtlarından biraz daha farklı davranışa sahip olur. Stage.scaleMode
özelliği StageScaleMode.NO_SCALE
olarak ayarlıysa ve stageHeight
özelliğini ayarlarsanız sahne alanı yüksekliği SWF'nin bir sonraki karesine kadar değişmez.
Not: SWF dosyasını barındıran bir HTML sayfasında hem object
hem de embed
etiketlerinin height
niteliklerinin piksel değerine değil bir yüzdelik değere (örn. 100%
) ayarlanması gerekir. Ayarlar JavaScript koduyla oluşturulursa, AC_FL_RunContent()
yönteminin height
parametresinin de bir yüzdelik değere ayarlanması gerekir. Bu yüzdelik değer, stageHeight
değerine uygulanır.
Uygulama
public function get stageHeight():int
public function set stageHeight(value:int):void
Atar
SecurityError — Stage nesnesinin stageHeight özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
İlgili API Öğeleri
stageVideos | özellik |
stageVideos:Vector.<StageVideo>
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5, Flash Player 10.2 |
Harici videoları oynatmak için kullanılabilen StageVideo nesnelerinin listesi.
Bir kerede yalnızca sınırlı sayıda StageVideo nesnesi kullanabilirsiniz. Bir SWF çalışmaya başladığında, kullanılabilir StageVideo nesnesi sayısı platforma ve mevcut donanıma bağlıdır.
Bir StageVideo nesnesini kullanmak için stageVideos
Vector nesnesinin bir üyesini StageVideo değişkenine atayın.
Tüm StageVideo nesneleri sahne alanında, görüntüleme nesnelerinin arkasında görüntülenir. StageVideo nesneleri sahne alanında stageVideos
Vector nesnesinde görüntülendiği sırada görüntülenir. Örneğin stageVideos
Vector nesnesi üç giriş içeriyorsa:
stageVideos
Vector nesnesinin 0 dizinindeki StageVideo nesnesi tüm StageVideo nesnelerinin arkasında görüntülenir.- Dizin 1'de bulunan StageVideo nesnesi dizin 0'daki StageVideo nesnesinin önünde görüntülenir.
- Dizin 2'de bulunan StageVideo nesnesi dizin 1'deki StageVideo nesnesinin önünde görüntülenir.
Bu sıralamayı değiştirmek için StageVideo.depth
özelliğini kullanın.
Not: AIR for TV aygıtları yalnızca bir StageVideo nesnesini destekler.
Uygulama
public function get stageVideos():Vector.<StageVideo>
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | özellik |
stageWidth:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sahne Alanı'nın geçerli genişliğini piksel olarak belirtir.
Kullanıcı pencereyi yeniden boyutlandırdığında Stage.scaleMode
özelliğinin değeri StageScaleMode.NO_SCALE
olarak ayarlanırsa, SWF dosyasının kapladığı ekran alanının yeni genişlik boyutunu yansıtmak için stageWidth
özelliği değişirken, Sahne Alanı içeriği tanımlı boyutunu korur. (Diğer ölçek modlarında, stageWidth
özelliği her zaman SWF dosyasının orijinal genişliğini yansıtır.) resize
olayı için bir olay dinleyicisi ekleyebilir ve sonra yeniden boyutlandırılan Flash çalışma zamanı penceresinin gerçek piksel boyutunu belirlemek için Stage sınıfının stageWidth
özelliğini kullanabilirsiniz. Olay dinleyicisi, kullanıcı pencereyi yeniden boyutlandırdığında ekran içeriğinin nasıl ayarlandığını denetlemenize izin verir.
stageWidth
özelliğini ayarladığınızda Air for TV aygıtları masaüstü aygıtlarından biraz daha farklı davranışa sahip olur. Stage.scaleMode
özelliği StageScaleMode.NO_SCALE
olarak ayarlıysa ve stageWidth
özelliğini ayarlarsanız sahne alanı genişliği SWF'nin bir sonraki karesine kadar değişmez.
Not: SWF dosyasını barındıran bir HTML sayfasında hem object
hem de embed
etiketlerinin width
niteliklerinin piksel değerine değil, bir yüzdelik değere (örn. %100
) ayarlanması gerekir. Ayarlar JavaScript koduyla oluşturulursa, AC_FL_RunContent()
yönteminin width
parametresinin de bir yüzdelik değere ayarlanması gerekir. Bu yüzdelik değer, stageWidth
değerine uygulanır.
Uygulama
public function get stageWidth():int
public function set stageWidth(value:int):void
Atar
SecurityError — Stage nesnesinin stageWidth özelliğinin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
İlgili API Öğeleri
supportedOrientations | özellik |
supportedOrientations:Vector.<String>
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.6 |
Geçerli aygıt tarafından desteklenen yönlendirmeler.
setOrientation()
yöntemi için parametreler olarak bu listede bulunan yönlendirme dizelerini kullanabilirsiniz. Desteklenmeyen bir yönlendirmenin ayarlanması, hata olmadan başarısız olur.
Olası yönlendirmeler şunlardır:
StageOrientation sabiti | Stage yönlendirmesi |
---|---|
StageOrientation.DEFAULT | Sahne alanı yönlendirmesini, varsayılan yönlendirmeye (sağ taraf yukarı) ayarlar. |
StageOrientation.ROTATED_RIGHT | Sahne alanı yönlendirmesini sağa döndürülmüş olarak ayarlar. |
StageOrientation.ROTATED_LEFT | Sahne alanı yönlendirmesini sola döndürülmüş olarak ayarlar. |
StageOrientation.UPSIDE_DOWN | Sahne alanı yönlendirmesini baş aşağı döndürülmüş olarak ayarlar. |
Uygulama
public function get supportedOrientations():Vector.<String>
İlgili API Öğeleri
supportsOrientationChange | özellik |
supportsOrientationChange:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Uygulamanın sahne alanı yönlendirmesindeki (ve aygıt döndürmesindeki) değişikleri destekleyip desteklemediği. Şu anda bu özellik mobil aygıtlarda çalışan AIR uygulamalarında yalnızca true
değerine sahiptir.
Uygulama
public static function get supportsOrientationChange():Boolean
İlgili API Öğeleri
tabChildren | özellik |
tabChildren:Boolean
[geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Nesnenin alt öğelerinin sekme tuşuna tepki verip vermediğini belirler. Nesnenin alt öğeleri için sekme işlemini etkinleştirir veya devre dışı bırakır. Varsayılan değer true
şeklindedir.
Not: tabChildren
özelliğini Flex ile kullanmayın. Onun yerine, mx.core.UIComponent.hasFocusableChildren
özelliğini kullanın.
Uygulama
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Atar
SecurityError — Stage nesnesinin tabChildren özelliğine başvurulması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
textSnapshot | özellik |
textSnapshot:flash.text:TextSnapshot
[salt okunur] [geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu DisplayObjectContainer örneği için bir TextSnapshot nesnesi döndürür.
Uygulama
override public function get textSnapshot():flash.text:TextSnapshot
Atar
IllegalOperationError — Stage nesnesinin textSnapshot özelliğine başvurulması, Stage sınıfı bu özelliği uygulamadığından, bir istisna atar. Bunu önlemek için, Stage nesnesi dışında bir görüntüleme nesnesi kabının textSnapshot özelliğini çağırın.
|
vsyncEnabled | özellik |
vsyncEnabled:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 29.0 |
Bu, temel alınan grafik çözümünün geçerli vsync durumunu temsil eder. Sonraki VSYNC durumu için beklemeden hemen oluşturabilmek için vsync seçeneğini etkinleştirebilir/devre dışı bırakabiliriz. Özelliğin okunması her zaman geçerli. Ancak, özelliğin ayarlanması yalnızca VsyncStateChangeAvailabilityEvent başlatıldıktan sonra geçerlidir.
Uygulama
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | özellik |
width:Number
[geçersiz kıl] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. Genişlik, görüntüleme nesnesi içeriğinin sınırları esas alınarak hesaplanır. width
özelliğini ayarladığınızda, şu kodda gösterildiği gibi scaleX
özelliği de uygun şekilde ayarlanır:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
TextField ve Video nesneleri dışında, içeriği olmayan bir görüntüleme nesnesinin (örn. boş bir hareketli grafik) width
öğesini farklı bir değere ayarlasanız da, bu nesnenin genişliği 0 olur.
Uygulama
override public function get width():Number
override public function set width(value:Number):void
Atar
SecurityError — Stage nesnesinin width özelliğine başvurulması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
| |
IllegalOperationError — Stage sahibiyseniz, bir Stage nesnesinin width özelliğini ayarlamak her zaman kuraldışıdır.
|
wmodeGPU | özellik |
wmodeGPU:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
GPU bileşiminin kullanılabilir ve kullanımda olup olmadığını belirtir. wmodeGPU
değeri yalnızca aşağıdaki koşullardan üçü var olduğunda true
olur.
- GPU bileşimi istenmiştir.
- GPU bileşimi kullanılabilir.
- GPU bileşimi kullanımdadır.
Özellikle, wmodeGPU
özelliği aşağıdakilerden birini belirtir:
- GPU bileşimi istenmemiştir veya kullanılamaz. Bu durumda,
wmodeGPU
özelliğinin değerifalse
olur. - GPU bileşimi istenmiştir (varsa ve kullanılabiliyorsa), ancak içerik sınırlamaları nedeniyle ortam "geri dönüş modunda" (optimum oluşturma değil) çalışmaktadır. Bu durumda,
wmodeGPU
özelliğinin değeritrue
olur. - GPU bileşimi istenmiştir (varsa ve kullanılabiliyorsa) ve ortam en iyi modda çalışmaktadır. Bu durumda,
wmodeGPU
özelliğinin değeritrue
olur.
Başka bir deyişle, wmodeGPU
özelliği, oluşturma ortamının yeteneğini ve durumunu tanımlar. (Yukarıda belirtildiği gibi) değer yalnızca GPU bileşimi istendiğinde, kullanılabilir ve kullanımda olduğunda true
olduğundan, AIR 1.5.2 gibi GPU bileşimini desteklemeyen çalışma zamanları için, değer her zaman false
olur.
wmodeGPU
özelliği, çalışma zamanında GPU bileşiminin kullanımda olup olmadığını belirlemekte kullanışlıdır. wmodeGPU
değeri, grafiği doğru boyutta sunabilmeniz için içeriğinizin donanıma göre ölçeklenip ölçeklenmeyeceğini belirtir. Ayrıca, içeriğinizin karmaşıklığını uygun şekilde ayarlayabilmeniz için hızlı bir yolda oluşturma yapıp yapmayacağınızı da belirleyebilirsiniz.
Bir tarayıcıdaki Flash Player için, SWF dosyasını barındıran sayfada wmode
HTML parametresinin gpu
değeri tarafından GPU bileşimi istenebilir. Diğer konfigürasyonlar için, GPU bileşimi bir SWF dosyasının üstbilgisinde (SWF geliştirme araçları kullanılarak ayarlanır) istenebilir.
Ancak, wmodeGPU
özelliği geçerli oluşturma performansını tanımlamaz. GPU bileşimi "kullanımda" olsa da, oluşturma işlemi en iyi modda çalışmayabilir. En iyi oluşturma için içeriğinizi ayarlamak üzere bir Flash çalışma zamanı hata ayıklayıcı sürümünü kullanın ve mm.cfg dosyanızda DisplayGPUBlendsetting
öğesini ayarlayın.
Not: Bu özellik, çalışma zamanı ilk oluşturma geçişini gerçekleştirmeden önce çalıştırılan ActionScript'ten başvurulduğunda her zaman false
olur. Örneğin, Adobe Flash Professional'ın Kare 1'indeki bir komut dosyasından wmodeGPU
öğesini incelerseniz ve SWF dosyanız çalışma zamanının yeni bir örneğine yüklenen ilk SWF dosyasıysa, wmodeGPU
değeri false
olur. Doğru bir değer elde etmek için en az bir oluşturma geçişinin gerçekleşmesini bekleyin. Herhangi bir DisplayObject
öğesinin exitFrame
olayı için bir olay dinleyicisi yazmak üzere wmodeGPU
değeri doğru değerde olmalıdır.
Uygulama
public function get wmodeGPU():Boolean
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
wmodeGPU
özelliğini inceler, böylece doğru bir değer elde edebilirsiniz.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | yöntem |
override public function addChild(child:DisplayObject):DisplayObject
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. Alt öğe, bu DisplayObjectContainer örneğindeki diğer tüm alt öğelerin önüne (üstüne) eklenir. (Belirli bir dizin konumuna bir alt öğe eklemek için, addChildAt()
yöntemini kullanın.)
Zaten üst öğe olarak farklı bir görüntüleme nesnesi kabı olan bir alt nesne eklerseniz, nesne diğer görüntüleme nesnesi kabının alt öğe listesinden kaldırılır.
Not: stage.addChild()
komutu bir yayınlanmış SWF dosyasıyla sorun yaratabilir. Buna güvenlik sorunları ve diğer yüklü SWF dosyalarıyla çakışmalar dahildir. Çalışma zamanına ne kadar çok SWF dosyası yüklerseniz yükleyin, bir Flash çalışma zamanı örneğinde yalnızca bir Sahne Alanı vardır. Bu yüzden, genellikle nesneler asla doğrudan Sahne Alanına eklenmemelidir. Sahne Alanının içermesi gereken tek nesne kök nesnesidir. Görüntüleme listesindeki tüm öğeleri içermesi için bir DisplayObjectContainer oluşturun. Sonra, gerekiyorsa, o DisplayObjectContainer örneğini Sahne Alanı'na ekleyin.
Parametreler
child:DisplayObject — Bu DisplayObjectContainer örneğinin bir alt öğesi olarak eklenecek DisplayObject örneği.
|
DisplayObject — child parametresinde ilettiğiniz DisplayObject örneği.
|
Atar
SecurityError — Stage nesnesinin addChild() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
addChildAt | () | yöntem |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. Alt öğe belirtilen dizin konumuna eklenir. Bir 0 dizini, bu DisplayObjectContainer nesnesinin görüntüleme listesinin arkasını (altını) temsil eder.
Örneğin, şu örnek sırayla 0, 2 ve 1 dizin konumlarında, a, b ve c etiketli üç görüntüleme nesnesini gösterir:
Zaten üst öğe olarak farklı bir görüntüleme nesnesi kabı olan bir alt nesne eklerseniz, nesne diğer görüntüleme nesnesi kabının alt öğe listesinden kaldırılır.
Parametreler
child:DisplayObject — Bu DisplayObjectContainer örneğinin bir alt öğesi olarak eklenecek DisplayObject örneği.
| |
index:int — Alt öğenin ekleneceği dizin konumu. Geçerli olarak kullanılan bir dizin konumu belirtirseniz, o konumda ve daha üst konumlarda bulunan alt nesneler, alt öğe listesinde bir konum yukarı taşınır.
|
DisplayObject — child parametresinde ilettiğiniz DisplayObject örneği.
|
Atar
SecurityError — Stage nesnesinin addChildAt() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
addEventListener | () | yöntem |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. Belirli türde bir olay, aşama ve öncelik için görüntüleme listesindeki tüm düğümlere olay dinleyicilerini kaydedebilirsiniz.
Bir olay dinleyicisini başarıyla kaydettikten sonra, addEventListener()
öğesine ek çağrılar yaparak önceliğini değiştiremezsiniz. Bir dinleyicinin önceliğini değiştirmek için, ilk olarak removeListener()
öğesini çağırmanız gerekir. Daha sonra dinleyiciyi yeni öncelik seviyesiyle kaydedebilirsiniz.
Dinleyici kaydedildikten sonra, farklı bir type
veya useCapture
değeriyle addEventListener()
öğesine yapılan çağrılar, ayrı bir dinleyici kaydının oluşturulmasıyla sonuçlanır. Örneğin, ilk olarak useCapture
true
değerine ayarlanmış durumdayken bir dinleyiciyi kaydederseniz, dinleyici yalnızca yakalama aşaması boyunca dinleme işlemi yapar. Aynı dinleyici nesnesini kullanarak, ancak useCapture
false
değerine ayarlanmış durumdayken tekrar addEventListener()
öğesini çağırırsanız, iki ayrı dinleyiciniz olur: bunlardan biri yakalama aşamasında dinleme işlemi yapar, diğeri ise hedef ve köpürme aşamasında dinleme işlemi yapar.
Yalnızca hedef aşaması veya köpürme aşaması için bir olay dinleyicisini kaydedemezsiniz. Köpürme yalnızca hedef düğümün alt öğeleri için geçerli olduğundan, bu aşamalar kayıt sırasında birleştirilir.
Artık bir olay dinleyicisine ihtiyacınız olmadığında, removeEventListener()
öğesini çağırarak olay dinleyicisini kaldırın, aksi takdirde bellek sorunları oluşabilir. Çöp toplayıcısı, gönderen nesne var olduğu sürece dinleyiciyi kaldırmadığından, (useWeakReference
parametresi true
olarak ayarlı değilse) olay dinleyicileri otomatik olarak bellekten kaldırılmaz.
Bir EventDispatcher örneği kopyalandığında, o örneğe ekli olan olay dinleyicileri kopyalanmaz. (Yeni oluşturulmuş düğümünüz için bir olay dinleyicisi gerekiyorsa, düğümü oluşturduktan sonra dinleyiciyi eklemeniz gerekir.) Ancak bir EventDispatcher örneğini taşırsanız, örneğe ekli olan olay dinleyicileri de onunla birlikte taşınır.
Bir olay düğümde işlenirken olay dinleyicisi o düğüme kaydediliyorsa, geçerli aşama sırasında olay dinleyicisi tetiklenmez ancak olay akışındaki köpürme aşaması gibi sonraki bir aşamada tetiklenebilir.
Bir olay düğümde işlenirken olay dinleyicisi o düğümden kaldırılırsa, geçerli eylemler tetiklenmeye devam eder. Olay dinleyicisi kaldırıldıktan sonra asla tekrar çağrılmaz (ileride işlenmek üzere tekrar kaydedilmediği sürece).
Parametreler
type:String — Olay türü.
| |
listener:Function — Olayı işleyen dinleyici işlevi. Bu işlev, bu örnekte gösterildiği gibi, Event nesnesini tek parametresi olarak kabul etmeli ve hiçbir öğe döndürmemelidir:
function(evt:Event):void İşleve herhangi bir ad verilebilir. | |
useCapture:Boolean (default = false ) —
Dinleyicinin yakalama aşamasında mı, yoksa hedef ve köpürme aşamalarında mı çalıştığını belirler. useCapture , true olarak ayarlanırsa dinleyici, olayı hedef veya köpürme aşamasında değil de yalnızca yakalama aşamasında işler. useCapture false değerindeyse dinleyici, olayı yalnızca hedef veya köpürme aşamasında işler. Olayı üç aşamada da dinlemek için addEventListener öğesini iki kez, biri useCapture true değerine ayarlanmış olarak, diğeri de useCapture false değerine ayarlanmış olarak çağırın.
| |
priority:int (default = 0 ) — Olay dinleyicisinin öncelik düzeyi. Öncelik, işaretli 32 bit tam sayı tarafından atanır. Sayı ne kadar yüksekse, öncelik de o kadar yüksek olur. n önceliğine sahip tüm dinleyiciler, n-1 önceliğine sahip dinleyicilerden önce işlenir. İki veya daha fazla dinleyici aynı önceliği paylaşırsa, eklendikleri sıraya göre işlenirler. Varsayılan öncelik 0'dır.
| |
useWeakReference:Boolean (default = false ) — Dinleyici başvurusunun güçlü mü, yoksa zayıf mı olduğunu belirler. Güçlü bir başvuru (varsayılan), dinleyicinizin çöp toplama işlemine tabi tutulmasını önler. Zayıf bir başvuru, bu işlevi yapmaz. Sınıf düzeyi üye işlevleri, çöp toplama işlemine tabi değildir. Böylece onları çöp toplama işlemine tabi tutmadan, sınıf düzeyi üye işlevleri için |
Atar
SecurityError — Stage nesnesinin addEventListener yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
assignFocus | () | yöntem |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0 |
objectToFocus
tarafından belirtilen etkileşimli nesneye, direction
parametresiyle belirtilen odak yönüyle klavye odağı ayarlar.
Odak yönü kavramı, uygulama (veya uygulama çerçevesi) tarafından tanımlanmalıdır. Bir sıralama ilkesi oluşturmak için diğer mevcut özellikleri kullanabilseniz de, etkileşimli nesnelerin iç odak sıralaması yoktur. Örneğin, etkileşimli nesneleri Stage üzerindeki veya görüntüleme listesindeki konumlarına göre sıralayabilirsiniz. assignFocus()
öğesinin çağrılması, odağın ayarlanmaya başladığı yönü belirtmeye yönelik ek bir yetenekle Stage.focus
özelliğinin ayarlanmasına eşdeğerdir.
Odak alındıktan sonra objectToFocus
öğesi bir focusIn
olayı gönderir. FocusEvent nesnesinin direction
özelliği, direction
parametresinin ayarını bildirir.
objectToFocus
parametresine bir HTMLLoader nesnesi atarsanız, HTMLLoader nesnesi, direction
parametre değerini esas alarak HTML DOM içindeki uygun odaklanabilir nesneyi seçer. FocusDirection.BOTTOM
olursa, okuma sırasının sonunda HTML DOM üzerindeki odaklanabilir nesneye odak verilir. FocusDirection.TOP
olursa, okuma sırasının başında HTML DOM üzerindeki odaklanabilir nesneye odak verilir. NONE
olursa, HTMLLoader nesnesi geçerli odaklanan öğesini değiştirmeden odağı alır.
Parametreler
objectToFocus:InteractiveObject — Stage üzerindeki herhangi bir öğeden odağı temizlemek için odaklanılacak nesne veya null .
| |
direction:String — objectToFocus öğesine odaklanılmaya başlanan yön. Geçerli değerler, FocusDirection sınıfında sabitler olarak numaralandırılır.
|
Atar
Error — Odak hedefe ayarlanamazsa veya yön geçerli bir tür değilse.
|
İlgili API Öğeleri
dispatchEvent | () | yöntem |
override public function dispatchEvent(event:Event):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Olay akışına bir olay gönderir. Olay hedefi, dispatchEvent()
yönteminin çağrıldığı EventDispatcher nesnesidir.
Parametreler
event:Event — Olay akışına gönderilen Event nesnesi. Olay yeniden gönderiliyorsa, olayın bir klonu otomatik olarak oluşturulur. Bir olay gönderildikten sonra, o olaya ait target özelliği değiştirilemez, böylece işe yeniden göndermek üzere olayın yeni bir kopyasını çıkarmanız gerekir.
|
Boolean — Olayın başarılı bir şekilde gönderilmesi durumunda true değeri. false değeri, hata olduğunu veya preventDefault() öğesinin olayda çağrıldığını gösterir.
|
Atar
SecurityError — Stage nesnesinin dispatchEvent() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
hasEventListener | () | yöntem |
override public function hasEventListener(type:String):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. Bu, EventDispatcher nesnesinin olay akışı hiyerarşisindeki bir event türünün işlenmesini nerede değiştirdiğini belirlemenize izin verir. Belirli türde bir olayın olay dinleyicisini gerçekten tetikleyip tetiklemeyeceğini belirlemek için willTrigger()
öğesini kullanın.
hasEventListener()
ile willTrigger()
arasındaki fark, hasEventListener()
öğesi yalnızca ait olduğu nesneyi incelerken willTrigger()
öğesinin type
parametresi ile belirtilen olayın tüm olay akışını incelemesidir.
LoaderInfo nesnesinden hasEventListener()
çağrıldığında, yalnızca çağıranın erişebildiği dinleyiciler değerlendirilir.
Parametreler
type:String — Olay türü.
|
Boolean — Belirtilen türde bir dinleyici kayıtlıysa, true değeri; kayıtlı değilse, false değeri.
|
Atar
SecurityError — Stage nesnesinin hasEventListener() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
invalidate | () | yöntem |
public function invalidate():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
invalidate()
yönteminin çağrılması, Flash çalışma zamanlarının bir sonraki görüntüleme listesi oluşturma fırsatında (örneğin, oynatma kafası yeni bir kareye ilerlediğinde) görüntüleme nesnelerini uyarması için Flash çalışma zamanlarına sinyal verir. Siz invalidate()
yöntemini çağırdıktan sonra, görüntüleme listesi bir sonraki defa oluşturulduğunda, Flash çalışma zamanı, render
olayını dinlemek için kaydolan görüntüleme nesnelerinin her birine bir render
olayı gönderir. Flash çalışma zamanının her render
olayı göndermesini istediğinizde invalidate()
yöntemini çağırmanız gerekir.
render
olayı, görüntüleme listesi gerçekten oluşturulmadan önce size görüntüleme listesinde değişiklik yapma fırsatı verir. Bu, en son fırsata kadar görüntüleme listesine uygulanan güncellemeleri ertelemenizi sağlar. Böylece gereksiz ekran güncellemeleri önlenerek performans artırılabilir.
render
olayı yalnızca stage.invalidate()
yöntemini çağıran kodla aynı güvenlik etki alanındaki nesneleri görüntülemek veya Security.allowDomain()
yoluyla izin verilen bir güvenlik etki alanındaki nesneleri görüntülemek için gönderilir.
İlgili API Öğeleri
isFocusInaccessible | () | yöntem |
public function isFocusInaccessible():Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stage.focus
özelliğinin güvenlik nedeniyle null
değeri gönderip göndermeyeceğini belirler. Başka bir deyişle, odağın bulunduğu nesne SWF dosyasının erişemediği bir güvenlik sanal alanına aitse isFocusInaccessible
öğesi true
döndürür.
Boolean — Odağın bulunduğu nesne, SWF dosyasının erişemediği bir güvenlik sanal alanına aitse true .
|
removeChildAt | () | yöntem |
override public function removeChildAt(index:int):DisplayObject
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
DisplayObjectContainer nesnesinin alt öğe listesinde belirtilen index
konumundan bir alt DisplayObject öğesini kaldırır. Kaldırılan alt öğenin parent
özelliği null
değerine ayarlanır ve alt öğeye başka başvuru yoksa, nesnede çöp toplama işlemine tabi tutulur. DisplayObjectContainer içinde alt öğenin yukarısında bulunan görüntüleme nesnelerinin dizin konumları 1 azaltılır.
Çöp toplayıcısı, kullanılmayan bellek alanını yeniden ayırır. Bir değişken veya nesneye artık etkin olarak başvurulmuyorsa veya bunlar başka yerde saklanmıyorsa, çöp toplayıcısı, başka başvuru olmadığında kaplamak için kullandığı bellek alanını tarayıp siler.
Parametreler
index:int — Kaldırılacak DisplayObject öğesinin alt dizini.
|
DisplayObject — Kaldırılan DisplayObject örneği.
|
Atar
SecurityError — Stage nesnesinin removeChildAt() yönteminin çağrılması, kaldırılacak nesneyle aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için nesnenin sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
setAspectRatio | () | yöntem |
public function setAspectRatio(newAspectRatio:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Sahne alanını, belirtilen en boy oranına sahip bir yönlendirmeye ayarlar.
Sahne yönlendirmesi yöntem çağrısının sonucu olarak değişirse, Stage nesnesi orientationChange olayı gönderir.
Aygıt yönlendirmesinin desteklenip desteklenmediğine bakmak için, Stage.supportsOrientantionChange
özelliğinin değerini kontrol edin.
AIR profil desteği: Bu özellik mobil aygıtlarda desteklenir ancak masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında Stage.supportsOrientantionChange
özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Parametreler
newAspectRatio:String — İstenen en boy oranı için tür kodu (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE veya StageAspectRatio.ANY ).
|
Atar
ArgumentError — newAspectRatio parametresi olarak iletilen değer geçerli değildir. Değer, StageAspectRatio sınıfında tanımlanan sabitlerden biriyle eşleşmelidir.
|
İlgili API Öğeleri
setChildIndex | () | yöntem |
override public function setChildIndex(child:DisplayObject, index:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Mevcut bir alt öğenin görüntüleme nesnesi kabındaki konumunu değiştirir. Bu, alt nesnelerin katmanlarını etkiler. Örneğin, şu örnek sırayla 0, 1 ve 2 dizin konumlarında, a, b ve c etiketli üç görüntüleme nesnesini gösterir:
setChildIndex()
yöntemini kullanıp zaten kaplanmış bir dizin konumunu belirttiğinizde, yalnızca görüntüleme nesnesinin birinci ve yeni konumu arasındaki konumlar değişir. Diğerlerinin tümü aynı kalır. Bir alt öğe geçerli dizininden DAHA DÜŞÜK bir dizine taşınırsa, aradaki tüm alt öğeler dizin başvuruları için 1 değer ARTIŞ GÖSTERİR. Bir alt öğe geçerli dizininden DAHA YÜKSEK bir dizine taşınırsa, aradaki tüm alt öğeler dizin başvuruları için 1 değer DÜŞÜŞ GÖSTERİR. Örneğin, bir önceki örnekte görüntüleme nesnesi kabı container
olarak adlandırılırsa, şu kodu çağırarak a ve b etiketli görüntüleme nesnelerinin konumunu takas edebilirsiniz:
container.setChildIndex(container.getChildAt(1), 0);
Bu kod, nesnelerin şu şekilde düzenlenmesiyle sonuçlanır:
Parametreler
child:DisplayObject — Dizin numarasını değiştirmek istediğiniz alt DisplayObject örneği.
| |
index:int — child görüntüleme nesnesi için sonuç dizin numarası.
|
Atar
SecurityError — Stage nesnesinin setChildIndex() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
setOrientation | () | yöntem |
public function setOrientation(newOrientation:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2 |
Sahne alanını, belirtilen yönlendirmeye ayarlar.
newOrientation
parametresini, StageOrientation sınıfında sabitler olarak tanımlanan şu dört değerden birine ayarlar:
StageOrientation sabiti | Stage yönlendirmesi |
---|---|
StageOrientation.DEFAULT | Sahne alanı yönlendirmesini, varsayılan yönlendirmeye (sağ taraf yukarı) ayarlar. |
StageOrientation.ROTATED_RIGHT | Sahne alanı yönlendirmesini sağa döndürülmüş olarak ayarlar. |
StageOrientation.ROTATED_LEFT | Sahne alanı yönlendirmesini sola döndürülmüş olarak ayarlar. |
StageOrientation.UPSIDE_DOWN | Sahne alanı yönlendirmesini baş aşağı döndürülmüş olarak ayarlar. |
Parametreyi StageOrientation.UNKNOWN
değerine veya tabloda listelenenler dışında bir dize değerine ayarlamayın.
Aygıt yönlendirmesinin desteklenip desteklenmediğini kontrol etmek için, Stage.supportsOrientantionChange
özelliğinin değerini kontrol edin. Hangi yönlendirmelerin geçerli aygıt tarafından desteklendiğini belirlemek için supportedOrientations
özelliği tarafından sağlanan listeyi kontrol edin.
Yönlendirmenin ayarlanması, senkronize olmayan bir işlemdir. setOrientation()
yöntemi çağrıldıktan hemen sonra tamamlanacağı garanti edilmez. Yönlendirme değişikliğinin ne zaman tamamlanacağını belirlemek üzere, orientationChange
olayı için bir olay dinleyicisi ekleyin.
Önemli: setOrientation()
yöntemi, AIR 2.6'dan önce Android aygıtlarında desteklenmiyordu.
setOrientation()
yöntemi bir orientationChanging
olayının gönderilmesine yol açmaz.
Parametreler
newOrientation:String — Sahne alanının yeni yönlendirmesi.
|
Olaylar
orientationChange: — setOrientation() yöntemine yapılan çağrının sonucu olarak sahne yeniden boyutlandırıldı.
|
Atar
ArgumentError — newOrientation parametresi olarak iletilen değer geçerli değildir. Değer, StageOrientation.UNKNOWN sabiti dışında, StageOriention sınıfında tanımlanan sabitlerden biriyle eşleşmelidir.
|
İlgili API Öğeleri
swapChildrenAt | () | yöntem |
override public function swapChildrenAt(index1:int, index2:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Alt öğe listesinde belirtilen iki dizin konumundaki alt öğe nesnelerinin z sırasını (önden arkaya sıra) takas eder. Görüntüleme nesnesi kabındaki diğer alt nesnelerin tümü aynı dizin konumunda kalır.
Parametreler
index1:int — Birinci alt nesnenin dizin konumu.
| |
index2:int — İkinci alt nesnenin dizin konumu.
|
Atar
SecurityError — Stage nesnesinin swapChildrenAt() yönteminin çağrılması, takas edilecek nesnelerden herhangi birinin sahibiyle aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için nesne sahipleri, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
willTrigger | () | yöntem |
override public function willTrigger(type:String):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. Belirtilen türde bir olay bu EventDispatcher nesnesine veya herhangi bir alt öğesine gönderildiğinde olay akışının herhangi bir aşamasında bir olay dinleyicisi tetiklenirse, bu yöntem true
döndürür.
hasEventListener()
ile willTrigger()
yöntemleri arasındaki fark, hasEventListener()
yöntemi yalnızca ait olduğu nesneyi incelerken willTrigger()
yönteminin type
parametresi ile belirtilen olayın tüm olay akışını incelemesidir.
LoaderInfo nesnesinden willTrigger()
çağrıldığında, yalnızca çağıranın erişebildiği dinleyiciler değerlendirilir.
Parametreler
type:String — Olay türü.
|
Boolean — Belirtilen türde bir dinleyici tetiklenecekse, true değeri; tetiklenmeyecekse, false değeri.
|
Atar
SecurityError — Stage nesnesinin willTrigger() yönteminin çağrılması, Stage sahibiyle (ana SWF dosyası) aynı güvenlik sanal alanında bulunmayan çağıranlar için bir istisna atar. Bunu önlemek için Stage sahibi, Security.allowDomain() yöntemini veya Security.allowInsecureDomain() yöntemini çağırarak çağıranın etki alanına izin verebilir. Daha fazla bilgi için, bkz. ActionScript 3.0 Geliştirici Kılavuzu'ndaki "Güvenlik" bölümüne bakın.
|
browserZoomChange | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 15 |
Stage nesnesinin browserZoomFactor
özelliği değiştirildiğinde gönderilir.
Event.BROWSER_ZOOM_CHANGE
sabiti bir browserZoomChange
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Stage örneği. |
fullScreen | Olay |
flash.events.FullScreenEvent
özellik FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Stage nesnesi tam ekran moduna girdiğinde veya tam ekran modundan çıktığında gönderilir. Tam ekran modundaki bir değişiklik, ActionScript üzerinden veya klavye kısayolu çağıran bir kullanıcı tarafından ya da geçerli odak tam ekran penceresinden çıkarsa başlatılabilir.
FullScreenEvent.FULL_SCREEN
sabiti, fullScreen
olay nesnesinin type
özelliğini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
fullScreen | Görüntüleme durumu tam ekransa true , normalsefalse . |
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Stage nesnesi. |
mouseLeave | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.MOUSE_LEAVE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
İşaretçi sahne alanından dışarı çıktığında Stage nesnesi tarafından gönderilir. Fare düğmesine basılırsa, olay gönderilmez.
Event.MOUSE_LEAVE
sabiti, mouseLeave
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Stage nesnesi. target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın. |
orientationChange | Olay |
flash.events.StageOrientationEvent
özellik StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Sahne yönlendirmesi değişmeye başladığında, Stage nesnesi tarafından gönderilir.
Kullanıcı aygıtı döndürdüğünde, kaydırmalı klavyeyi açtığında veya setAspectRatio()
öğesi çağrıldığında yönlendirme değişiklikleri ortaya çıkabilir.
Not: autoOrients
özelliği false
ise, cihaz döndürüldüğünde sahne alanı yönlendirmesi değişmez. Böylece, StageOrientationEvents öğeleri cihaz döndürüldüğünde yalnızca autoOrients
öğesi true
olduğunda gönderilir.
ORIENTATION_CHANGE
sabiti, orientationChange
olay nesnesinin type
özelliği değerini tanımlar. Bu olay şu özelliklere sahiptir:
Özellikler | Değerler |
---|---|
afterOrientation | Sahne alanının yeni yönlendirmesi. |
beforeOrientation | Sahne alanının eski yönlendirmesi. |
target | Yönlendirme değişikliğini gönderen Stage nesnesi. |
bubbles | true |
currentTarget | Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesneyi belirtir. |
cancelable | false ; değişikliğin iptal edilmesi için çok geçtir. |
orientationChanging | Olay |
flash.events.StageOrientationEvent
özellik StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.0 |
Sahne yönlendirmesi değişmeye başladığında, Stage nesnesi tarafından dağıtılır.
Önemli: orientationChanging olayları Android aygıtlarında gönderilmez.
Notlar:
-
autoOrients
özelliğifalse
ise, aygıt döndürüldüğünde sahne alanı yönlendirmesi değişmez. Böylece, StageOrientationEvents öğeleri cihaz döndürüldüğünde yalnızcaautoOrients
öğesitrue
olduğunda gönderilir. -
Yönlendirme
setOrientation()
yöntemi kullanarak programlama yoluyla ayarlandığındaorientationChanging
olayı gönderilmez.
ORIENTATION_CHANGING
sabiti, orientationChanging
olay nesnesinin type
özelliğinin değerini tanımlar. Bu olay şu özelliklere sahiptir:
Özellikler | Değerler |
---|---|
afterOrientation | Sahne alanının yeni yönlendirmesi. |
beforeOrientation | Sahne alanının eski yönlendirmesi. |
target | Yönlendirme değişikliğini gönderen Stage nesnesi. |
bubbles | true |
currentTarget | Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesneyi belirtir. |
cancelable | true . |
resize | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.RESIZE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stage nesnesinin scaleMode
özelliği StageScaleMode.NO_SCALE
olarak ayarlandığında ve SWF dosyası yeniden boyutlandırıldığında gönderilir. Ayrıca Flash Player 15 ve sonrasında tam ekran modundayken ekran yönü değiştiğinde gönderilir.
Event.RESIZE
sabiti, resize
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Stage nesnesi. |
stageVideoAvailability | Olay |
flash.events.StageVideoAvailabilityEvent
özellik StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 10.2 |
stageVideos özelliğinin durumu değiştiğinde, Stage nesnesi tarafından gönderilir.
BirstageVideoAvailability
olayı nesnesinin type
özelliğinin değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
availability | Olay tarafından bildirilen durum. |
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Olayı etkin olarak işleyen nesne. |
target | Sahne alanı videosunun kullanılabilirliğini bildiren Stage nesnesi. |
Örnek ( Bu örnek nasıl kullanılır? )
StageExample
sınıfını kullanır. Bu görev, şu adımlar gerçekleştirerek yerine getirilir:
- İlk olarak sınıf yapıcısı, Flash Player penceresinin boyutuna bakılmaksızın sabitlenecek Flash uygulamasını ayarlar ve sonra
activateHandler()
veresizeHandler()
yöntemleriyle iki olay dinleyicisi ekler. - Sol fare düğmesi tıklatıldığında
activateHandler()
yöntemi çalıştırılır. - Sahne alanı yeniden boyutlandırıldığında
resizeHandler()
yöntemi çalıştırılır.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Olay |
flash.events.VsyncStateChangeAvailabilityEvent
özellik VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 29.0 |
Vsync özelliğinin durumu değiştirildiğinde, Stage nesnesi tarafından gönderilir.
Bir VsyncStateChangeAvailabilityEvent
olay nesnesinin type özelliği değerini tanımlar.
Örnek ( Bu örnek nasıl kullanılır? )
VsyncExample
sınıfı kullanılır. Bu görev, şu adımlar gerçekleştirerek yerine getirilir:
- Oluşturucu ilk olarak
VsyncStateChangeAvailabilityEvent
stage olayını başlatıyor - Sonra
VsyncStateChangeAvailabilityEvent
olayının kullanılabilir olup olmadığını denetleyenonVsyncStateChangeAvailability
yöntemi çağrılıyor. - Kullanılabilir durumdaysa stage olayının vsync durumu açıp kapatılabiliyor, aksi takdirde
vsyncEnable
olayı salt okunur olarak kalıyor. - Vsync enable işleminin değeri yalnızca olay başlatılırsa tetiklenebiliyor.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Tue Jun 12 2018, 01:09 PM Z