Paket | flash.text |
Sınıf | public final class StageText |
Miras Alma | StageText EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Bu sınıf, mobil uygulamaların yerel metin girişi kontrollerini kullanmak yoluyla kullanıcı girdilerini toplamalarına olanak sağlar. Mobil aygıtlardaki girdi kontrolleri genelde masaüstü bilgisayarlarda bulunmayan geniş kullanıcı arabirimlerine ve destekleyici davranışlara sahiptir. Örneğin birçok mobil aygıt aşağıdakine benzer veri girişi özelliklerini destekler:
- otomatik tamamlama
- otomatik düzeltme
- dokunma tabanlı metin seçimi
- özelleştirilebilen yazılım klavyeleri
Temel işletim sistemi (veya işletim sistemiyle birlikte gelen bir bileşen kütüphanesi), yerel metin girişi alanlarını çizer. Yerel metin girişi alanları, aynı aygıttaki diğer uygulamaları kullanmış olan herkes için tanıdık bir deneyim sağlar. Ancak, işletim sistemi oynatıcının yerine metin girişi alanlarını çizdiğinden gömülü fontları kullanamazsınız.
AIR profili desteği: Bu özellik iOS ve Android platformlarında desteklenir. StageText, Android ve iOS mobil aygıtlarında yerel metin girişi alanları kullanır. Diğer platformlarda StageText, Flash Çalışma Zamanı TextField'i kullanır.
Yerel girişler kullanıldığında, StageText nesneleri görüntüleme nesnesi olmaz ve onları Flash görüntüleme listesine ekleyemezsiniz. Bunun yerine, stage
özelliğini kullanıp doğrudan sahne alanına ekleyerek bir StageText nesnesini görüntülersiniz. Bir sahne alanına eklenen StageText örneği, Flash görüntüleme nesnelerinin üzerinde görüntülenir. viewPort
özelliğiyle görüntü oluşturma alanının boyutunu ve konumunu denetlersiniz. Farklı StageText nesnelerinin derinlik sıralamasını denetlemenin bir yolu yoktur. İki örneğin örtüşmesi önerilmeyen bir durumdur.
StageText nesnesi odağa sahip olduğunda ilk klavye girişini işleme fırsatını elde eder. StageText nesnesinin eklendiği sahne alanı herhangi bir klavye girişi olayı göndermez.
StageText sınıfı her platformda farklı bir yerel kontrolü sardığından, özellikleri her platformda farklı ölçüde desteklenir. Desteklendikleri durumlarda bile özellikler farklı platformlarda farklı şekilde davranabilirler. Belli bir platformda belli bir özelliği kullanmaya çalıştığınızda, davranışı test etmek en iyisidir. StageText davranışı yalnızca yerel kontrollerin kullanılmadığı masaüstü platformlarında Flash Çalışma Zamanı metin davranışıyla benzerlik gösterir.
Apple TV'de StageText varsayılan olarak odaklanıyor. Uygulamanızdaki farklı nesneler arasında odağı yönetmek için aşağıdaki noktalara dikkat edin:
- Varsayılan StageText odağını geçersiz kılmak veya başka bir görüntü nesnesine odak atamak için stage.focus seçeneğini kullanın
- StageText'e odak atamak için stageText.assignFocus() seçeneğini kullanın
Özellik | Tanımlayan: | ||
---|---|---|---|
autoCapitalize : String
Bir cihazın otomatik büyük harfe çevirme özelliğini kullanıcı girdisine nasıl uyguladığını kontrol eder. | StageText | ||
autoCorrect : Boolean
Bir aygıtın yazım veya noktalama hatalarında kullanıcı girdisini otomatik olarak düzeltip düzeltmediğini belirtir. | StageText | ||
clearButtonMode : String [salt yazılır]
Geçerli StageText Nesnesinin clearButton modu. | StageText | ||
color : uint
Metin rengini belirtir. | StageText | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
displayAsPassword : Boolean
Metin alanının bir şifre metin alanı olup olmadığını belirtir. | StageText | ||
editable : Boolean
Kullanıcının metin alanını düzenleyip düzenleyemeyeceğini belirtir. | StageText | ||
fontFamily : String
Geçerli font ailesinin adını belirtir. | StageText | ||
fontPosture : String
FontPosture sınıfında tanımlanan sabitleri kullanarak font duruşunu belirtir. | StageText | ||
fontSize : int
Geçerli font ailesi için piksel cinsinden boyut. | StageText | ||
fontWeight : String
FontWeight sınıfında tanımlanan sabitleri kullanarak font genişliğini belirtir. | StageText | ||
locale : String
Metnin yerel ayarını belirtir. | StageText | ||
maxChars : int
Kullanıcının metin alanına girebileceği maksimum karakter sayısını gösterir. | StageText | ||
multiline : Boolean [salt okunur]
StageText nesnesinin birden fazla metin satırı görüntüleyip görüntüleyemeyeceğini belirtir. | StageText | ||
restrict : String
Kullanıcının metin alanına girebileceği karakter setini sınırlar. | StageText | ||
returnKeyLabel : String
Yazılım klavyesi kullanan cihazlar için Return tuşunun üzerindeki etiketi belirtir. | StageText | ||
selectionActiveIndex : int [salt okunur]
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. | StageText | ||
selectionAnchorIndex : int [salt okunur]
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. | StageText | ||
softKeyboardType : String
Yazılım klavyesinin görünümünü kontrol eder. | StageText | ||
stage : Stage
Bu StageText nesnesinin görüntülendiği sahne alanı. | StageText | ||
text : String
Metin alanındaki geçerli metin. | StageText | ||
textAlign : String
Paragraf hizalamasını belirtir. | StageText | ||
viewPort : Rectangle
Sahne alanında StageText nesnesinin görüntülendiği bölge. | StageText | ||
visible : Boolean
StageText nesnesinin görünür olup olmadığını belirtir. | StageText |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Bir StageText nesnesi oluşturur. | StageText | ||
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 | ||
StageText nesnesine odak atar. | StageText | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
StageText nesnesini atar. | StageText | ||
StageText öğesinin görünüm bağlantı noktasını bir bitmap'e çizer. | StageText | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
İlk ve son karakterlerin dizin değerleri tarafından belirlenen metni seçer. | StageText | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
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 | ||
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 |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
Metin içeriği değiştikten sonra gönderilir. | StageText | |||
Null olmayan ve boş olmayan bir viewPort'u ayarladıktan sonra gönderilir. | StageText | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Kullanıcı metin düzenlerken ve kontrolün odağında klavye varken gönderilir. | StageText | |||
Kullanıcı metin düzenlemeyi bıraktığında ve kontrolün odağı artık klavye olmadığında gönderilir. | StageText | |||
Kullanıcı bir tuşa bastığında gönderilir. | StageText | |||
Kullanıcı bir tuşu bıraktığında gönderilir. | StageText | |||
StageText nesnesinin odağını bulması nedeniyle yazılım klavyesi etkinleştirildikten sonra gönderilir. | StageText | |||
StageText nesnesinin odağını bulması nedeniyle yazılım klavyesi etkinleştirilmeden önce gönderilir. | StageText | |||
StageText nesnesinin odağını kaybetmesi nedeniyle yazılım klavyesi devre dışı kaldıktan sonra gönderilir. | StageText |
autoCapitalize | özellik |
autoCapitalize:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Bir cihazın otomatik büyük harfe çevirme özelliğini kullanıcı girdisine nasıl uyguladığını kontrol eder. Geçerli değerler AutoCapitalize sınıfında sabitler olarak tanımlanır:
- "none"
- "word"
- "sentence"
- "all"
Her aygıt ve işletim sistemi bu işlevi desteklemediğinden, bu özellik yalnızca temel platform için bir ipucudur.
Not: Metin düzenlenirken veya farklı bir şekilde odaktayken autoCapitalize
öğesini etkinleştirirseniz, güncellenen davranış odak bırakılana ve yeniden oluşturulana dek uygulanmaz.
Varsayılan değer şudur AutoCapitalize.NONE.
Uygulama
public function get autoCapitalize():String
public function set autoCapitalize(value:String):void
Atar
ArgumentError — AutoCapitalize öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
autoCorrect | özellik |
autoCorrect:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Bir aygıtın yazım veya noktalama hatalarında kullanıcı girdisini otomatik olarak düzeltip düzeltmediğini belirtir.
Her aygıt ve işletim sistemi bu işlevi desteklemediğinden, bu özellik yalnızca temel platform için bir ipucudur.
Not: Metin düzenlenirken veya farklı bir şekilde odaktayken autoCorrect
öğesini etkinleştirirseniz, güncellenen davranış odak bırakılana ve yeniden oluşturulana dek uygulanmaz.
Varsayılan değer şudur false.
Uygulama
public function get autoCorrect():Boolean
public function set autoCorrect(value:Boolean):void
clearButtonMode | özellik |
clearButtonMode:String
[salt yazılır] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 23 |
Geçerli StageText Nesnesinin clearButton modu. Bu özellikle ilişkili dört mod vardır:
-
Düzenleme sırasında clearButton modunu göstermek için:
StageTextClearButtonMode.WHILE_EDITING
-
ClearButton modunu hiçbir zaman göstermemek için:
StageTextClearButtonMode.NEVER
-
ClearButton modunu her zaman göstermek için:
StageTextClearButtonMode.ALWAYS
-
Düzenleme dışında clearButton modunu göstermek için:
StageTextClearButtonMode.UNLESS_EDITING
clearButtonMode
özelliği StageTextClearButtonMode.WHILE_EDITING
olarak ayarlanır.
Not: Bu özellik yalnızca iOS için desteklenir.
Uygulama
public function set clearButtonMode(value:String):void
color | özellik |
color:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Metin rengini belirtir. Metin rengi, üç adet 8 bitlik RGB bileşeni içeren bir sayı olarak belirtilir. İlk bileşen kırmızıyı, ikinci bileşen yeşili, üçüncü bileşense maviyi temsil eder. Örneğin 0xFF0000
kırmızıyı, 0x00FF00
yeşili, 0x0000FF
ise maviyi belirtir. Varsayılan metin rengi siyahtır (0x000000
).
Varsayılan değer şudur 0x000000.
Uygulama
public function get color():uint
public function set color(value:uint):void
displayAsPassword | özellik |
displayAsPassword:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Metin alanının bir şifre metin alanı olup olmadığını belirtir. true
ise metin alanı, girdi karakterlerini bir yedek karakter kullanarak (örneğin bir yıldız işaretiyle) gizler.
Not: Metin düzenlenirken veya farklı bir şekilde odaktayken displayAsPassword
öğesini etkinleştirirseniz, güncellenen davranış odak bırakılana ve yeniden oluşturulana dek uygulanmaz.
Önemli: iOS'ta bu özelliğin değeri true
olsa bile çok satırlı bir sahne alanı metin nesnesi yedek karakterleri görüntülemez.
Varsayılan değer şudur false.
Uygulama
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
editable | özellik |
fontFamily | özellik |
fontFamily:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Geçerli font ailesinin adını belirtir. Null değeri, sistemin varsayılan fontunu belirtir. Kullanılabilir fontları numaralandırmak için flash.text.Font.enumerateFonts()
öğesini kullanın. Font ailesi bilinmiyorsa, varsayılan font ailesi kullanılır.
Varsayılan değer şudur null.
Uygulama
public function get fontFamily():String
public function set fontFamily(value:String):void
fontPosture | özellik |
fontPosture:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
FontPosture sınıfında tanımlanan sabitleri kullanarak font duruşunu belirtir.
Varsayılan değer şudur FontPosture.NORMAL.
Uygulama
public function get fontPosture():String
public function set fontPosture(value:String):void
Atar
ArgumentError — FontPosture öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
fontSize | özellik |
fontWeight | özellik |
fontWeight:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
FontWeight sınıfında tanımlanan sabitleri kullanarak font genişliğini belirtir.
Varsayılan değer şudur FontWeight.NORMAL.
Uygulama
public function get fontWeight():String
public function set fontWeight(value:String):void
Atar
ArgumentError — FontWeight öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
locale | özellik |
locale:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Metnin yerel ayarını belirtir. StageText standart yerel ayar kimliklerini kullanır. Örneğin "en", "en_US" ve "en-US" İngilizce iken, "ja" Japonca'dır. Yerel ayar kodlarının bir listesi için bkz. iso639-2 kod listesi.
Varsayılan değer şudur en.
Uygulama
public function get locale():String
public function set locale(value:String):void
maxChars | özellik |
maxChars:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcının metin alanına girebileceği maksimum karakter sayısını gösterir. Bir komut dosyası, maxChars
öğesinin izin verdiğinden daha fazla metin ekleyebilir. maxChars
değeri sıfıra eşitse, kullanıcının alana girebileceği metin miktarının sınırı yoktur.
Varsayılan değer şudur 0.
Uygulama
public function get maxChars():int
public function set maxChars(value:int):void
multiline | özellik |
multiline:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesinin birden fazla metin satırı görüntüleyip görüntüleyemeyeceğini belirtir. Salt okunur. Bu değer oluşturma sırasında kullanılan StageTextInitOptions nesnesindeki multiline
özelliğinin değeriyle eşleşir.
Uygulama
public function get multiline():Boolean
İlgili API Öğeleri
restrict | özellik |
restrict:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcının metin alanına girebileceği karakter setini sınırlar. Sistem restrict
dizesini soldan sağa doğru tarar.
restrict
öğesinin değeri, aşağıdaki metin girişi kısıtlama kurallarını belirtir:
- Değer
null
ise, kullanıcı tüm karakterleri girebilir. - Değer boş bir dizeyse, kullanıcı hiçbir karakter giremez.
- Değer bir karakter dizesiyse, kullanıcı yalnızca dizedeki karakterleri girebilir.
- Değer bir şapka işareti (^) içeriyorsa, kullanıcı şapka işaretinden sonraki karakterleri giremez.
- Değer, kısa tire (-) karakterini kullanarak izin verilebilen girdi karakterlerinin aralığını belirtebilir.
- Değer,
\u
kaçış dizisini kullanarak birrestrict
dizesi oluşturabilir.
Özel Karakterler:
Harfi harfine bir şapka işareti (^) veya kısa tire (-) girmek için bir ters eğik çizgi kullanın. Kabul edilen ters eğik çizgi sıraları \-, \^ ve \\ şeklindedir. Ters eğik çizgi dizede gerçek bir karakter olmalıdır. ActionScript'te bir ters eğik çizgi belirttiğinizde, çift ters eğik çizgi kullanın.
restrict
özelliği ayarlarına örnekler:
Aşağıdaki örnek, kullanıcının yalnızca kısa tire (-) ve şapka (^) karakterleri girmesine izin verir:
my_txt.restrict = "\\-\\^";
Aşağıdaki örnek, kullanıcının yalnızca büyük harf karakterler, boşluklar ve sayılar girmesine izin verir:
my_txt.restrict = "A-Z 0-9";
Aşağıdaki örnek yalnızca küçük harfleri hariç tutar:
my_txt.restrict = "^a-z";
Aşağıdaki örnek, kullanıcının yalnızca büyük harf girmesine izin verir ancak büyük Q harfini hariç tutar:
my_txt.restrict = "A-Z^Q";
Aşağıdaki örnek, kullanıcının yalnızca ASCII 32 (boşluk) ile ASCII 126 (tilde) arasındaki karakterleri girmesine izin verir.
my_txt.restrict = "\u0020-\u007E";
Not: Sınırlamalar yalnızca kullanıcı girdisi için geçerlidir, bir komut dosyası tüm karakterleri metin alanına ekleyebilir.
Varsayılan değer şudur null.
Uygulama
public function get restrict():String
public function set restrict(value:String):void
returnKeyLabel | özellik |
returnKeyLabel:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Yazılım klavyesi kullanan cihazlar için Return tuşunun üzerindeki etiketi belirtir. Kullanılabilir değerler, ReturnKeyLabel
sınıfında tanımlanan sabitlerdir.
- "default"
- "done"
- "go"
- "next"
- "search"
Her aygıt ve işletim sistemi bu değerleri desteklemediğinden, bu özellik yalnızca temel platform için bir ipucudur. Bu özelliğin yazılım klavyesi kullanmayan aygıtlarda bir etkisi yoktur.
Varsayılan değer şudur ReturnKeyLabel.DEFAULT.
Uygulama
public function get returnKeyLabel():String
public function set returnKeyLabel(value:String):void
Atar
ArgumentError — ReturnKeyLabel öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
selectionActiveIndex | özellik |
selectionActiveIndex:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. Örneğin ilk karakter 0, ikinci karakter 1 şeklinde devam eder.
Hiçbir metin seçili değilse bu yöntem bir ekleme noktası döndürür. StageText örneğinde odak yoksa bu yöntem -1 döndürür.
iOS'da bu özellik çok satırlı olmayan StageText nesneleri için desteklenmez ve -1 döndürür.
Uygulama
public function get selectionActiveIndex():int
İlgili API Öğeleri
selectionAnchorIndex | özellik |
selectionAnchorIndex:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. Örneğin ilk karakter 0, ikinci karakter 1 şeklinde devam eder.
Hiçbir metin seçili değilse bu yöntem bir ekleme noktası döndürür. StageText örneğinde odak yoksa bu yöntem -1 döndürür.
iOS'da bu özellik çok satırlı olmayan StageText nesneleri için desteklenmez ve -1 döndürür.
Uygulama
public function get selectionAnchorIndex():int
İlgili API Öğeleri
softKeyboardType | özellik |
softKeyboardType:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Yazılım klavyesinin görünümünü kontrol eder.
Yazılım klavyesi olan aygıtlar, istenen girdi türüyle eşleşmek için klavye düğmelerini özelleştirebilir. Örneğin sayısal bir girdi isteniyorsa, bir aygıt yazılım klavyesinde yalnızca sayıları görüntülemek için SoftKeyboardType.NUMBER
öğesini kullanabilir. Geçerli değerler SoftKeyboardType sınıfında sabitler olarak tanımlanır:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Bu değerler bir aygıtın geçerli işlem için en iyi klavyeyi görüntülemesini sağlamaya yardımcı olan ipuçlarıdır.
Varsayılan değer şudur SoftKeyboardType.DEFAULT.
Uygulama
public function get softKeyboardType():String
public function set softKeyboardType(value:String):void
Atar
ArgumentError — SoftKeyboardType öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
stage | özellik |
stage:Stage
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Bu StageText nesnesinin görüntülendiği sahne alanı.
Bu StageText nesnesini gizlemek için stage
öğesini null
olarak ayarlayın.
Varsayılan değer şudur null.
Uygulama
public function get stage():Stage
public function set stage(value:Stage):void
text | özellik |
text:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Metin alanındaki geçerli metin. Satırbaşı karakteri ('\r'
, ASCII 13) metin satırlarını ayırır. Bu özellik içindeki metin biçimlendirilmemiştir (biçimlendirme etiketleri yoktur).
Varsayılan değer şudur null.
Uygulama
public function get text():String
public function set text(value:String):void
textAlign | özellik |
textAlign:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Paragraf hizalamasını belirtir. Geçerli değerler TextFormatAlign sınıfında sabitler olarak tanımlanır:
- "left"
- "center"
- "right"
- "justify"
- "start"
- "end"
Tüm platformlar her textAlign
değerini desteklemez. Desteklenmeyen textAlign
değerleri için platformlar (TextFormatAlign.START
) varsayılan değerini kullanır.
Varsayılan değer şudur TextFormatAlign.START.
Uygulama
public function get textAlign():String
public function set textAlign(value:String):void
Atar
ArgumentError — TextFormatAlign öğesinin üyesi olmayan herhangi bir değere ayarlanırsa
|
İlgili API Öğeleri
viewPort | özellik |
viewPort:Rectangle
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Sahne alanında StageText nesnesinin görüntülendiği bölge. Varsayılan sıfır dikdörtgenidir.
Uygulama
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Atar
RangeError — Rectangle değeri geçerli değildir.
|
visible | özellik |
StageText | () | Yapıcı |
public function StageText(initOptions:flash.text:StageTextInitOptions = null)
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Bir StageText nesnesi oluşturur.
Bir sahne alanına eklenene ve viewPort
özelliği ayarlanana kadar StageText nesnesi görünmez durumda olur.
initOptions:flash.text:StageTextInitOptions (default = null )
|
assignFocus | () | yöntem |
public function assignFocus():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesine odak atar. Düzenlenemeyen nesneler için assignFocus()
öğesinin bir etkisi yoktur.
dispose | () | yöntem |
public function dispose():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesini atar.
dispose()
yönteminin çağrılması isteğe bağlıdır. Bu StageText örneğine giden bir başvuru yoksa örnek çöp toplama işlemine uygun hale gelir. dispose()
yönteminin çağrılması, çöp toplama işleminin daha erken veya daha uygun bir zamanda gerçekleşmesini sağlar.
drawViewPortToBitmapData | () | yöntem |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3.0 |
StageText öğesinin görünüm bağlantı noktasını bir bitmap'e çizer.
StageText nesnesinin yukarısında içeriği görüntülemek için bitmap'i yakalayın ve sahne alanını null
değerine ayarlayın.
Bitmap, görünüm bağlantı noktası ile genellikle aynı genişlik ve yüksekliğe sahiptir. AIR 15.0 itibariyle oynatıcı HiDPI ekranlarında olduğunda bitmap genişliği ve yüksekliği isteğe bağlı olarak görünüm bağlantı noktasının genişlik ve yüksekliğinden contentsScaleFactor
kat fazla olabilir. Örneğin bir Mac Retina Ekranında sahne piksel çözünürlüğü ikiye katlandığı için contentsScaleFactor
2'dir, bu nedenle bitmap buna karşılık olarak görünüm bağlantı noktası boyutunun iki katı olabilir.
Bu yöntemi Event.COMPLETE
olayından önce çağırırsanız yöntem, görünüm bağlantı noktasını yanlış çizebilir.
Parametreler
bitmap:BitmapData — StageText öğesinin görünüm bağlantı noktasının görünür kısmının çizileceği BitmapData nesnesi.
|
Atar
ArgumentError — Bitmap'in genişliği veya yüksekliği, görünüm bağlantı noktasının genişliğinden ya da yüksekliğinden farklıdır.
| |
Error — Bitmap null değerindedir.
|
selectRange | () | yöntem |
public function selectRange(anchorIndex:int, activeIndex:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
İlk ve son karakterlerin dizin değerleri tarafından belirlenen metni seçer. Seçimin ilk ve son karakterlerini anchorIndex
ile activeIndex
parametrelerinde belirlersiniz. Her iki parametre değeri de aynıysa, bu yöntem ekleme noktasını ayarlar.
iOS'da çok satırlı olmayan StageText nesneleri için bu işlev desteklenmez ve her zaman -1 döndürür. Tüm metin dizesini seçerek bu yöntemi çağırırsanız seçim görünür olur. Ancak, metin dizesinin bir alt kümesini seçerek bu yöntemi çağırırsanız seçim görünür olmaz.
Bazı cihazlar ve işletim sistemleri için seçim yalnızca StageText nesnesi odağa sahip olduğunda görünür.
Parametreler
anchorIndex:int — Seçimdeki ilk karakterin sıfır temelli dizin değeri (ilk karakterin dizin değeri 0'dır).
| |
activeIndex:int — Seçimdeki son karakterin sıfır temelli dizin değeri.
|
İlgili API Öğeleri
change | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.CHANGE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Metin içeriği değiştikten sonra gönderilir. Bu olay her değişiklikte veya bir değişiklik kümesi tamamlandığında gönderilebilir.
Event.CHANGE
sabiti, change
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Değerleri değiştirilen nesne. 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. |
complete | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.COMPLETE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Null olmayan ve boş olmayan bir viewPort'u ayarladıktan sonra gönderilir. Uygulamanın StageText nesnesini yerleştirmeyi bitirdiğini ve artık drawViewPortToBitmapData
yöntemini çağırabileceğinizi belirtir. Platforma bağlı olarak bu olay, stage
, viewPort
veya her iki öğe birden ayarlanarak eşzamanlı ya da eşzamansız bir şekilde gönderilebilir.
Event.COMPLETE
sabiti, complete
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 | Yüklemesi tamamlanan network nesnesi. |
focusIn | Olay |
flash.events.FocusEvent
özellik FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcı metin düzenlerken ve kontrolün odağında klavye varken gönderilir.
BirfocusIn
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | 0; yalnızca keyFocusChange olayları için geçerlidir. |
relatedObject | Odaktaki değişiklikten etkilenen tamamlayıcı bir InteractiveObject örneği. |
shiftKey | false ; yalnızca keyFocusChange olayları için geçerlidir. |
target | Henüz odağı alan InteractiveObject örneği. 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.
|
direction | Odağın atandığı yön. Bu özellik, sahnenin assignFocus() yöntemine ait direction parametresinin değerini bildirir. Odak diğer yollarla değiştirildiğinde, değer her zaman FocusDirection.NONE olacaktır. Yalnızca focusIn olayları için geçerlidir. Değer, tüm odak olayları için FocusDirection.NONE olacaktır. |
focusOut | Olay |
flash.events.FocusEvent
özellik FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcı metin düzenlemeyi bıraktığında ve kontrolün odağı artık klavye olmadığında gönderilir.
focusOut
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | 0; yalnızca keyFocusChange olayları için geçerlidir. |
relatedObject | Odaktaki değişiklikten etkilenen tamamlayıcı bir InteractiveObject örneği. |
shiftKey | false ; yalnızca keyFocusChange olayları için geçerlidir. |
target | Henüz odağı kaybeden InteractiveObject örneği. 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.
|
keyDown | Olay |
flash.events.KeyboardEvent
özellik KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcı bir tuşa bastığında gönderilir.
Tuşlar ile belirli karakterler arasındaki eşlemeler, aygıta ve işletim sistemine göre değişir. Bu tür bir eşleme gerçekleştikten sonra, ancak bir girdi yöntemi düzenleyicisi (IME) işlenmeden önce bu olay türü oluşturulur. IME'ler, standart QWERTY klavyelerin oluşturmaya uygun olmadığı karakterleri (örneğin Çin ideogramlarını) girmek için faydalıdır.
keyUp
olayından önce bu olay gerçekleşir.
Bu olay tüm tuşlar için gönderilmez. Bu olayın gönderilmesine neden olan tuşlar her platformda değişiklik gösterir.
AIR'de bu olayın iptal edilmesi, karakterin metin alanına girilmesini önler.
KeyboardEvent.KEY_DOWN
sabiti, keyDown
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | AIR'de true , Flash Player'da false ; AIR'de bu olay iptal edildiğinde karakterin bir metin alanına girilmesi engellenir. |
charCode | Basılan veya bırakılan tuşun karakter kod değeri. |
commandKey | Mac'te Command tuşu etkinse true . Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Mac'te Control tuşu etkinse true . Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Ctrl veya Command tuşu etkin olduğunda Mac'te true . Aksi takdirde, false . |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true ; etkin değilse false . |
target | Odaklı InteractiveObject örneği 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. |
keyUp | Olay |
flash.events.KeyboardEvent
özellik KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
Kullanıcı bir tuşu bıraktığında gönderilir.
Tuşlar ile belirli karakterler arasındaki eşlemeler, aygıta ve işletim sistemine göre değişir. Bu tür bir eşleme gerçekleştikten sonra, ancak bir girdi yöntemi düzenleyicisi (IME) işlenmeden önce bu olay türü oluşturulur. IME'ler, standart QWERTY klavyelerin oluşturmaya uygun olmadığı karakterleri (örneğin Çin ideogramlarını) girmek için kullanılır.
Bu olay, bir keyDown
olayından sonra gerçekleşir.
Bu olay tüm tuşlar için gönderilmez. Bu olayın gönderilmesine neden olan tuşlar her platformda değişiklik gösterir.
KeyboardEvent.KEY_UP
sabiti, keyUp
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
charCode | Basılan veya bırakılan tuşun karakter kod değerini içerir. |
commandKey | Mac'te Command tuşu etkinse true . Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true . Mac'te Control tuşu etkinse true . Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows'ta true . Ctrl veya Command tuşu etkin olduğunda Mac'te true . Aksi takdirde, false . |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true ; etkin değilse false . |
target | Odaklı InteractiveObject örneği 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. |
softKeyboardActivate | Olay |
flash.events.SoftKeyboardEvent
özellik SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesinin odağını bulması nedeniyle yazılım klavyesi etkinleştirildikten sonra gönderilir.
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
sabiti, bir sanal klavye görüntülendiğinde SoftKeyboardEvent nesnesinin type
özelliğinin değerini tanımlar. Bu olay için, cancellable = false
.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
relatedObjectVal | Olay ile ilgili bir ekran listesi nesnesine başvuru. |
triggerTypeVal | Klavye olayının bir uygulama mı yoksa kullanıcı mı tarafından tetiklendiğini belirtir. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
softKeyboardActivating | Olay |
flash.events.SoftKeyboardEvent
özellik SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesinin odağını bulması nedeniyle yazılım klavyesi etkinleştirilmeden önce gönderilir.
SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
sabiti, bir sanal klavye görüntülenmeden hemen önce SoftKeyboardEvent nesnesinin type
özelliğinin değerini tanımlar. Bu olay için, cancellable = true
.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | Olay, bir StageText nesnesi tarafından gönderilmedikçe true . StageText nesneleri için olay iptal edilebilir değildir. |
relatedObjectVal | Olay ile ilgili bir ekran listesi nesnesine başvuru. |
triggerTypeVal | Klavye olayının bir uygulama mı yoksa kullanıcı mı tarafından tetiklendiğini belirtir. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
softKeyboardDeactivate | Olay |
flash.events.SoftKeyboardEvent
özellik SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3 |
StageText nesnesinin odağını kaybetmesi nedeniyle yazılım klavyesi devre dışı kaldıktan sonra gönderilir.
SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
sabiti, bir sanal klavye indirildiğinde veya gizlendiğinde SoftKeyboardEvent nesnesinin type
özelliğinin değerini tanımlar. Bu olay için, cancellable = false
.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
relatedObjectVal | Olay ile ilgili bir ekran listesi nesnesine başvuru. |
triggerTypeVal | Klavye olayının bir uygulama mı yoksa kullanıcı mı tarafından tetiklendiğini belirtir. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
Tue Jun 12 2018, 01:09 PM Z