| Paket | flash.text |
| Sınıf | public class TextSnapshot |
| Miras Alma | TextSnapshot  Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Yapıcıyı bir TextSnapshot nesnesi oluşturmak için kullanmayın; flash.display.DisplayObjectContainer.textSnapshot özelliği tarafından döndürülür.
İlgili API Öğeleri
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
| charCount : int [salt okunur]
Bir TextSnapshot nesnesindeki karakter sayısı. | TextSnapshot | ||
 | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
Belirtilen TextSnapshot nesnesini arar ve textToFind değerinin beginIndex öğesinde veya ondan sonra bulunan ilk görüldüğü yerin konumunu döndürür. | TextSnapshot | ||
Bir TextSnapshot nesnesinin belirtilen aralıkta seçili metin içerip içermediğini belirten bir Boolean değeri döndürür. | TextSnapshot | ||
Karşılık gelen setSelected() yöntemi ile belirtilen tüm karakterleri içeren bir dize döndürür. | TextSnapshot | ||
beginIndex ve endIndex parametreleri ile belirtilen karakterlerin tümünü içeren bir dize döndürür. | TextSnapshot | ||
Bir metin öbeği hakkında bilgi içeren bir nesne dizisi döndürür. | TextSnapshot | ||
|
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | |
Bir TextSnapshot nesnesindeki hangi karakterin, TextSnapshot nesnesindeki metnin bulunduğu film klibinin belirtilen x ve y koordinatlarında veya bu koordinatlara daha yakın olduğunu belirlemenizi sağlar. | TextSnapshot | ||
|
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 | |
|
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
setSelected() yöntemiyle seçilen karakterleri vurgularken kullanılacak rengi belirtir. | TextSnapshot | ||
TextSnapshot nesnesinde seçilecek veya seçimi kaldırılacak karakterlerin aralığını belirtir. | TextSnapshot | ||
|
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 | |
charCount | özellik |
findText | () | yöntem |
public function findText(beginIndex:int, textToFind:String, caseSensitive:Boolean):int| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirtilen TextSnapshot nesnesini arar ve textToFind değerinin beginIndex öğesinde veya ondan sonra bulunan ilk görüldüğü yerin konumunu döndürür. textToFind bulunmazsa, yöntem -1 değerini döndürür.
Parametreler
beginIndex:int — Belirtilen metni aramaya yönelik başlangıç konumunu belirtir.
| |
textToFind:String — Aranacak metni belirtir. String türünün bir değişkeni yerine değişmez bir dize belirtirseniz, dizeyi tırnak işaretlerinin arasına alın.
| |
caseSensitive:Boolean — Metnin, textToFind öğesindeki dizenin durumuyla eşleşmesi gerekip gerekmediğini belirtir.
|
int — Belirtilen metnin ilk görüldüğü yerin sıfır tabanlı dizini veya -1.
|
İlgili API Öğeleri
getSelected | () | yöntem |
public function getSelected(beginIndex:int, endIndex:int):Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir TextSnapshot nesnesinin belirtilen aralıkta seçili metin içerip içermediğini belirten bir Boolean değeri döndürür.
Tüm karakterleri aramak için start parametresine bir 0 değeri ve end parametresine bir charCount değeri (veya daha büyük herhangi bir sayı) iletin. Tek bir karakteri aramak için, end parametresine start parametresinden bir büyük olan bir değer iletin.
Parametreler
beginIndex:int — İncelenecek ilk karakterin konumunu gösterir. beginIndex için geçerli değerler 0 ile TextSnapshot.charCount - 1 arasındadır. beginIndex negatif bir değerse, 0 kullanılır.
| |
endIndex:int — İncelenecek son karakterin dizininden bir büyük olan değer. endIndex için geçerli değerler, 0 ile charCount arasındaki değerlerdir. endIndex parametresi tarafından dizine alınan karakter, dışa aktarılan dizede bulunmaz. Bu parametre atlanırsa, charCount kullanılır. Bu değer beginIndex değerinden küçükse veya bu değere eşitse, beginIndex + 1 kullanılır.
|
Boolean — Bir Boolean, belirtilen aralıktaki en az bir karakterin karşılık gelen setSelected() yöntemi tarafından seçilip (true) seçilmediğini (false) gösterir.
|
İlgili API Öğeleri
getSelectedText | () | yöntem |
public function getSelectedText(includeLineEndings:Boolean = false):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Karşılık gelen setSelected() yöntemi ile belirtilen tüm karakterleri içeren bir dize döndürür. Herhangi bir karakter belirtilmemişse (setSelected() yöntemi tarafından), boş bir dize gönderilir.
includeLineEndings için true değerini iletirseniz, döndürülen dizeye yeni satır karakterleri eklenir ve döndürülen dize girdi aralığından daha uzun olabilir. includeLineEndings öğesinin değeri false ise veya atlanırsa, yöntem herhangi bir karakter eklemeden seçili metni döndürür.
Parametreler
includeLineEndings:Boolean (default = false)false şeklindedir.
|
String — Karşılık gelen setSelected() yöntemi ile belirtilen tüm karakterleri içeren bir dize döndürür.
|
İlgili API Öğeleri
getText | () | yöntem |
public function getText(beginIndex:int, endIndex:int, includeLineEndings:Boolean = false):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9., Flash Lite 4 |
beginIndex ve endIndex parametreleri ile belirtilen karakterlerin tümünü içeren bir dize döndürür. Herhangi bir karakter seçilmemişse boş bir dize döndürülür.
Tüm karakterleri döndürmek için beginIndex parametresine 0 değeri ve endIndex parametresine bir charCount değeri (veya daha büyük herhangi bir sayı) iletin. Tek bir karakter döndürmek için endIndex parametresine bir beginIndex + 1 değeri iletin.
includeLineEndings için bir true değeri iletirseniz, yeni satır karakterleri döndürülen dizede uygun yerlere yerleştirilir. Bu durumda, döndürülen dize girdi aralığından daha uzun olabilir. includeLineEndings öğesinin değeri false ise veya atlanırsa, seçili metin herhangi bir karakter eklenmeden döndürülür.
Parametreler
beginIndex:int — Döndürülen dizeye dahil edilecek ilk karakterin konumunu gösterir. beginIndex için geçerli değerler 0 ile charCount - 1 arasındadır. beginIndex negatif bir değerse, 0 kullanılır.
| |
endIndex:int — İncelenecek son karakterin dizininden bir büyük olan değer. endIndex için geçerli değerler, 0 ile charCount arasındaki değerlerdir. endIndex parametresi tarafından dizine alınan karakter, dışa aktarılan dizede bulunmaz. Bu parametre atlanırsa, charCount kullanılır. Bu değer beginIndex değerinden küçükse veya bu değere eşitse, beginIndex + 1 kullanılır.
| |
includeLineEndings:Boolean (default = false)true) veya eklenmediğini (false) belirten isteğe bağlı bir Boolean değeri. Varsayılan değer false şeklindedir.
|
String — Belirtilen dizedeki karakterleri içeren bir dize veya belirtilen aralıkta herhangi bir karakter yoksa boş bir dize.
|
İlgili API Öğeleri
getTextRunInfo | () | yöntem |
public function getTextRunInfo(beginIndex:int, endIndex:int):Array| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir metin öbeği hakkında bilgi içeren bir nesne dizisi döndürür. Her nesne, iki yöntemli parametreler tarafından belirtilen karakter aralığındaki bir karaktere karşılık gelir.
Not: Geniş bir metin aralığı için getTextRunInfo() yönteminin kullanılması büyük bir nesneyi döndürebilir. Adobe, beginIndex ve endIndex parametreleri tarafından tanımlanan metin aralığını sınırlamayı önerir.
Parametreler
beginIndex:int — Bir TextSnapshot nesnesindeki karakter aralığında bulunan ilk karakterin dizin değeri.
| |
endIndex:int — Bir TextSnapshot nesnesindeki karakter aralığında bulunan son karakterin dizin değeri.
|
Array — Her nesnenin beginIndex ve endIndex parametreleri tarafından belirtilen karakter aralığında belirli bir karakter hakkında bilgi içerdiği bir nesne dizisi. Her nesne şu on bir özelliği içerir:
|
İlgili API Öğeleri
hitTestTextNearPos | () | yöntem |
public function hitTestTextNearPos(x:Number, y:Number, maxDistance:Number = 0):Number| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9., Flash Lite 4 |
Bir TextSnapshot nesnesindeki hangi karakterin, TextSnapshot nesnesindeki metnin bulunduğu film klibinin belirtilen x ve y koordinatlarına daha yakın olduğunu belirlemenizi sağlar.
Bunu atlarsanız veya maxDistance için 0 değerini iletirseniz, x, y koordinatları tarafından belirtilen konum TextSnapshot nesnesinin sınırlama kutusu içinde olmalıdır.
Bu yöntem, yalnızca karakter ölçüm bilgilerini içeren fontlarla düzgün çalışır ancak, Flash geliştirme aracı varsayılan olarak statik metin alanları için bu bilgileri içermez. Bu nedenle, bu yöntem bir dizin değeri yerine -1 değerini döndürebilir. Bir dizin değerinin döndürüldüğünden emin olmak için Flash geliştirme aracının bir fonta yönelik karakter ölçüm bilgilerini içermesini sağlayabilirsiniz. Bu işlemi gerçekleştirmek için fontu kullanan dinamik bir metin alanı ekleyin, bu dinamik metin alanına yönelik Karakter Seçenekleri'ni belirleyin ve ardından font ana hatlarını en az bir karaktere gömülü olacak şekilde belirleyin. (Belirttiğiniz karakterin veya bu karakterlerin statik metin alanlarında kullanılıp kullanılmamasının bir önemi yoktur.)
Parametreler
x:Number — Metni içeren film klibinin x koordinatını temsil eden metin.
| |
y:Number — Metni içeren film klibinin y koordinatını temsil eden metin.
| |
maxDistance:Number (default = 0)x, y koordinatından maksimum mesafeyi temsil eden isteğe bağlı bir sayı. Mesafe, her karakterin merkez noktasından ölçülür. Varsayılan değer 0'dır.
|
Number — Belirtilen x, y koordinatına en yakın karakterin dizin değerini temsil eden bir sayı. Herhangi bir karakter bulunmazsa veya font karakter ölçüm bilgilerini içermiyorsa -1 değerini döndürür.
|
İlgili API Öğeleri
setSelectColor | () | yöntem |
public function setSelectColor(hexColor:uint = 0xFFFF00):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9., Flash Lite 4 |
setSelected() yöntemiyle seçilen karakterleri vurgularken kullanılacak rengi belirtir. Renk her zaman opaktır; bir saydamlık değeri belirtemezsiniz.
Bu yöntem, yalnızca karakter ölçüm bilgilerini içeren fontlarla düzgün çalışır ancak, Flash geliştirme aracı varsayılan olarak statik metin alanları için bu bilgileri içermez. Bu nedenle, bu yöntem bir dizin değeri yerine -1 değerini döndürebilir.Bir dizin değerinin döndürüldüğünden emin olmak için Flash geliştirme aracının bir fonta yönelik karakter ölçüm bilgilerini içermesini sağlayabilirsiniz. Bu işlemi gerçekleştirmek için fontu kullanan dinamik bir metin alanı ekleyin, bu dinamik metin alanına yönelik Karakter Seçenekleri'ni belirleyin ve ardından font anahatlarını en az bir karaktere gömülü olacak şekilde belirleyin. (Belirttiğiniz karakterin veya bu karakterlerin statik metin alanlarında kullanılıp kullanılmamasının bir önemi yoktur.)
Parametreler
hexColor:uint (default = 0xFFFF00)setSelected() komutuyla seçilmiş karakterlerin etrafına yerleştirilmiş kenarlık için kullanılan, onaltılık biçimde (0xRRGGBB) belirtilmiş renk.
|
İlgili API Öğeleri
setSelected | () | yöntem |
public function setSelected(beginIndex:int, endIndex:int, select:Boolean):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9., Flash Lite 4 |
TextSnapshot nesnesinde seçilecek veya seçimi kaldırılacak karakterlerin aralığını belirtir. Seçilen karakterler arkalarında renkli ve karakterin sınırlama kutusuyla eşleşen bir dikdörtgenle birlikte çizilir. Sınırlama kutusunun rengi setSelectColor() tarafından tanımlanır.
Tüm karakterleri seçmek veya seçimlerini kaldırmak için beginIndex parametresine 0 değeri ve endIndex parametresine bir charCount değeri (veya daha büyük herhangi bir sayı) iletin. Tek bir karakter belirtmek için endIndex parametresine bir start + 1 değeri iletin.
Karakterler ayrı ayrı seçili olarak işaretleneceğinden birden çok karakteri seçmek için bu yöntem birden çok kez çağırabilirsiniz; yani bu yöntemin kullanılması bu yöntem tarafından ayarlanmış diğer karakterlerin seçimini kaldırmaz.
Bir seçimi gösteren renkli bir dikdörtgen yalnızca, karakter ölçüm bilgilerini içeren fontlar için görüntülenir. Flash Player varsayılan olarak statik metin alanları için bu bilgileri içermez. Bazı durumlarda bu yöntem, seçilmiş olan metnin ekran üzerinde seçili olarak görülmeyeceği anlamına gelir. Seçilen metnin tamamının seçili olarak göründüğünden emin olmak için, Flash geliştirme aracının bir fonta yönelik karakter ölçüm bilgilerini içermesini sağlayabilirsiniz. Bu işlemi gerçekleştirmek için fontu kullanan dinamik bir metin alanı ekleyin, bu dinamik metin alanına yönelik Karakter Seçenekleri'ni belirleyin ve ardından font ana hatlarını en az bir karaktere gömülü olacak şekilde belirleyin. (Belirttiğiniz karakterin veya bu karakterlerin söz konusu statik metin alanlarında kullanılıp kullanılmamasının bir önemi yoktur.)
Parametreler
beginIndex:int — Seçilecek ilk karakterin konumunu gösterir. beginIndex için geçerli değerler 0 ile charCount - 1 arasındadır. beginIndex negatif bir değerse, 0 kullanılır.
| |
endIndex:int — İncelenecek son karakterin dizininden 1 fazla olan bir tam sayı. end için geçerli değerler, 0 ile charCount arasındadır. end parametresi tarafından dizine alınan karakter, dışa aktarılan dizede bulunmaz. Bu parametreyi atlarsanız, TextSnapshot.charCount kullanılır. beginIndex değeri endIndex değerinden küçükse veya bu değere eşitse, beginIndex + 1kullanılır.
| |
select:Boolean — Metnin seçilip (true) seçilmeyeceğini (false) belirten bir Boolean değeri.
|
İlgili API Öğeleri
Tue Jun 12 2018, 01:09 PM Z