Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: AIR 30.0 ve öncesi, Flash Player 30.0 ve öncesi, Flash Lite 4
Flex 4.6 ve öncesi, Flash Pro CS6 ve öncesi
Filtreleri Gizle
flash.display 

Screen  - AS3

Paketflash.display
Sınıfpublic final class Screen
Miras AlmaScreen Inheritance EventDispatcher Inheritance Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Screen sınıfı, bu uygulama için kullanılabilir görüntüleme ekranları hakkında bilgi sağlar.

Ekranlar, büyük olasılıkla daha büyük “sanal masaüstü“ içindeki masaüstü alanlarından bağımsızdır. Sanal masaüstünün başlangıç konumu, işletim sistemi tarafından atanan ana ekranın sol üst köşesidir. Böylece, tek bir görüntüleme ekranının sınırlarının koordinatları negatif olabilir. Ayrıca herhangi bir görüntüleme ekranı içinde olmayan sanal masaüstü alanları da olabilir.

Screen sınıfı, kullanılabilir screen nesnelerine erişilmesi için static sınıfı üyelerini ve tek bir ekranın özelliklerine erişilmesi için örnek üyeleri içerir. Ekran bilgileri kullanıcı tarafından her an değiştirilebileceğinden ön belleğe alınmamalıdır.

Ekranlar ile bilgisayara bağlı fiziksel monitörler arasında bire bir uygunluk olmak zorunda olmadığını unutmayın. Örneğin, iki monitör aynı ekranı görüntüleyebilir.

Screen sınıfını doğrudan başlatamazsınız. new Screen() yapıcısına yapılan çağrılar bir ArgumentError istisnası atar.

Örnekleri görüntüle



Genel Özellikler
 ÖzellikTanımlayan:
      bounds : Rectangle
[salt okunur] Bu ekranın sınırları.
Screen
      colorDepth : int
[salt okunur] Bu ekranın renk derinliği. (Bit sayısıyla ifade edilir.)
Screen
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
      mainScreen : Screen
[statik] [salt okunur] Birincil ekran.
Screen
      mode : ScreenMode
Screen nesnesinin geçerli ekran modu.
Screen
      modes : Array
[salt okunur] Screen nesnesinin ScreenMode nesneleri dizisi.
Screen
      screens : Array
[statik] [salt okunur] Geçerli olarak kullanılabilir ekranlar dizisi.
Screen
      visibleBounds : Rectangle
[salt okunur] Bu ekranda pencerenin görünebilir olacağı alanın sınırları.
Screen
Genel Yöntemler
 YöntemTanımlayan:
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.
EventDispatcher
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
  
[statik] Sağlanan dikdörtgenle kesişen ekranlar kümesini (büyük olasılıkla boş) döndürür.
Screen
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
 Inherited
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.
EventDispatcher
Olaylar
 Olay Özet Tanımlayan:
 Inherited[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.EventDispatcher
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
Özellik Ayrıntısı
    

bounds

özellik
bounds:Rectangle  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Bu ekranın sınırları.

Ekran konumu, sanal masaüstüne göredir.

Belirli pencere yöneticilerini kullanan Linux sistemlerinde, bu özellik ekranın görünür sınırlarını değil, masaüstü sınırlarını döndürür.



Uygulama
    public function get bounds():Rectangle

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek, bir ekranın sınırlarının nasıl getirileceğini gösterir (bu durumda, birincil görüntüleme ekranı):
import flash.display.Screen;
import flash.geom.Rectangle;

var mainScreen:Screen = Screen.mainScreen;
var screenBounds:Rectangle = mainScreen.bounds;
    

colorDepth

özellik 
colorDepth:int  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Bu ekranın renk derinliği. (Bit sayısıyla ifade edilir.)



Uygulama
    public function get colorDepth():int

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek, bir ekranın renk derinliğinin nasıl getirileceğini gösterir (bu durumda, birincil görüntüleme ekranı):
var mainScreen:Screen = Screen.mainScreen;
var colors:uint = mainScreen.colorDepth;
    

mainScreen

özellik 
mainScreen:Screen  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Birincil ekran.



Uygulama
    public static function get mainScreen():Screen

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek, bu bilgisayarın “ana“ ekranını temsil eden Screen nesnesinin nasıl getirileceğini gösterir:
var primaryScreen:Screen = Screen.mainScreen;
    

mode

özellik 
mode:ScreenMode

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 29.0

Screen nesnesinin geçerli ekran modu. mode özelliği, belirli bir Ekran aygıtının geçerli ekran modunu gösterir.



Uygulama
    public function get mode():ScreenMode
    public function set mode(value:ScreenMode):void
    

modes

özellik 
modes:Array  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 29.0

Screen nesnesinin ScreenMode nesneleri dizisi. modes özelliği, belirli bir Ekran aygıtının desteklenen ekran modlarını gösterir.



Uygulama
    public function get modes():Array
    

screens

özellik 
screens:Array  [salt okunur]

Dil Sürümü: ActionScript 3.
Çalışma Zamanı Sürümleri: AIR 1.0

Geçerli olarak kullanılabilir ekranlar dizisi.

Döndürülen dizinin değiştirilmesi, kullanılabilir ekranlar üzerinde etki oluşturmaz.



Uygulama
    public static function get screens():Array

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek, mevcut ekranları içeren dizinin nasıl getirileceğini gösterir:
var screenArray:Array = Screen.screens;
    

visibleBounds

özellik 
visibleBounds:Rectangle  [salt okunur]

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Bu ekranda pencerenin görünebilir olacağı alanın sınırları.

Ekranın visibleBounds öğesi, Windows'da görev çubuğunu (ve yanaştırılmış diğer sıra çubuklarını), Mac OS X'te sistem ayarlarına bağlı olarak menü çubuğunu hariç tutar. Bazı Linux konfigürasyonlarında, görünen sınırları belirlemek olanaklı değildir. Bu durumlarda, visibleBounds özelliği screenBounds özelliğiyle aynı değeri döndürür.



Uygulama
    public function get visibleBounds():Rectangle

Örnek  ( Bu örnek nasıl kullanılır? )
Aşağıdaki örnek, bir ekranın kullanılabilir sınırlarının nasıl getirileceğini gösterir (bu durumda, birincil görüntüleme ekranı):
import flash.display.Screen;
import flash.geom.Rectangle;

var mainScreen:Screen = Screen.mainScreen;
var screenBounds:Rectangle = mainScreen.visibleBounds;
Yöntem Ayrıntısı

    getScreensForRectangle

()yöntem
public static function getScreensForRectangle(rect:Rectangle):Array

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 1.0

Sağlanan dikdörtgenle kesişen ekranlar kümesini (büyük olasılıkla boş) döndürür.

Parametreler

rect:Rectangle — Birincil ekranın sol üst köşesinde bulunan ve sanal masaüstünün başlangıç konumuna göre koordinatları içeren bir dikdörtgen.

Döndürür
Arrayrect parametresiyle tanımlanan alanın herhangi bir bölümünü içeren ekranların yer aldığı Screen nesneleri dizisi.

Örnek  ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, belirli bir dikdörtgenin en azından bir parçasını içeren ekranlar dizisinin nasıl getirileceğini gösterir:
import flash.display.Screen;
import flash.geom.Rectangle;

var rect:Rectangle = new Rectangle(-200, 100, 1000, 600);
var intersectedScreens:Array = Screen.getScreensForRectangle(rect);
ScreenExample.as

Aşağıdaki örnek, ekranın kenarlarına yanaşan bir pencere oluşturmak için bir DockingWindow sınıfı tanımlar. Bu görev, şu adımlar gerçekleştirilerek yerine getirilir:
  1. Ekranın yanaşılacak kenarını belirlemek üzere klavye olaylarını yanıtlama.
  2. Pencerenin güncel olarak üzerinde görüntülendiği ekrana ilişkin Screen nesnesini almak için statik Screen sınıfının getScreensForRectangle() yöntemine erişme.
  3. Pencere sınırlarını ekran boyutlarını temel alarak sıfırlama.
  4. Pencere içeriğini yeni pencere boyutları temelinde yeniden çizme.

Bu sınıfın, SystemChrome="none" ve transparent="true" özelliklerine sahip olan bir AIR uygulamasının kök sınıfı olarak kullanılmak üzere tasarlandığını unutmayın. Bu sınıfı sistem kromuna sahip bir pencerede kullanmak için, pencere konumu ve boyutunu hesaplarken pencerenin krom kalınlığı ve minimum genişliğini dikkate almalısınız.

package
{
    import flash.display.Screen;
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.KeyboardEvent;
    import flash.geom.Rectangle;
    import flash.ui.Keyboard;

    public class DockingWindow extends Sprite
    {
        private const dockedWidth:uint = 80;
        private const dockedHeight:uint = 80;
        
        public function DockingWindow():void{
            stage.align = StageAlign.TOP_LEFT;
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.addEventListener(KeyboardEvent.KEY_DOWN,onKey);
            dockLeft();
        }
        
        private function onKey(event:KeyboardEvent):void{
            switch(event.keyCode){
                case Keyboard.LEFT :
                    dockLeft();
                    break;
                case Keyboard.RIGHT :
                    dockRight();
                    break;
                case Keyboard.UP :
                    dockTop();
                    break;
                case Keyboard.DOWN :
                    dockBottom();
                    break;
                case Keyboard.SPACE :
                    stage.nativeWindow.close();
            }    
        }
        
        public function dockLeft():void{
            var screen:Screen = getCurrentScreen();
            stage.nativeWindow.x = screen.visibleBounds.left;
            stage.nativeWindow.y = screen.visibleBounds.top;
            stage.nativeWindow.height = screen.visibleBounds.height;
            stage.stageWidth = dockedWidth;
            drawContent();
        }
        
        public function dockRight():void{
            var screen:Screen = getCurrentScreen();
            stage.nativeWindow.x = screen.visibleBounds.width - dockedWidth;            
            stage.nativeWindow.y = screen.visibleBounds.top;
            stage.stageWidth = dockedWidth;
            stage.nativeWindow.height = screen.visibleBounds.height;
            drawContent();
        }
        
        public function dockTop():void{
            var screen:Screen = getCurrentScreen();
            stage.nativeWindow.x = screen.visibleBounds.left;
            stage.nativeWindow.y = screen.visibleBounds.top;
            stage.nativeWindow.width = screen.visibleBounds.width;
            stage.stageHeight = dockedHeight;
            drawContent();
        }
        
        public function dockBottom():void{
            var screen:Screen = getCurrentScreen();
            stage.nativeWindow.x = screen.visibleBounds.left;
            stage.nativeWindow.y = screen.visibleBounds.height - dockedHeight;
            stage.nativeWindow.width = screen.visibleBounds.width;
            stage.stageHeight = dockedHeight;    
            drawContent();        
        }
        
        private function getCurrentScreen():Screen{
            return Screen.getScreensForRectangle(stage.nativeWindow.bounds)[0];
        }
        
        private function drawContent():void{
            const size:int = 60;
            const pad:int = 10;
            var numHSquares:int = Math.floor(stage.stageWidth/(size + pad));
            var numVSquares:int = Math.floor(stage.stageHeight/(size + pad));
            with (graphics){
                clear();
                lineStyle(1);
                beginFill(0x3462d5,.7);
                for(var i:int = 0; i < numHSquares; i++){
                    for(var j:int = 0; j < numVSquares; j++){                
                            drawRect((i * (size + pad)) + pad, (j * (size + pad)) + pad, size, size);
                    }
                }
                endFill();
            }
        }
    }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.