Paket | flash.text |
Sınıf | public class TextField |
Miras Alma | TextField InteractiveObject DisplayObject EventDispatcher Object |
Alt Sınıflar | FlexTextField |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dinamik olarak bir metin alanı oluşturmak için TextField()
yapıcısını oluşturun.
TextField sınıfının yöntemleri geliştirme veya çalışma zamanı sırasında oluşturduğunuz dinamik veya girdi metin alanındaki metni ayarlamanızı, seçmenizi ve bu metne müdahale etmenizi sağlar.
ActionScript, metninizi çalışma zamanında biçimlendirmeniz için çeşitli yöntemler sağlar. TextFormat sınıfı, TextField nesneleri için karakter ve paragraf biçimlendirmesini ayarlamanızı sağlar. Basamaklı Stil Sayfalarının (CSS) stillerini metin alanlarına TextField.styleSheet
özelliğini ve StyleSheet sınıfını kullanarak uygulayabilirsiniz. Yerleşik HTML etiketlerine stil vermek, yeni biçimlendirme etiketlerini tanımlamak veya stilleri uygulamak için CSS'yi kullanabilirsiniz. İsteğe bağlı olarak CSS stillerini kullanan HTML biçimli metni doğrudan bir metin alanına atayabilirsiniz. Bir metin alanına atadığınız HTML metni gömülü medya (film klipleri, SWF dosyaları, GIF dosyaları, PNG dosyaları ve JPEG dosyaları) içerebilir. Metin, gömülü medyanın etrafında, bir web tarayıcısının, metni bir HTML belgesindeki gömülü ortamın etrafında sardığı şekilde sarılır.
Flash Player, metni biçimlendirmek için kullanabileceğiniz HTML etiketlerinin bir alt kümesini destekler. Desteklenen HTML etiketlerinin bir listesi için htmlText
özelliğinin açıklamasına bakın.
İ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 | ||
alpha : Number
Belirtilen nesnenin alfa saydamlık değerini gösterir. | DisplayObject | ||
alwaysShowSelection : Boolean
true olarak ayarlandığında ve metin alanı odakta olmadığında, Flash Player metin alanındaki seçimi gri renkte vurgular. | TextField | ||
antiAliasType : String
Bu metin alanı için kullanılan yumuşatma türü. | TextField | ||
autoSize : String
Metin alanlarının otomatik boyutlandırılmasını veya hizalanmasını kontrol eder. | TextField | ||
background : Boolean
Metin alanının arka plan dolgusu olup olmadığını belirtir. | TextField | ||
backgroundColor : uint
Metin alanı arka planının rengi. | TextField | ||
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 | ||
border : Boolean
Metin alanının kenarlığı olup olmadığını belirtir. | TextField | ||
borderColor : uint
Metin alanı kenarlığının rengi. | TextField | ||
bottomScrollV : int [salt okunur]
Belirtilen metin alanında halen görünür durumda olan en alt satırı gösteren bir tam sayı (1 temelli dizin). | TextField | ||
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 | ||
caretIndex : int [salt okunur]
Ekleme noktası (düzeltme) konumunun dizini. | TextField | ||
condenseWhite : Boolean
İçinde HTML metni bulunan bir metin alanından ekstra beyaz boşlukların (boşluk, satır kesmeler vb.) kaldırılıp kaldırılmayacağını gösteren bir Boolean değeri. | TextField | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
contextMenu : NativeMenu
Bu nesneyle ilişkilendirilen bağlam menüsünü belirtir. | InteractiveObject | ||
defaultTextFormat : flash.text:TextFormat
Kullanıcı tarafından girilen metin veya replaceSelectedText() yöntemiyle eklenen metin gibi, yeni eklenen metine uygulanan biçimi belirtir. | TextField | ||
displayAsPassword : Boolean
Metin alanının bir şifre metin alanı olup olmadığını belirtir. | TextField | ||
doubleClickEnabled : Boolean
Nesnenin doubleClick olaylarını alıp almadığını belirtir. | InteractiveObject | ||
embedFonts : Boolean
Gömülü font anahatları kullanılarak oluşturulup oluşturulmayacağını belirtir. | TextField | ||
filters : Array
Geçerli olarak görüntüleme nesnesiyle ilişkilendirilmiş her filtre nesnesini içeren dizinli bir dizi. | DisplayObject | ||
focusRect : Object
Bu nesnenin bir odak dikdörtgeni görüntüleyip görüntülemediğini belirtir. | InteractiveObject | ||
gridFitType : String
Bu metin alanı için kullanılan ızgara sığdırma türü. | TextField | ||
height : Number
Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. | DisplayObject | ||
htmlText : String
Metin alanının içeriğinin HTML temsilini içerir. | TextField | ||
length : int [salt okunur]
Bir metin alanındaki karakter sayısı. | TextField | ||
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 | ||
maxChars : int
Metin alanının içerebileceği, kullanıcı tarafından girilen maksimum karakter sayısı. | TextField | ||
maxScrollH : int [salt okunur]
scrollH'nin maksimum değeri. | TextField | ||
maxScrollV : int [salt okunur]
scrollV'nin maksimum değer. | TextField | ||
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 | ||
mouseEnabled : Boolean
Bu nesnenin fare veya diğer kullanıcı girdisi iletileri alıp almadığını belirtir. | InteractiveObject | ||
mouseWheelEnabled : Boolean
Flash Player'ın, kullanıcı bir metin alanını tıklatıp fare tekerleğini döndürdüğünde çok satırlı metin alanlarını otomatik olarak kaydırıp kaydırmayacağını gösteren Boolean değeri. | TextField | ||
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 | ||
multiline : Boolean
Alanın çok satırlı bir metin alanı olup olmadığını belirtir. | TextField | ||
name : String
DisplayObject öğesinin örnek adını belirtir. | DisplayObject | ||
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 | ||
numLines : int [salt okunur]
Çok satırlı bir metin alanındaki metin satır sayısını tanımlar. | TextField | ||
opaqueBackground : Object
Görüntüleme nesnesinin belirli bir arka plan rengiyle opak olup olmadığını belirtir. | DisplayObject | ||
parent : DisplayObjectContainer [salt okunur]
Bu görüntüleme nesnesini içeren DisplayObjectContainer nesnesini belirtir. | DisplayObject | ||
restrict : String
Metin alanına kullanıcının girebileceği karakter setini gösterir. | TextField | ||
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 | ||
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 | ||
scrollH : int
Geçerli yatay kaydırma konumu. | TextField | ||
scrollRect : Rectangle
Görüntüleme nesnesinin kaydırma dikdörtgeni sınırları. | DisplayObject | ||
scrollV : int
Metnin metin alanındaki dikey konumu. | TextField | ||
selectable : Boolean
Metin alanının seçilebilir olup olmadığını gösteren Boolean değeri. | TextField | ||
selectionBeginIndex : int [salt okunur]
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. | TextField | ||
selectionEndIndex : int [salt okunur]
Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri. | TextField | ||
sharpness : Number
Bu metin alanındaki glif kenarlarının keskinliği. | TextField | ||
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 | ||
stage : Stage [salt okunur]
Görüntüleme nesnesinin Sahne Alanı. | DisplayObject | ||
styleSheet : StyleSheet
Metin alanına bir stil sayfası iliştirir. | TextField | ||
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 | ||
text : String
Metin alanındaki geçerli metin olan dize. | TextField | ||
textColor : uint
Metin alanındaki metnin onaltılık biçimde rengi. | TextField | ||
textHeight : Number [salt okunur]
Metnin piksel olarak yüksekliği. | TextField | ||
textInteractionMode : String [salt okunur]
Etkileşim modu özelliği, Varsayılan değer TextInteractionMode.NORMAL olur. | TextField | ||
textWidth : Number [salt okunur]
Metnin piksel olarak genişliği. | TextField | ||
thickness : Number
Bu metin alanındaki glif kenarlarının kalınlığı. | TextField | ||
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 | ||
type : String
Metin alanının türü. | TextField | ||
useRichTextClipboard : Boolean
Metinle birlikte metin biçimlendirmesinin de kopyalanıp kopyalanmayacağını ve yapıştırılıp yapıştırılmayacağını belirtir. | TextField | ||
visible : Boolean
Görüntüleme nesnesinin görünür olup olmadığı. | DisplayObject | ||
width : Number
Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. | DisplayObject | ||
wordWrap : Boolean
Metin alanında kelime kaydırma olup olmadığını gösteren Boolean değeri. | TextField | ||
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: | ||
---|---|---|---|
Yeni TextField örneği oluşturur. | TextField | ||
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 | ||
newText parametresi tarafından belirtilen dizeyi metin alanındaki metnin sonuna ekler. | TextField | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
Görüntüleme nesnesinin alanını targetCoordinateSpace nesnesinin koordinat sistemine göre tanımlayan bir dikdörtgen döndürür. | DisplayObject | ||
Karakterin sınırlama kutusu olan bir dikdörtgen döndürür. | TextField | ||
x ve y parametreleri tarafından belirtilen noktadaki karakterin sıfır temelli dizin değerini döndürür. | TextField | ||
Bir karakter dizini belirtilirse, aynı paragraftaki ilk karakterin dizinini döndürür. | TextField | ||
<img> etiketini kullanarak, belirli bir kimlik, HTML biçimli metin alanına eklenmiş bir görüntü veya SWF dosyası için bir DisplayObject başvurusu döndürür. | TextField | ||
x ve y parametreleri tarafından belirtilen noktadaki satırın sıfır temelli dizin değerini döndürür. | TextField | ||
charIndex parametresinin belirttiği karakteri içeren satırın sıfır temelli dizin değerini döndürür. | TextField | ||
Belirli bir metin satırındaki karakter sayısını döndürür. | TextField | ||
Belirli bir metin satırı hakkındaki ölçüm bilgilerini döndürür. | TextField | ||
lineIndex parametresinin belirttiği satırdaki ilk karakterin karakter dizinini döndürür. | TextField | ||
Satırın lineIndex parametresi tarafından belirtilen metnini döndürür. | TextField | ||
Bir karakter dizini belirtilirse, belirtilen karakteri içeren paragraf uzunluğu döndürülür. | TextField | ||
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 | ||
beginIndex ve endIndex parametrelerinin belirttiği metin aralığına yönelik biçimlendirme bilgileri içeren bir TextFormat nesnesi döndürür. | TextField | ||
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 | ||
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 | ||
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 | ||
[statik]
Bir gömülü font, Font.fontType öğesinin flash.text.FontType.EMBEDDED olduğu belirli fontName ve fontStyle ile mevcutsa true değeri döndürülür. | TextField | ||
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 | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Geçerli seçimi, değer parametresinin içeriği ile değiştirir. | TextField | ||
beginIndex ve endIndex parametrelerinin newText parametresinin içeriğini belirttiği karakter aralığını değiştirir. | TextField | ||
Sanal bir klavye yükseltir. | InteractiveObject | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
beginIndex ve endIndex parametreleriyle belirlenen ilk ve son karakterin diziniyle saptanan metni seçilmiş olarak ayarlar. | TextField | ||
format parametresinin belirttiği metin biçimlendirmesini bir metin alanında belirtilen metne uygular. | TextField | ||
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 | |||
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 | |||
Bir denetim değeri değiştirilmeden önce gönderilen textInput olayının aksine, değer değiştirildikten sonra gönderilir. | TextField | |||
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 | |||
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ı, URL'nin "event:" ile başladığı, HTML özelliği etkinleştirilmiş bir metin alanındaki bir köprüyü tıklattığında gönderilir. | TextField | |||
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 | |||
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 | |||
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 | |||
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ı kaydırma yaptıktan sonra bir TextField nesnesi tarafından gönderilir. | TextField | |||
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 | |||
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 | |||
Kullanıcı bir veya birden çok metin karakteri girdiğinde Flash Player, textInput olayını gönderir. | TextField | |||
Kullanıcı bir metin alanının etkileşim modunu değiştirdiğinde, Flash Player, textInteractionModeChange olayını gönderir. | TextField | |||
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 |
alwaysShowSelection | özellik |
alwaysShowSelection:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
true
olarak ayarlandığında ve metin alanı odakta olmadığında, Flash Player metin alanındaki seçimi gri renkte vurgular. false
olarak ayarlandığında ve metin alanı odakta olmadığında, Flash Player metin alanındaki seçimi vurgulamaz.
Varsayılan değer şudur false.
Uygulama
public function get alwaysShowSelection():Boolean
public function set alwaysShowSelection(value:Boolean):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_alwaysShowSelection extends Sprite { public function TextField_alwaysShowSelection() { var label1:TextField = createCustomTextField(0, 20, 200, 20); label1.text = "This text is selected."; label1.setSelection(0, 9); label1.alwaysShowSelection = true; var label2:TextField = createCustomTextField(0, 50, 200, 20); label2.text = "Drag to select some of this text."; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
antiAliasType | özellik |
antiAliasType:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu metin alanı için kullanılan yumuşatma türü. Bu özellik için flash.text.AntiAliasType
sabitlerini kullanın. Bu ayarı yalnızca fontun gömülü olması (embedFonts
özelliği true
olarak ayarlanmış şekilde) durumunda denetleyebilirsiniz. Varsayılan değer flash.text.AntiAliasType.NORMAL
şeklindedir.
Bu özelliğin değerlerini ayarlamak için, aşağıdaki dize değerlerini kullanın:
Dize değeri | Açıklama |
---|---|
flash.text.AntiAliasType.NORMAL | Normal metin yumuşatmasını uygular. Bu değer, Flash Player 7 ve önceki sürümlerin kullandığı yumuşatma türüyle eşleşir. |
flash.text.AntiAliasType.ADVANCED | Metni daha okunabilir kılan gelişmiş yumuşatma uygular. (Bu özellik Flash Player 8'de kullanılmaya başladı.) Gelişmiş yumuşatma, boyutu küçük font yüzlerinin yüksek kalitede oluşturulmasını sağlar. En iyi şekilde, çok sayıda küçük metne sahip olan uygulamalarla kullanılabilir. 48 noktadan büyük fontlar için gelişmiş yumuşatma önerilmez. |
Uygulama
public function get antiAliasType():String
public function set antiAliasType(value:String):void
İlgili API Öğeleri
autoSize | özellik |
autoSize:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanlarının otomatik boyutlandırılmasını veya hizalanmasını kontrol eder. TextFieldAutoSize
sabitleri için kabul edilebilir değerler şu şekildedir: TextFieldAutoSize.NONE
(varsayılan), TextFieldAutoSize.LEFT
, TextFieldAutoSize.RIGHT
ve TextFieldAutoSize.CENTER
.
autoSize
öğesi TextFieldAutoSize.NONE
(varsayılan) olarak ayarlanmışsa herhangi bir yeniden boyutlandırma meydana gelmez.
autoSize
öğesi TextFieldAutoSize.LEFT
olarak ayarlanmışsa, metne sola yaslanmış metin olarak müdahale edilir, yani metin alanının sol kenar boşluğu sabit kalır ve tek bir metin satırında meydana gelen herhangi bir yeniden boyutlandırma sağ kenar boşluğundadır. Metin bir satır kesmesi içeriyorsa (örneğin "\n"
veya "\r"
), taban da bir sonraki metin satırına sığacak şekilde yeniden boyutlandırılır. wordWrap
öğesi de true
değerine ayarlıysa, yalnızca metin alanının tabanı yeniden boyutlandırılır ve sağ taraf sabit kalır.
autoSize
öğesi TextFieldAutoSize.RIGHT
olarak ayarlanmışsa, metne sağa yaslanmış metin olarak müdahale edilir, yani metin alanının sağ kenar boşluğu sabit kalır ve tek bir metin satırında meydana gelen herhangi bir yeniden boyutlandırma sol kenar boşluğundadır. Metin bir satır kesmesi içeriyorsa (örneğin "\n" veya "\r")
, taban da bir sonraki metin satırına sığacak şekilde yeniden boyutlandırılır. wordWrap
öğesi de true
değerine ayarlıysa, yalnızca metin alanının tabanı yeniden boyutlandırılır ve sol taraf sabit kalır.
autoSize
öğesi TextFieldAutoSize.CENTER
olarak ayarlanmışsa, metne ortaya yaslanmış metin olarak müdahale edilir, başka bir deyişle, tek bir metin satırının yeniden boyutlandırması sağ ve sol kenar boşlukları arasında eşit miktarda dağıtılır. Metin bir satır kesmesi içeriyorsa (örneğin "\n"
veya "\r"
), taban da bir sonraki metin satırına sığacak şekilde yeniden boyutlandırılır. wordWrap
öğesi de true
olarak ayarlıysa, yalnızca metin alanının tabanı yeniden boyutlandırılır, sol ve sağ taraflar sabit kalır.
Uygulama
public function get autoSize():String
public function set autoSize(value:String):void
Atar
ArgumentError — Belirtilen autoSize öğesi flash.text.TextFieldAutoSize öğesinin bir üyesi değildir.
|
İlgili API Öğeleri
background | özellik |
background:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının arka plan dolgusu olup olmadığını belirtir. true
olursa, metin alanı arka plan doldurmasına sahip olur. false
olursa, metin alanı arka plan doldurmasına sahip olmaz. Bir metin alanının arka planını ayarlamak için backgroundColor
özelliğini kullanın.
Varsayılan değer şudur false.
Uygulama
public function get background():Boolean
public function set background(value:Boolean):void
İlgili API Öğeleri
backgroundColor | özellik |
backgroundColor:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanı arka planının rengi. Varsayılan değer 0xFFFFFF
(beyaz) şeklindedir. O anda bir arka plan olmasa bile bu özellik alınabilir veya ayarlanabilir ancak renk yalnızca metin alanının background
özelliği true
olarak ayarlanmışsa görülebilir.
Uygulama
public function get backgroundColor():uint
public function set backgroundColor(value:uint):void
İlgili API Öğeleri
border | özellik |
border:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının kenarlığı olup olmadığını belirtir. true
olursa, metin alanı kenarlığa sahip olur. false
olursa, metin alanı kenarlığa sahip olmaz. Kenarlık rengini ayarlamak için borderColor
özelliğini kullanın.
Varsayılan değer şudur false.
Uygulama
public function get border():Boolean
public function set border(value:Boolean):void
İlgili API Öğeleri
borderColor | özellik |
borderColor:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanı kenarlığının rengi. Varsayılan değer 0x000000
(siyah) şeklindedir. O anda bir kenarlık olmasa bile bu özellik alınabilir veya ayarlanabilir ancak renk yalnızca metin alanının border
özelliği true
olarak ayarlanmışsa görülebilir.
Uygulama
public function get borderColor():uint
public function set borderColor(value:uint):void
İlgili API Öğeleri
bottomScrollV | özellik |
bottomScrollV:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirtilen metin alanında halen görünür durumda olan en alt satırı gösteren bir tam sayı (1 temelli dizin). Metin alanını bir metin bloğu üzerindeki bir pencere olarak düşünün. scrollV
özelliği penceredeki görünür en üst satırın 1 temelli dizinidir.
scrollV
ve bottomScrollV
tarafından gösterilen satırlar arasındaki metnin tümü o anda metin alanında görünürdür.
Uygulama
public function get bottomScrollV():int
İlgili API Öğeleri
caretIndex | özellik |
caretIndex:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ekleme noktası (düzeltme) konumunun dizini. Herhangi bir ekleme noktası görüntülenmezse değer, odağı alana geri yüklemeniz durumunda ekleme noktasının olacağı konum olur (genellikle ekleme noktasının en son konumu veya alan odak almamışsa 0).
Seçim yayılması dizinleri sıfır temellidir. (Örneğin, ilk konum 0, ikinci konum 1 şeklinde devam eder.)
Uygulama
public function get caretIndex():int
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
printCursorPosition
yöntemi çağrılacak şekilde bir olay dinleyicisi atanır. Bu durumda, caretIndex
, selectionBeginIndex
ve selectionEndIndex
özelliklerinin değerleri çıktı olarak verilir.
Metni seçmek için bu örneği çalıştırın ve TextField öğesini tıklatmayı deneyin. Ardından metni seçmeden alanı tıklatmayı deneyin. Bir seçim yapmadan metni tıklatırsanız, caretIndex
özelliği ekleme noktasının nerede meydana geldiğini gösterir ve selectionBeginIndex
ve selectionEndIndex
özellikleri caretIndex
özelliğinin değerine eşitlenir.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
condenseWhite | özellik |
condenseWhite:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
İçinde HTML metni bulunan bir metin alanından ekstra beyaz boşlukların (boşluk, satır kesmeler vb.) kaldırılıp kaldırılmayacağını gösteren bir Boolean değeri. Varsayılan olarak false
değerindedir. condenseWhite
özelliği yalnızca htmlText
özelliğiyle ayarlanmış metni etkiler text
özelliğiyle ayarlanmış metni etkilemez. Metni text
özelliğiyle ayarlanmışsa, condenseWhite
yok sayılır.
condenseWhite
öğesi true
değerine ayarlanırsa, metin alanına satır kesme yerleştirmek için <BR>
ve <P>
gibi standart HTML komutlarını kullanın.
htmlText
özelliğini ayarlamadan önce condenseWhite
özelliğini ayarlayın.
Uygulama
public function get condenseWhite():Boolean
public function set condenseWhite(value:Boolean):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
condenseWhite
ayarını false
değerine ayarlamakla true
değerine ayarlamak arasındaki farkı göstermektedir:
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_condenseWhite extends Sprite { public function TextField_condenseWhite() { var tf1:TextField = createCustomTextField(0, 0, 200, 50); tf1.condenseWhite = false; tf1.htmlText = "keep on\n\ttruckin'"; var tf2:TextField = createCustomTextField(0, 120, 200, 50); tf2.condenseWhite = true; tf2.htmlText = "keep on\n\ttruckin'"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; addChild(result); return result; } } }
defaultTextFormat | özellik |
defaultTextFormat:flash.text:TextFormat
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kullanıcı tarafından girilen metin veya replaceSelectedText()
yöntemiyle eklenen metin gibi, yeni eklenen metine uygulanan biçimi belirtir.
Not: setSelection()
ve replaceSelectedText()
ile değiştirilecek karakterler seçilirken, yalnızca son karaktere kadar, son karakter de dahil olacak şekilde metin seçilmişse, defaultTextFormat
uygulanır. Aşağıda buna bir örnek verilmiştir:
var my_txt:TextField new TextField(); my_txt.text = "Flash Macintosh version"; var my_fmt:TextFormat = new TextFormat(); my_fmt.color = 0xFF0000; my_txt.defaultTextFormat = my_fmt; my_txt.setSelection(6,15); // partial text selected - defaultTextFormat not applied my_txt.setSelection(6,23); // text selected to end - defaultTextFormat applied my_txt.replaceSelectedText("Windows version");
defaultTextFormat
özelliğine eriştiğinizde döndürülen TextFormat nesnesinin tüm özellikleri tanımlanır. Hiçbir özellik null
değildir.
Not: Metin alanına bir stil sayfası uygulanırsa bu özelliği ayarlayamazsınız.
Uygulama
public function get defaultTextFormat():flash.text:TextFormat
public function set defaultTextFormat(value:flash.text:TextFormat):void
Atar
Error — Bu yöntem bir stil sayfasına sahip bir metin alanında kullanılamaz.
|
İlgili API Öğeleri
displayAsPassword | özellik |
displayAsPassword:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının bir şifre metin alanı olup olmadığını belirtir. Bu özelliğin değeri true
ise, metin alanına bir şifre metin alanı olarak müdahale edilir ve girdi karakterleri gerçek karakterler yerine yıldız karakteri kullanılarak gizlenir. Değer false
olursa, metin alanına bir şifre metin alanı olarak müdahale edilmez. Şifre modu etkinleştirildiğinde, Kes ve Kopyala komutları ve karşılık gelen klavye kısayolları işlev göstermez. Bu güvenlik mekanizması yetkisiz bir kullanıcının gözetimsiz bir bilgisayara girerek şifreyi keşfetmek için kısayolları kullanmasını engeller.
Varsayılan değer şudur false.
Uygulama
public function get displayAsPassword():Boolean
public function set displayAsPassword(value:Boolean):void
embedFonts | özellik |
embedFonts:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gömülü font anahatları kullanılarak oluşturulup oluşturulmayacağını belirtir. Değer false
olursa Flash Player, metin alanını aygıt fontlarını kullanarak oluşturur.
Bir metin için embedFonts
özelliğini true
olarak ayarlarsanız, metin alanına uygulanan bir TextFormat nesnesinin font
özelliğini kullanarak, o metin için bir font belirtmelisiniz. Belirtilen font SWF dosyasında gömülü değilse, metin görüntülenmez.
Varsayılan değer şudur false.
Uygulama
public function get embedFonts():Boolean
public function set embedFonts(value:Boolean):void
İlgili API Öğeleri
gridFitType | özellik |
gridFitType:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu metin alanı için kullanılan ızgara sığdırma türü. Bu özellik yalnızca metin alanının flash.text.AntiAliasType
özelliğinin flash.text.AntiAliasType.ADVANCED
olarak ayarlanması durumunda geçerlidir.
Kullanılan ızgara sığdırmasının türü Flash Player'ın düzgün yatay ve dikey çizgileri bir piksele, bir alt piksel ızgarasına veya hiçbirine sığacak şekilde zorlayıp zorlamayacağını belirler.
flash.text.GridFitType
özelliği için şu dize değerlerini kullanabilirsiniz:
Dize değeri | Açıklama |
---|---|
flash.text.GridFitType.NONE | Herhangi bir ızgara sığdırması belirtmez. Gliflerdeki yatay ve dikey satırların piksel ızgarasına sığması zorlanmaz. Bu ayar genellikle animasyon veya büyük font boyutları için önerilir. |
flash.text.GridFitType.PIXEL | Düzgün yatay ve dikey çizgilerin piksel ızgarasına sığdığını belirtir. Bu ayar yalnızca sola doğru hizalı metin alanlarında çalışır. Bu ayarı kullanmak için, metin alanının flash.dispaly.AntiAliasType özelliği flash.text.AntiAliasType.ADVANCED olarak ayarlanmalıdır. Bu ayar genellikle sola doğru hizalanmış metnin en iyi biçimde okunmasını sağlar. |
flash.text.GridFitType.SUBPIXEL | Düzgün yatay ve dikey çizgilerin, bir LCD monitör üzerinde alt piksel ızgarasına sığdığını belirtir. Bu ayarı kullanmak için, metin alanının flash.text.AntiAliasType özelliği flash.text.AntiAliasType.ADVANCED olarak ayarlanmalıdır. flash.text.GridFitType.SUBPIXEL ayarı genellikle sağa doğru hizalanmış veya ortalanmış dinamik metinle kullanım için elverişlidir ve bazen animasyona karşı metin kalitesi için kullanışlı bir takas yöntemidir. |
Varsayılan değer şudur pixel.
Uygulama
public function get gridFitType():String
public function set gridFitType(value:String):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
gridFitType
özelliğine yönelik üç farklı ayara sahip üç metin alanını gösterir. Bu örneği kullanırken ilk iki satır arasındaki okunabilirlik farkına dikkat edin. Ayrıca GridFitType.PIXEL
öğesinin sola hizalanmış metinle ve GridFitType.SUBPIXEL
öğesinin sağa hizalanmış metinle en iyi kullanımını göz önünde bulundurun.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; public class gridFitTypeExample extends Sprite { public function gridFitTypeExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=12; var tf1:TextField = createCustomTextField(0,0,format1,"NONE",TextFieldAutoSize.LEFT,GridFitType.NONE); var tf2:TextField = createCustomTextField(0,30,format1,"PIXEL",TextFieldAutoSize.LEFT,GridFitType.PIXEL); var tf3:TextField = createCustomTextField(300,60,format1,"SUBPIXEL",TextFieldAutoSize.RIGHT,GridFitType.SUBPIXEL); } private function createCustomTextField(x:Number,y:Number,fm:TextFormat,tl:String,tfs:String,gft:String):TextField { var result:TextField = new TextField(); result.x=x; result.y=y; result.embedFonts=true; result.antiAliasType=AntiAliasType.ADVANCED; result.text="This text uses a gridFitType of " + tl; result.autoSize=tfs; result.gridFitType=gft; result.setTextFormat(fm); addChild(result); return result; } } }
htmlText | özellik |
htmlText:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının içeriğinin HTML temsilini içerir.
Flash Player şu HTML etiketlerini destekler:
Etiket | Açıklama |
---|---|
Tutturucu etiketi |
<a> etiketi bir köprü metni bağı oluşturur ve şu nitelikleri destekler:
|
Kalın etiketi |
<b> etiketi metni kalın yapar. Kullanılan fontta kalın bir yazı biçimi mevcut olmalıdır.
|
Kesme etiketi |
<br> etiketi metin alanında bir satır kesmesi oluşturur. Bu etiketi kullanmak için metin alanını çok satırlı metin olacak şekilde ayarlayın.
|
Font etiketi |
<font> etiketi metni görüntülemek için gerekli olan bir font veya font listesi belirtir. Font etiketi şu nitelikleri destekler:
|
Görüntü etiketi |
<img> etiketi harici görüntü dosyalarını (JPEG, GIF, PNG), SWF dosyalarını ve film kliplerini metin alanlarının içine gömmenizi sağlar. Metin otomatik olarak, metin alanlarına gömdüğünüz görüntülerin etrafında akar. Metin alanının bir görüntünün çevresini sarması için alanını çok satırlı olacak şekilde ayarlamalısınız.
Flash, bir metin alanına gömülü medyayı tam boyutta görüntüler. Gömdüğünüz medyanın boyutlarını belirtmek için Genellikle metin alanına gömülü bir görüntü Uygulama güvenlik sanal alanındaki AIR içeriği için, AIR, ActionScript TextField nesnelerindeki HTML içeriğinde bulunan |
İtalik etiketi |
<i> etiketi, etiketli metni italik olarak görüntüler. Kullanılan fontta italik bir yazı biçimi mevcut olmalıdır.
|
Öğe listeleme etiketi |
<li> etiketi çevrelediği metnin önüne bir madde imi yerleştirir. Not: Flash Player ve AIR sıralı ve sıralanmamış liste etiketlerini (<ol> ve <ul> ) tanımadığından, bunlar listenizin oluşturulma biçimini değiştirmez. Tüm listeler sıralanmamıştır ve tüm liste öğeleri madde imlerini kullanır.
|
Paragraf etiketi. |
<p> etiketi yeni bir paragraf oluşturur. Bu etiketi kullanmak için metin alanı, çok satırlı metin olacak şekilde ayarlanmalıdır. <p> etiketi şu nitelikleri destekler:
|
Yayılma etiketi |
<span> etiketi yalnızca CSS metin stilleriyle kullanılabilir. Şu niteliği destekler:
|
Metin biçimi etiketi |
|
Alt çizgi etiketi |
<u> etiketi, etiketli metnin altını çizer.
|
Flash Player ve AIR, şu HTML birimlerini destekler:
Varlık | Açıklama |
---|---|
< | < (küçüktür) |
> | > (büyüktür) |
& | & (ve işareti) |
" | " (çift tırnak işareti) |
' | ' (kesme işareti, tek tırnak) |
Flash Player ve AIR ayrıca & (ASCII ve işareti) ve € gibi açık karakter kodlarını destekler; (Unicode € sembolü).
Uygulama
public function get htmlText():String
public function set htmlText(value:String):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
tf1
adlı bir TextField öğesi oluşturur ve bunun text
özelliğine HTML biçimli bir String öğesi atar. htmlText
özelliği izlendiğinde, çıktı, Flash Player tarafından otomatik olarak eklenen ilave etiketlere (<P> ve <FONT> gibi) sahip HTML biçimli String öğesi olur. text
özelliğinin değeri izlendiğinde, HTML etiketlerinin bulunmadığı biçimlendirilmemiş dize görüntülenir.
Karşılaştırma yoluyla, tf2
adlı başka bir TextField nesnesi üzerinde aynı adımlar gerçekleştirilir. Bu adımlar sırasında ek olarak tf2
öğesinin styleSheet
özelliğine bu öğenin htmlText
özelliği ayarlanmadan önce bir StyleSheet nesnesi atanır. Bu durumda htmlText
özelliği izlendiğinde, Flash Player tarafından ilave herhangi bir etiket eklenmediğini göstererek yalnızca ilk olarak htmlText
özelliğine atanmış tam HTML metnini içerir.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
length | özellik |
maxChars | özellik |
maxChars:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının içerebileceği, kullanıcı tarafından girilen maksimum karakter sayısı. Bir komut dosyası maxChars
öğesinin izin verdiğinden daha fazla karakter ekleyebilir; maxChars
özelliği yalnızca bir kullanıcının ne kadar metin girebileceğini gösterir. Bu özelliğin değeri 0
olursa, kullanıcı sınırsız miktarda metin girebilir.
Varsayılan değer şudur 0.
Uygulama
public function get maxChars():int
public function set maxChars(value:int):void
maxScrollH | özellik |
maxScrollV | özellik |
mouseWheelEnabled | özellik |
mouseWheelEnabled:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Flash Player'ın, kullanıcı bir metin alanını tıklatıp fare tekerleğini döndürdüğünde çok satırlı metin alanlarını otomatik olarak kaydırıp kaydırmayacağını gösteren Boolean değeri. Varsayılan olarak, bu değer true
olur. Fare tekerleğinin metin alanlarını kaydırmasını önlemek veya kendiniz bir metin alanı kaydırması uygulamak istiyorsanız bu özellik faydalıdır.
Uygulama
public function get mouseWheelEnabled():Boolean
public function set mouseWheelEnabled(value:Boolean):void
multiline | özellik |
multiline:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Alanın çok satırlı bir metin alanı olup olmadığını belirtir. Değer true
olursa, metin alanı çok satırlıdır; değer false
olursa metin alanı tek satırlı bir metin alanıdır. TextFieldType.INPUT
türünde bir alanda, multiline
değeri, Enter
tuşunun yeni bir satır oluşturup oluşturmadığını belirler (false
değeri ve Enter
tuşu yok sayılır). Bir TextField
öğesine, false
olan multiline
değeriyle metin yapıştırırsanız, yeni satırlar metinden kaldırılır.
Varsayılan değer şudur false.
Uygulama
public function get multiline():Boolean
public function set multiline(value:Boolean):void
İlgili API Öğeleri
numLines | özellik |
numLines:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Çok satırlı bir metin alanındaki metin satır sayısını tanımlar. wordWrap
özelliği true
olarak ayarlanmışsa, metin kaydırıldığında satır sayısı artar.
Uygulama
public function get numLines():int
İlgili API Öğeleri
restrict | özellik |
restrict:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanına kullanıcının girebileceği karakter setini gösterir. restrict
özelliğinin değeri null
olursa, herhangi bir karakter girebilirsiniz. restrict
özelliğinin değeri boş bir dizeyse, hiçbir karakter giremezsiniz. restrict
özelliğinin değeri bir karakter dizesiyse, metin alanına yalnızca dizedeki karakterleri girebilirsiniz. Dize soldan sağa doğru taranır. Bir aralığı, tire (-) karakterini kullanarak belirtebilirsiniz. Yalnızca kullanıcı etkileşimi sınırlıdır; bir komut dosyası herhangi bir metni metin alanına koyabilir. Bu özellik, Özellik denetçisindeki Göm font seçenekleriyle senkronize olmaz.
Dize, düzeltme (^) karakteriyle başlıyorsa, tüm karakterler ilk başta kabul edilir ve dizede arkasından gelen karakterler, kabul edilen karakter kümesinin dışında tutulur. Dize, düzeltme (^) karakteriyle başlamıyorsa, ilk başta hiçbir karakter kabul edilmez ve dizede arkasından gelen karakterler, kabul edilen karakter kümesine dahil edilir.
Şu örnek metin alanına yalnızca büyük harfli karakterlerin, boşlukların ve sayıların girilmesine izin verir:
my_txt.restrict = "A-Z 0-9";
Şu örnek tüm karakterleri içerir ancak küçük harfli karakterleri dışarıda bırakır:
my_txt.restrict = "^a-z";
Harfi harfine bir ^ veya - girmek için bir ters eğik çizgi kullanabilirsiniz. Kabul edilen ters eğik çizgi sıraları \-, \^ veya \\ şeklindedir. Ters eğik çizgi dize içinde gerçek bir karakter olmalıdır. Bu nedenle ActionScript'te belirtildiğinde çift ters eğik çizgi kullanılmalıdır. Örneğin, şu kod yalnızca kısa çizgi (-) ve düzeltme işareti (^) içerir:
my_txt.restrict = "\\-\\^";
^ işareti dizede herhangi bir noktada dahil edilen ve dışarıda bırakılan karakterler arasında geçiş yapmak için kullanılabilir. Şu kod yalnızca büyük harfleri içerir ancak Q büyük harfini dışarıda bırakır:
my_txt.restrict = "A-Z^Q";
restrict
dizeleri oluşturmak için \u
atlama sırasını kullanabilirsiniz. Şu örnek yalnızca ASCII 32 (boşluk) ile ASCII 126 (yaklaşık işareti) arasındaki karakterleri içerir.
my_txt.restrict = "\u0020-\u007E";
Varsayılan değer şudur null.
Uygulama
public function get restrict():String
public function set restrict(value:String):void
scrollH | özellik |
scrollH:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geçerli yatay kaydırma konumu. scrollH
özelliği 0 ise metin yatay olarak kaydırılmaz. Bu özellik değeri yatay konumu piksel olarak temsil eden bir tam sayıdır.
Yatay kaydırma birimleri piksel şeklindeyken dikey kaydırma birimleri satır şeklindedir. Genellikle kullandığınız fontların çoğu orantılı olarak boşluklu olduğundan, yani karakterler farklı genişliklere sahip olduğu için yatay kaydırma piksel olarak ölçülür. Kullanıcılar genellikle kısmi satır yerine tam bir metin satırı görmek istediğinden Flash Player, dikey kaydırmayı satır olarak gerçekleştirir. Bir satır birden çok font kullansa da satırın yüksekliği kullanılan en büyük fonta sığacak şekilde ayarlanır.
Not: scrollH
özelliği sıfır temellidir, scrollV
dikey kaydırma özelliği gibi 1 temelli değildir.
Uygulama
public function get scrollH():int
public function set scrollH(value:int):void
İlgili API Öğeleri
scrollV | özellik |
scrollV:int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metnin metin alanındaki dikey konumu. scrollV
özelliği kullanıcıları uzun bir metindeki belirli bir paragrafa yönlendirmek veya kayan metin alanları oluşturmak için kullanılabilir.
Dikey kaydırma birimleri satır şeklindeyken yatay kaydırma birimleri piksel şeklindedir. Görüntülenen ilk satır metin alanındaki ilk satırsa scrollV 1 olarak ayarlanır (0 değil). Fontların çoğu orantılı olarak boşluklu olduğundan, yani karakterler farklı genişliklere sahip olduğu için yatay kaydırma piksel olarak ölçülür. Kullanıcılar genellikle kısmi satır yerine tam bir metin satırı görmek istediğinden Flash, dikey kaydırmayı satır olarak gerçekleştirir. Bir satır üzerinde birden fazla font varsa satırın yüksekliği kullanımdaki en büyük fonta sığacak şekilde ayarlanır.
Uygulama
public function get scrollV():int
public function set scrollV(value:int):void
İlgili API Öğeleri
selectable | özellik |
selectable:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının seçilebilir olup olmadığını gösteren Boolean değeri. true
değeri metnin seçilebilir olduğunu gösterir. selectable
özelliği metin alanının seçilebilir olup olmadığını kontrol eder, düzenlenebilir olup olmadığını kontrol etmez. Dinamik bir metin alanı düzenlenebilir olmasa da seçilebilir. Dinamik bir metin alanı seçilebilir değilse metni kullanıcı tarafından seçilemez.
selectable
öğesi false
değerine ayarlıysa, metin alanındaki metin fareden veya klavyeden gelen seçim komutlarına yanıt vermez ve metin Kopyala komutuyla kopyalanamaz. selectable
öğesi true
değerine ayarlıysa, metin alanındaki metin fareyle veya klavyeyle seçilebilir ve metin Kopyala komutuyla kopyalanabilir. Metin alanı bir girdi metin alanı yerine dinamik metin alanı olsa bile metni bu şekilde seçebilirsiniz.
Varsayılan değer şudur true.
Uygulama
public function get selectable():Boolean
public function set selectable(value:Boolean):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
selectable
özelliği true
olarak ayarlanmış bir metin alanı ve selectable
özelliği false
olarak ayarlanmış diğer metin alanı. Bu örneği kullanırken bu alanlardaki metni fareyle veya klavyeyle seçmeyi deneyin.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class selectableExample extends Sprite { public function selectableExample() { var tf1:TextField = createCustomTextField(10, 10); tf1.text="This text can be selected"; tf1.selectable=true; var tf2:TextField = createCustomTextField(10, 30); tf2.text="This text cannot be selected"; tf2.selectable=false; } private function createCustomTextField(x:Number, y:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.autoSize=TextFieldAutoSize.LEFT; addChild(result); return result; } } }
selectionBeginIndex | özellik |
selectionBeginIndex:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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. Herhangi bir metin seçili değilse bu özellik caretIndex
değerinde olur.
Uygulama
public function get selectionBeginIndex():int
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
printCursorPosition
yöntemi çağrılacak şekilde bir olay dinleyicisi atanır. Bu durumda, caretIndex
, selectionBeginIndex
ve selectionEndIndex
özelliklerinin değerleri çıktı olarak verilir.
Metni seçmek için bu örneği çalıştırın ve TextField öğesini tıklatmayı deneyin. Ardından metni seçmeden alanı tıklatmayı deneyin. Bir seçim yapmadan metni tıklatırsanız, caretIndex
özelliği ekleme noktasının nerede meydana geldiğini gösterir ve selectionBeginIndex
ve selectionEndIndex
özellikleri caretIndex
özelliğinin değerine eşitlenir.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
selectionEndIndex | özellik |
selectionEndIndex:int
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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. Herhangi bir metin seçili değilse bu özellik caretIndex
değerinde olur.
Uygulama
public function get selectionEndIndex():int
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
printCursorPosition
yöntemi çağrılacak şekilde bir olay dinleyicisi atanır. Bu durumda, caretIndex
, selectionBeginIndex
ve selectionEndIndex
özelliklerinin değerleri çıktı olarak verilir.
Metni seçmek için bu örneği çalıştırın ve TextField öğesini tıklatmayı deneyin. Ardından metni seçmeden alanı tıklatmayı deneyin. Bir seçim yapmadan metni tıklatırsanız, caretIndex
özelliği ekleme noktasının nerede meydana geldiğini gösterir ve selectionBeginIndex
ve selectionEndIndex
özellikleri caretIndex
özelliğinin değerine eşitlenir.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_caretIndex extends Sprite { public function TextField_caretIndex() { var tf:TextField = createCustomTextField(10, 10, 100, 100); tf.wordWrap = true; tf.type = TextFieldType.INPUT; tf.text = "Click in this text field. Compare the difference between clicking without selecting versus clicking and selecting text."; tf.addEventListener(MouseEvent.CLICK, printCursorPosition); } private function printCursorPosition(event:MouseEvent):void { var tf:TextField = TextField(event.target); trace("caretIndex:", tf.caretIndex); trace("selectionBeginIndex:", tf.selectionBeginIndex); trace("selectionEndIndex:", tf.selectionEndIndex); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
sharpness | özellik |
sharpness:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu metin alanındaki glif kenarlarının keskinliği. Bu özellik yalnızca metin alanının flash.text.AntiAliasType
özelliğinin flash.text.AntiAliasType.ADVANCED
olarak ayarlanması durumunda geçerlidir. sharpness
öğesine yönelik aralık -400 ile 400 arasındadır. sharpness
öğesini aralık dışında bir değere ayarlamaya çalışırsanız, Flash, özelliği aralıktaki en yakın değere ayarlar (-400 veya 400).
Varsayılan değer şudur 0.
Uygulama
public function get sharpness():Number
public function set sharpness(value:Number):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
sharpness
özelliğinin değiştirilmesinin etkisini gösterir. Fontu gömüp antiAliasType
özelliğini ADVANCED
olarak ayarlamanız gerekir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class sharpnessExample extends Sprite { public function sharpnessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-400); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,400); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldSharpness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.sharpness=fldSharpness; result..setTextFormat(format); addChild(result); return result; } } }
styleSheet | özellik |
styleSheet:StyleSheet
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanına bir stil sayfası iliştirir. Stil sayfaları oluşturmayla ilgili bilgi için, StyleSheet sınıfını ve ActionScript 3.0 Geliştirici Kılavuzu'nu inceleyin.
Metin alanıyla ilişkili stil sayfasını istediğiniz zaman değiştirebilirsiniz. Kullanımdaki stil sayfasını değiştirirseniz metin sayfası yeni bir stil sayfasıyla birlikte yeniden çizilir. Stil sayfasını kaldırmak için null
veya undefined
şeklinde ayarlayabilirsiniz. Kullanımdaki stil sayfası kaldırılırsa metin alanı bir stil sayfası olmadan yeniden çizilir.
Not: Stil sayfası kaldırılırsa TextField.text
ve TextField.htmlText
öğelerinin içerikleri stil sayfası tarafından uygulanan önceki biçimlendirmeyi dahil edecek şekilde değişir. Orijinal TextField.htmlText
içeriklerini biçimlendirme olmadan korumak için stil sayfasını kaldırmadan önce bir değişkendeki değeri kaydedin.
Uygulama
public function get styleSheet():StyleSheet
public function set styleSheet(value:StyleSheet):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
stylesheet
özelliğini ayarlayın.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.StyleSheet; public class TextStylesheetExample extends Sprite { var myLabel:TextField = new TextField(); var labelText:String = "Hello world."; var newStyle:StyleSheet = new StyleSheet(); public function TextStylesheetExample() { var styleObj:Object = new Object(); styleObj.fontWeight = "bold"; styleObj.color = "#660066"; newStyle.setStyle(".defStyle", styleObj); myLabel.styleSheet=newStyle; myLabel.htmlText=labelText; addChild(myLabel); } } }
text | özellik |
text:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanındaki geçerli metnin dizesi. Satırlar bir satır başı karakteri ('\r'
, ASCII 13) tarafından ayrılır. Bu özellik metin alanında HTML etiketsiz biçimlendirilmemiş metin içerir.
Metni HTML biçiminde almak için htmlText
özelliğini kullanın.
Not: Bir stil sayfası metin alanına uygulandığında, text
özelliğinin içeriği HTML olarak yorumlanır.
Uygulama
public function get text():String
public function set text(value:String):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
tf1
adlı bir TextField öğesi oluşturur ve bunun text
özelliğine HTML biçimli bir String öğesi atar. htmlText
özelliği izlendiğinde, çıktı, Flash Player tarafından otomatik olarak eklenen ilave etiketlere (<P> ve <FONT> gibi) sahip HTML biçimli String öğesi olur. text
özelliğinin değeri izlendiğinde, HTML etiketlerinin bulunmadığı biçimlendirilmemiş dize görüntülenir.
Karşılaştırma yoluyla, tf2
adlı başka bir TextField nesnesi üzerinde aynı adımlar gerçekleştirilir. Bu adımlar sırasında ek olarak tf2
öğesinin styleSheet
özelliğine bu öğenin htmlText
özelliği ayarlanmadan önce bir StyleSheet nesnesi atanır. Bu durumda htmlText
özelliği izlendiğinde, Flash Player tarafından ilave herhangi bir etiket eklenmediğini göstererek yalnızca ilk olarak htmlText
özelliğine atanmış tam HTML metnini içerir.
package { import flash.display.Sprite; import flash.text.StyleSheet; import flash.text.TextField; public class TextField_text extends Sprite { public function TextField_text() { var tf1:TextField = createCustomTextField(10, 10, 400, 22); tf1.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <P ALIGN="LEFT"><FONT FACE="Times New Roman" SIZE="12" COLOR="#000000" LETTERSPACING="0" KERNING="0"><b>Lorem ipsum dolor sit amet.</b></FONT></P> trace("htmlText: " + tf1.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf1.text); var tf2:TextField = createCustomTextField(10, 50, 400, 22); tf2.styleSheet = new StyleSheet(); tf2.htmlText = "<b>Lorem ipsum dolor sit amet.</b>"; // htmlText: <b>Lorem ipsum dolor sit amet.</b> trace("htmlText: " + tf2.htmlText); // text: Lorem ipsum dolor sit amet. trace("text: " + tf2.text); } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textColor | özellik |
textColor:uint
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanındaki metnin onaltılık biçimde rengi. Onaltılık renk sistemi renk değerlerini temsil etmek için altı basamak kullanır. Her basamak 16 olası değere veya karaktere sahiptir. Karakterler 0 ile 9 ve A ile F arasındadır. Örneğin, siyah 0x000000
; beyaz ise 0xFFFFFF
şeklindedir.
Varsayılan değer şudur 0 (0x000000).
Uygulama
public function get textColor():uint
public function set textColor(value:uint):void
Örnek ( Bu örnek nasıl kullanılır? )
textColor
özelliğini kırmızı (0xFF0000
) olarak değiştirir.
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textColor extends Sprite { public function TextField_textColor() { var tf:TextField = createCustomTextField(10, 10, 100, 300); tf.text = "This will be red text"; tf.textColor = 0xFF0000; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; addChild(result); return result; } } }
textHeight | özellik |
textHeight:Number
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metnin piksel olarak yüksekliği.
Uygulama
public function get textHeight():Number
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
trace
ifadeleri textWidth
ve textHeight
özelliklerinin değerlerini görüntüler. Karşılaştırma için width
ve height
özellikleri de görüntülenir. (textHeight
ve textWidth
öğeleri için gördüğünüz değerlerin bilgisayarınızda kullanılan fonta göre farklılık gösterebileceğini unutmayın.)
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
textInteractionMode | özellik |
textInteractionMode:String
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Etkileşim modu özelliği, Varsayılan değer TextInteractionMode.NORMAL olur. Mobil platformlarda normal modu, metnin kaydırılabileceğini ancak seçilemeyeceğini belirtir. Metin alanında yerleşik bağlam menüsü yoluyla seçilebilir moda geçiş yapılabilir. Masaüstünde normal modu, metnin hem kaydırılabilir olduğunu hem de seçim modunda olduğunu belirtir.
Uygulama
public function get textInteractionMode():String
textWidth | özellik |
textWidth:Number
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metnin genişliği (piksel cinsinden).
Uygulama
public function get textWidth():Number
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
trace
ifadeleri textWidth
ve textHeight
özelliklerinin değerlerini görüntüler. Karşılaştırma için width
ve height
özellikleri de görüntülenir. (textHeight
ve textWidth
öğeleri için gördüğünüz değerlerin bilgisayarınızda kullanılan fonta göre farklılık gösterebileceğini unutmayın.)
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_textHeight extends Sprite { public function TextField_textHeight() { var tf:TextField = createCustomTextField(10, 10, 100, 150); tf.text = "Sample text"; trace("textWidth: " + tf.textWidth); // textWidth: 55.75 trace("textHeight: " + tf.textHeight); // textHeight: 13.450000000000001 trace("width: " + tf.width); // width: 100 trace("height: " + tf.height); // height: 150 } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.border = true; result.background = true; addChild(result); return result; } } }
thickness | özellik |
thickness:Number
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu metin alanındaki glif kenarlarının kalınlığı. Bu özellik yalnızca flash.text.AntiAliasType
özelliği flash.text.AntiAliasType.ADVANCED
olarak ayarlandığında geçerlidir.
thickness
öğesine yönelik aralık -200 ile 200 arasındadır. thickness
öğesini aralık dışında bir değere ayarlamaya çalışırsanız, özellik aralıktaki en yakın değere ayarlanır (-200 veya 200).
Varsayılan değer şudur 0.
Uygulama
public function get thickness():Number
public function set thickness(value:Number):void
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
thickness
özelliğinin değiştirilmesinin etkisini gösterir. Fontu gömüp antiAliasType
özelliğini ADVANCED
olarak ayarlamanız gerekir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.GridFitType; import flash.text.TextFormat; public class thicknessExample extends Sprite { public function thicknessExample() { var format1:TextFormat = new TextFormat(); format1.font="Arial"; format1.size=24; var lTxt:String = "The quick brown fox"; var tf1:TextField=createCustomTextField(0,lTxt,format1,-200); var tf2:TextField=createCustomTextField(30,lTxt,format1,0); var tf3:TextField=createCustomTextField(60,lTxt,format1,200); } private function createCustomTextField(y:Number,fldTxt:String,format:TextFormat,fldThickness:Number):TextField { var result:TextField = new TextField(); result.y=y; result.text=fldTxt; result.embedFonts=true; result.autoSize=TextFieldAutoSize.LEFT; result.antiAliasType=AntiAliasType.ADVANCED; result.gridFitType=GridFitType.PIXEL; result.thickness=fldThickness; result.setTextFormat(format); addChild(result); return result; } } }
type | özellik |
type:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanının türü. Şu TextFieldType sabitlerinden biri: kullanıcının düzenleyemediği dinamik bir metin alanını belirten TextFieldType.DYNAMIC
veya kullanıcının düzenleyebildiği bir girdi metin alanını belirten TextFieldType.INPUT
.
Varsayılan değer şudur dynamic.
Uygulama
public function get type():String
public function set type(value:String):void
Atar
ArgumentError — Belirtilen type öğesi flash.text.TextFieldType öğesinin bir üyesi değildir.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
tfDynamic
ve tfInput
. Her iki metin alanına da metin girilir. Ancak, tfDynamic
öğesinin type
özelliği TextFieldType.DYNAMIC
olarak ayarlanmıştır ve tfInput
öğesinin type
özelliği TextFieldType.INPUT
olarak ayarlanmıştır. Böylece kullanıcı tfInput
öğesindeki metni değiştirebilir ancak yalnızca tfDynamic
öğesindeki metni görüntüleyebilir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; public class TextField_type extends Sprite { public function TextField_type() { var tfDynamic:TextField = createCustomTextField(10, 10, 100, 20); tfDynamic.type = TextFieldType.DYNAMIC; tfDynamic.text = "hello"; var tfInput:TextField = createCustomTextField(10, 45, 100, 20); tfInput.type = TextFieldType.INPUT; tfInput.text = "world"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
useRichTextClipboard | özellik |
useRichTextClipboard:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Metinle birlikte metin biçimlendirmesinin de kopyalanıp kopyalanmayacağını ve yapıştırılıp yapıştırılmayacağını belirtir. true
değerine ayarlıysa, metin alanları arasında kopyalama ve yapıştırma yaparken Flash Player ayrıca biçimlendirmeyi de (hizalama, kalın ve italik gibi) kopyalayıp yapıştırır. Kopyalama ve yapıştırma prosedürüne yönelik kaynak ve hedef metin alanlarının useRichTextClipboard
özelliği true
değerine ayarlanmış olmalıdır. Varsayılan değer false
şeklindedir.
Uygulama
public function get useRichTextClipboard():Boolean
public function set useRichTextClipboard(value:Boolean):void
Örnek ( Bu örnek nasıl kullanılır? )
tf1
) ve iki dinamik metin alanı (tf2
ve tf3
) oluşturur. Kod her dinamik metin alanına bir TextFormat nesnesi (Courier Bold fontu) atar. tf2
metin alanının useRichTextClipboard
özelliği false
olarak ayarlanmıştır. tf3
metin alanının useRichTextClipboard
özelliği true
olarak ayarlanmıştır. tf2
metin alanından metin kopyaladığınızda ve bu metni tf1
metin alanına yapıştırdığınızda yapıştırılan metin, biçimlendirmeyi içermez. tf3
metin alanından (useRichTextClipboard
özelliği true
olarak ayarlanmış) metin kopyaladığınızda ve bu metni tf1
metin alanına yapıştırdığınızda yapıştırılan metin biçimlendirmeyi içerir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; public class useRichTextClipboard extends Sprite { public function useRichTextClipboard() { var format1:TextFormat = new TextFormat(); format1.font="Courier"; format1.bold=true; var tf1:TextField = createCustomTextField(10, 10, 200, 20); tf1.type=TextFieldType.INPUT; tf1.useRichTextClipboard=true; var tf2:TextField = createCustomTextField(220, 10, 200, 20); tf2.text="1.Text loses format"; tf2.setTextFormat(format1); tf2.useRichTextClipboard=false; var tf3:TextField = createCustomTextField(220, 50, 200, 20); tf3.text="2.Text includes format"; tf3.setTextFormat(format1); tf3.useRichTextClipboard=true; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
wordWrap | özellik |
wordWrap:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Metin alanında kelime kaydırma olup olmadığını gösteren Boolean değeri. wordWrap
öğesinin değeri true
olursa, metin alanında kelime kaydırma işlemi olur; değer false
olursa metin alanında kelime kaydırma olmaz. Varsayılan değer false
şeklindedir.
Uygulama
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void
Örnek ( Bu örnek nasıl kullanılır? )
wordWrap
özelliğini true
değerine ve false
değerine ayarlamak arasındaki farkı gösterir. İçerikleri genişliklerine göre oldukça büyük olan iki TextField örneği oluşturulur. İlkinin (tfWrap
adlı) wordWrap
özelliği true
olarak ayarlanmışken ikincininki (tfNoWrap
) false
olarak ayarlanmıştır.
package { import flash.display.Sprite; import flash.text.TextField; public class TextField_wordWrap extends Sprite { public function TextField_wordWrap() { var tfWrap:TextField = createCustomTextField(10, 10, 100, 100); tfWrap.wordWrap = true; tfWrap.text = "(wordWrap = true):\nThis is very long text that will certainly extend beyond the width of this text field"; var tfNoWrap:TextField = createCustomTextField(10, 150, 100, 100); tfNoWrap.wordWrap = false; tfNoWrap.text = "(wordWrap = false):\nThis is very long text that will certainly extend beyond the width of this text field"; } private function createCustomTextField(x:Number, y:Number, width:Number, height:Number):TextField { var result:TextField = new TextField(); result.x = x; result.y = y; result.width = width; result.height = height; result.background = true; result.border = true; addChild(result); return result; } } }
TextField | () | Yapıcı |
public function TextField()
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Yeni TextField örneği oluşturur. TextField örneğini oluşturduktan sonra, TextField örneğini görüntüleme listesine eklemek için üst DisplayObjectContainer nesnesinin addChild()
veya addChildAt()
yöntemini çağırın.
Bir metin alanına yönelik varsayılan boyut 100 x 100 pikseldir.
Örnek ( Bu örnek nasıl kullanılır? )
var theTextField:TextField = new TextField(); theTextField.type = TextFieldType.INPUT; theTextField.border = true; theTextField.x = 10; theTextField.y = 10; theTextField.multiline = true; theTextField.wordWrap = true; addChild(theTextField);
appendText | () | yöntem |
public function appendText(newText:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
newText
parametresi tarafından belirtilen dizeyi metin alanındaki metnin sonuna ekler. Bu yöntem özellikle önemli miktarda içeriğe sahip bir metin alanı için bir text
özelliğine yapılan toplama yapan atamadan (+=
) (someTextField.text += moreText
gibi) daha etkilidir.
Parametreler
newText:String — Varolan metne eklenecek dize.
|
Örnek ( Bu örnek nasıl kullanılır? )
outputText
metin alanı autoSize
özelliği kullanılarak metne otomatik olarak sığacak ve sağa yaslanmış metin olarak yeniden boyutlandırılacak şekilde ayarlanmıştır. outputText.text
özelliği içeriğin ilk satırını yazar ve appendText()
yöntemi içeriğin geri kalan kısmına eklenir. (text
özelliğiyle başlanmasına gerek yoktur. Başlangıçtan itibaren metin eklemek için appendText()
yöntemi kullanılabilir.) text
özelliğinin ikinci kez ayarlanması orijinal metnin üstüne yazar. text
özelliğine sahip içeriği eklemek için +=
operatörünü kullanın.
if
ifadesi tarihin Cumartesi (6) veya Pazar (0) olduğunu kontrol eder. İkisi de değilse, toLocaleTimeString()
yöntemi yerel zamanı döndürür ve bu da metin alanının içeriğine eklenir.
Metin alanının length
özelliği işlev çağrılmadan hemen önce karakter sayısını okumak için kullanılırken numLines
özelliği ise metin alanındaki satır sayısını saymak için kullanılır. Boş satırların satır sayısına dahil olduğunu ve boş boşlukların ve satır kesmelerinin (\n) içerik uzunluğunu belirlerken dahil edildiğini unutmayın.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_appendTextExample extends Sprite { public function TextField_appendTextExample() { var outputText:TextField = new TextField(); var today:Date = new Date(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.text = "WHAT TIME IS IT?" + "\n\n"; if((today.day == 0) || (today.day == 6)) { outputText.appendText("It's the weekend."); outputText.appendText("\n\n"); } else { outputText.appendText("The time is: "); outputText.appendText(today.toLocaleTimeString() + ".\n\n"); } outputText.appendText("Number of characters including line breaks and spaces so far: "); outputText.appendText(outputText.length.toString() + "\n"); outputText.appendText("Number of lines in the outputText: "); outputText.appendText(outputText.numLines.toString()); this.addChild(outputText); } } }
getCharBoundaries | () | yöntem |
public function getCharBoundaries(charIndex:int):Rectangle
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Karakterin sınırlama kutusu olan bir dikdörtgen döndürür.
Parametreler
charIndex:int — Karaktere yönelik sıfır temelli dizin değeri. (Örneğin, ilk konum 0, ikinci konum 1 şeklinde devam eder.)
|
Rectangle — Karakterin sınırlama kutusunu tanımlayan minimum ve maksimum x ve y değerlerine sahip bir dikdörtgen.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
getCharBoundaries()
yöntemi kullanıcı tarafından seçilen bir karakteri işaretlemek (spot ışığı vermek) için kullanılmıştır.
Sınıf, seçilen her karakterin etrafına bir dikdörtgen çizmek için kullanılan spotlight
Shape nesnesini tanımlar. Kullanıcı myTextField
metin alanını tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde, getCharIndexAtPoint()
yöntemi tıklatılan karakterin dizinini, fare tıklatmasının (içeren Sprite
öğesiyle ilişkili) localX
ve localY
koordinatlarına dayanarak alır. Nokta (fare tıklatması) herhangi bir karakterin üzerinde değilse getCharIndexAtPoint()
yöntemi -1
değerini döndürür. Metin alanı metinden daha büyük olabileceğinden kullanıcının bir karakteri tıklattığından emin olmak için döndürülen tam sayı (index
) kontrol edilir. index
tam sayısı ayrıca karakterin sınırını tutan bir Rectangle
nesnesi almak için getCharBoundaries()
tarafından kullanılır. clear()
yöntemi önceden görüntülenmiş tüm spotlight
Shape nesnelerini temizler. Döndürülen frame
dikdörtgeninin x ve y koordinatlarını kullanarak karakterin konumunda ((10, 10) koordinatlarından olan uzaklık) karakterin genişlik ve yükseklik sınırlarını belirleyen bir dikdörtgen oluşturulur. Karaktere spot ışığı vermek için, spotlight
Shape nesnesi karakter görülecek şekilde sarı renkle doldurulur ve opaklık yüzde 35'e ayarlanır. Boşlukların da bir karakter olarak kabul edildiğini unutmayın.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; import flash.display.Shape; public class TextField_getCharBoundariesExample extends Sprite { private var myTextField:TextField = new TextField(); private var spotlight:Shape = new Shape(); public function TextField_getCharBoundariesExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.selectable = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "Selected a character from this text by clicking on it." myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(spotlight); } private function clickHandler (e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { var frame:Rectangle = myTextField.getCharBoundaries(index); spotlight.graphics.clear(); spotlight.graphics.beginFill(0xFFFF00, .35); spotlight.graphics.drawRect((frame.x + 10), (frame.y + 10), frame.width, frame.height); spotlight.graphics.endFill(); } } } }
getCharIndexAtPoint | () | yöntem |
public function getCharIndexAtPoint(x:Number, y:Number):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
x
ve y
parametreleri tarafından belirtilen noktadaki karakterin sıfır temelli dizin değerini döndürür.
Parametreler
x:Number — Karakterin x koordinatı.
| |
y:Number — Karakterin y koordinatı.
|
int — Karaktere yönelik sıfır temelli dizin değeri. (Örneğin, ilk karakter 0, ikinci karakter 1 şeklinde devam eder.) Nokta herhangi bir karakterin üzerinde değilse -1 değerini döndürür.
|
Örnek ( Bu örnek nasıl kullanılır? )
İlk metin alanı kullanıcının seçeceği metni tutar. Metnin tıklatıldığından ancak seçilmediğinden emin olmak için selectable
özelliği false olarak ayarlanır. Kullanıcı firstTextField
metin alanını tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde getCharIndexAtPoint()
yöntemi, fare tıklatmasının localX
ve localY
koordinatlarına dayanarak karakterin dizinini döndürür. Metin alanı metinden daha büyük olabileceğinden kullanıcının bir karakteri tıklattığından emin olmak için döndürülen tam sayı (index
) kontrol edilir. Nokta (fare tıklatması) bir karakterin üzerinde değilse getCharIndexAtPoint()
yöntemi -1
değerini döndürür. Fare koordinatları, yansıtılan karakterin görüneceği yeni metin alanının koordinatlarını ayarlamak için kullanılır. İkinci metin alanındaki karakterin rengi kırmızı olarak ayarlanır. Sonuç olarak ikinci alanın metni, charAt()
yöntemi kullanılarak alınan seçili karaktere ayarlanır. appendText()
yöntemi yerine text
özelliğinin kullanılmasının ikinci metin alanındaki karakteri eklemek yerine geçersiz kılacağını unutmayın.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.geom.Rectangle; import flash.events.MouseEvent; import flash.text.TextFieldAutoSize; public class TextField_getCharIndexAtPointExample extends Sprite { private var firstTextField:TextField = new TextField(); private var secondTextField:TextField = new TextField(); public function TextField_getCharIndexAtPointExample() { firstTextField.x = 100; firstTextField.y = 100; firstTextField.width = 260; firstTextField.height = 20; firstTextField.border = true; firstTextField.background = true; firstTextField.selectable = false; firstTextField.text = "Selected a character from this text by clicking on it." firstTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(firstTextField); this.addChild(secondTextField); } private function clickHandler (e:MouseEvent):void { var index:int = firstTextField.getCharIndexAtPoint(e.localX, e.localY); if (index != -1) { secondTextField.x = mouseX; secondTextField.y = 70; secondTextField.border = true; secondTextField.selectable = false; secondTextField.background = true; secondTextField.textColor = 0xFF0000; secondTextField.autoSize = TextFieldAutoSize.LEFT; secondTextField.text = firstTextField.text.charAt(index); } } } }
getFirstCharInParagraph | () | yöntem |
public function getFirstCharInParagraph(charIndex:int):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir karakter dizini belirtilirse, aynı paragraftaki ilk karakterin dizinini döndürür.
Parametreler
charIndex:int — Karakterin sıfır temelli dizin değeri. (Örneğin, ilk karakter 0, ikinci karakter 1 şeklinde devam eder.)
|
int — Aynı paragraftaki ilk karakterin sıfır temelli dizin değeri.
|
Atar
RangeError — Belirtilen karakter dizini aralık dışındadır.
|
Örnek ( Bu örnek nasıl kullanılır? )
Yapıcıda, myTextField
metin alanı metin kaydırmaya ayarlanmıştır. getTextFormat
metin alanında bulunan içerikteki ilk karakterin orijinal biçimini döndürür ve bu da originalFormat
TextFormat nesnesine yerleştirilir. Yeni bir TextFormat nesnesi de (newFormat
) tanımlanır ve align
özelliği sağa doğru hizalı olarak atanır. Kullanıcı metin alanını tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde getCharIndexAtPoint()
yöntemi, fare tıklatmasının localX
ve localY
koordinatlarına dayanarak karakterin dizinini döndürür. İlk if
ifadesi kullanıcının bir karakteri tıklatıp tıklatmadığını kontrol eder. getCharIndexAtPoint()
yöntemi tarafından döndürülen clickIndex
tam sayısı kullanıldığında getFirstCharInParagraph()
yöntemi kullanıcının tıklattığı paragraftaki ilk karakterin dizini döndürülür. Paragraftaki son karakterin dizini, paragraftaki ilk karakterin dizinine paragrafın uzunluğu eklenip (getParagraphLength()
yöntemi kullanılarak) bu değerden son karakter çıkarılarak (\n
) belirlenir. İkinci if
ifadesi paragraftaki ilk karakterin biçimini kontrol eder. Hizalama değeri orijinal biçimle aynıysa (sola yaslanmış), yeni biçim paragraftaki tüm karakterlere uygulanır. Aksi halde paragrafın biçimi orijinal biçime geri ayarlanır. Girinti, madde imi, sekme durağı, sol ve sağ kenar boşluğu gibi biçimlendirmenin yanı sıra hizalama, paragraflara yönelik biçimlerdir. Kelime kaydırma veya satır kesmesi kullanıldığında, endIndex
argümanı setTextFormat()
yöntemi için tanımlanmamışsa biçimlendirmenin yalnızca paragrafın ilk satırına uygulanacağını unutmayın.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFormatAlign; public class TextField_getFirstCharInParagraphExample extends Sprite { private var myTextField:TextField = new TextField(); private var originalFormat:TextFormat = new TextFormat(); private var newFormat:TextFormat = new TextFormat(); public function TextField_getFirstCharInParagraphExample() { myTextField.x = 10; myTextField.y = 10; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 300; myTextField.background = true; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime.\n\n"); originalFormat = myTextField.getTextFormat(0); newFormat.align = TextFormatAlign.RIGHT; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var clickIndex:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(clickIndex != -1) { var paragraphFirstIndex:int = myTextField.getFirstCharInParagraph(clickIndex); var paragraphEndIndex:int = paragraphFirstIndex + ((myTextField.getParagraphLength(clickIndex) - 1)); if (myTextField.getTextFormat(paragraphFirstIndex).align == originalFormat.align) { myTextField.setTextFormat(newFormat, paragraphFirstIndex, paragraphEndIndex); }else { myTextField.setTextFormat(originalFormat, paragraphFirstIndex, paragraphEndIndex); } } } } }
getImageReference | () | yöntem |
public function getImageReference(id:String):DisplayObject
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
<img>
etiketi kullanılarak bir HTML biçimli metin alanına eklenmiş belirli id
öğesine, görüntüye veya SWF dosyasına bir DisplayObject başvurusu döndürür. <img>
etiketi şu biçimdedir:
<img src = 'filename.jpg' id = 'instanceName' >
Parametreler
id:String — Eşleşecek id (<img> etiketinin id niteliğinde).
|
DisplayObject — Metin alanının <img> etiketinde eşleşen id niteliğine sahip görüntü veya SWF dosyasına karşılık gelen görüntüleme nesnesi. Harici bir kaynaktan yüklenen medyada bu nesne bir Loader nesnesidir ve bir kez yüklendiğinde ortam nesnesi bu Loader nesnesinin bir alt öğesi olur. SWF dosyasına gömülü medyada bu, yüklenen nesnedir. Eşleşen id öğesine sahip bir <img> etiketi yoksa, yöntem null değerini döndürür.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
Görüntü (image.jpg
) HTML üzerinden dahil edilir. (Burada, görüntü dosyasının SWF dosyasıyla aynı dizin içinde olduğu varsayılmıştır.) Görüntüye getImageReference()
yöntemini kullanarak erişmek üzere img
etiketi için bir id
niteliği tanımlanmalıdır. htmlText
özelliği HTML biçimli dize içeriğini dahil etmek için kullanılır. Kullanıcı myTextField
metin alanını tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde, getImageReference()
yöntemi görüntüye DisplayObject
şeklinde bir başvuru döndürür. Bu başvuru görüntüyü herhangi bir DisplayObject
nesnesi gibi işlemenize izin verir. Burada alpha
(saydamlık) ve rotation
özellikleri ayarlanmıştır. transform
özelliği ayrıca görüntüleme nesnesinin matris, renk dönüştürme ve piksel sınırlarına erişmek için kullanılabilir. flash.display.DisplayObject
öğesinin içe aktarılması gerektiğini de unutmayın.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.Event; import flash.events.MouseEvent; import flash.display.DisplayObject; import flash.text.TextFieldAutoSize; public class TextField_getImageReferenceExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_getImageReferenceExample() { var myText1:String = "<p>Here is an image we want to mainpulate: <img src='image.jpg' id='testimage'></p>"; myTextField.x = 10; myTextField.y = 10; myTextField.width = 250; myTextField.height = 250; myTextField.background = true; myTextField.border = true; myTextField.border = true; myTextField.multiline = true; myTextField.htmlText = myText1; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); } private function clickHandler(e:MouseEvent):void { var imageRef:DisplayObject = myTextField.getImageReference("testimage"); imageRef.rotation += 90; imageRef.x = 125; imageRef.y = 125; imageRef.alpha = 0.25; } } }
getLineIndexAtPoint | () | yöntem |
public function getLineIndexAtPoint(x:Number, y:Number):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
x
ve y
parametreleri tarafından belirtilen noktadaki satırın sıfır temelli dizin değerini döndürür.
Parametreler
x:Number — Satırın x koordinatı.
| |
y:Number — Satırın y koordinatı.
|
int — Satıra yönelik sıfır temelli dizin değeri. (Örneğin, ilk satır 0, ikinci satır 1 şeklinde devam eder.) Nokta herhangi bir satırın üzerinde değilse -1 değerini döndürür.
|
Örnek ( Bu örnek nasıl kullanılır? )
Yapıcıda, poem
metin alanı kaydırmaya ayarlanmamıştır (şiir olduğu için). autoSize
özelliği ayrıca metni otomatik olarak sığdıracak ve sola yaslanmış bir metin yapacak şekilde ayarlamak için kullanılır. poemCopy
metin alanı poem
metin alanının altına yerleştirilir. Kullanıcı şiirin herhangi bir satırını tıklattığında clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde, getLineIndexAtPoint()
yöntemi, fare tıklatmasının localX
ve localY
koordinatlarına dayanarak kullanıcının tıklattığı yerin satır dizinini döndürür. (Burada orijinal şiir buradaki metin alanının boyutuna sığdığından, getCharIndexAtPoint()
yöntemi tarafından verilen aralık dışında olma hatasının (RangeError
) olup olmadığını kontrol etmeye gerek yoktur.) Satır dizini daha sonra, satır içeriğini getLineText()
yöntemini kullanarak daha sonra poemCopy
metin alanı içeriğine eklenen bir dize olarak almak için kullanılır. Kopyalama işlemi kesilmeden devam edebilir ancak bir noktadan sonra metin, görüntülenebilir poemCopy
metin alanının dışında kalacaktır.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexAtPointExample extends Sprite { private var poem:TextField = new TextField(); private var poemCopy:TextField = new TextField(); public function TextField_getLineIndexAtPointExample() { poem.border = true; poem.autoSize = TextFieldAutoSize.LEFT; poem.x = 10; poem.wordWrap = false; poemCopy.height = 250; poemCopy.width = 270; poemCopy.y = 230; poemCopy.x = 10; poemCopy.background = true; poemCopy.border = true; poemCopy.wordWrap = false; poem.appendText("Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved."); poem.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(poem); this.addChild(poemCopy); } private function clickHandler(e:MouseEvent):void { var index:int = poem.getLineIndexAtPoint(e.localX, e.localY); var s:String; s = poem.getLineText(index); poemCopy.appendText(s + "\n"); } } }
getLineIndexOfChar | () | yöntem |
public function getLineIndexOfChar(charIndex:int):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
charIndex
parametresinin belirttiği karakteri içeren satırın sıfır temelli dizin değeri.
Parametreler
charIndex:int — Karakterin sıfır temelli dizin değeri. (Örneğin, ilk karakter 0, ikinci karakter 1 şeklinde devam eder.)
|
int — Satırın sıfır temelli dizin değeri.
|
Atar
RangeError — Belirtilen karakter dizini aralık dışındadır.
|
Örnek ( Bu örnek nasıl kullanılır? )
getLineIndexOfChar()
yöntemi metin alanındaki 100. ve 500. karakterler için satır numaralarını döndürür.
myTextField
metin alanı sola yaslanmış metin olarak kaydırma ve yeniden boyutlandırma için tanımlanmıştır. getLineIndexOfChar()
yöntemi, belirtilen karakter dizinlerine yönelik satır dizinini döndürür (100 ve 500). Ardından bu bilgi, paragraftan sonra eklenir. 0 ile başladığından, satır numarasını almak için satır dizininin (index
) 1 arttırıldığını unutmayın. Ayrıca görüntü yeniden boyutlandırılırsa satır numarası değişebilir ancak yöntem yalnızca bir kez çağrıldığından buradaki bilgiler aynı kalacaktır.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_getLineIndexOfCharExample extends Sprite { public function TextField_getLineIndexOfCharExample() { var myTextField:TextField = new TextField(); myTextField.x = 10; myTextField.y = 10; myTextField.width = 200; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n"); var index:int = myTextField.getLineIndexOfChar(100); myTextField.appendText("100th character is in line: " + (index + 1) + "\n"); index = myTextField.getLineIndexOfChar(500); myTextField.appendText("500th character is in line: " + (index + 1)); this.addChild(myTextField); } } }
getLineLength | () | yöntem |
public function getLineLength(lineIndex:int):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirli bir metin satırındaki karakter sayısını döndürür.
Parametreler
lineIndex:int — Uzunluğu istediğiniz satır numarası.
|
int — Satırdaki karakter sayısı.
|
Atar
RangeError — Belirtilen satır numarası aralık dışındadır.
|
Örnek ( Bu örnek nasıl kullanılır? )
İşlemi göstermek amacıyla sayılacak metni görüntüleyen myTextField
metin alanı, INPUT
öğesine ayarlanır. Bu durum kullanıcıların satırları değiştirebileceği veya satırların arasına ya da sonuna satır ekleyebileceği anlamına gelir. (Son satırın sonunda satır kesmesi (\n
) kullanılarak oluşturulan boş bir satır vardır.) Sayılan uzunluk sonucunun görüntülendiği countLines
metin alanı myTextField
metin alanının altına ayarlanır ve metni seçilemez. Kullanıcı myTextField
metin alandaki bir satırı tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde, getLineIndexAtPoint()
yöntemi, fare tıklatmasının localX
ve localY
koordinatlarını kullanarak kullanıcının tıklattığı yerin satır dizinini döndürür. if
ifadesi kullanıcının bir karakteri tıklatıp tıklatmadığını kontrol eder. Bu durumda getLineLength()
yöntemi satırın dizinini kullanarak satırdaki karakter sayısını döndürür. Satırlar arasındaki boş satırların ikinci satır kesmesini (\n
) içerdiğini ve 1 karakter uzunluğunda olduğunu ve son satırdan sonraki satır için bu değerin 0 olduğunu unutmayın. Boşluklar da bir karakter olarak sayılır. Kullanıcılar yeni bir satır yazabilir veya bir satırı değiştirebilir ve üzerini tıklatarak satırın uzunluğunu sayabilir. Kelime kaydırma kullanılıyorsa ve ekran yeniden boyutlandırılırsa satır dizini değişebilir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.events.Event; import flash.events.MouseEvent; public class TextField_getLineLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countLines:TextField = new TextField(); public function TextField_getLineLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 350; myTextField.height = 150; myTextField.background = true; myTextField.border = true; myTextField.type = TextFieldType.INPUT; myTextField.appendText("Click on the lines to count its number of characters:\n\n"); myTextField.appendText("This is a short line.\n"); myTextField.appendText("This is a longer line than the last line.\n\n"); myTextField.appendText("This one is even longer than the one before. It has two sentences.\n"); this.addChild(myTextField); countLines.border = true; countLines.x = 10; countLines.y = 180; countLines.height = 30; countLines.width = 200; countLines.background = true; countLines.selectable = false; this.addChild(countLines); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getLineIndexAtPoint(e.localX, e.localY); if (index != -1) { var lenght:int = myTextField.getLineLength(index); countLines.text = "Number of characters in the line is: " + lenght.toString(); } } } }
getLineMetrics | () | yöntem |
public function getLineMetrics(lineIndex:int):flash.text:TextLineMetrics
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Belirli bir metin satırı hakkındaki ölçüm bilgilerini döndürür.
Parametreler
lineIndex:int — Ölçüm bilgilerini istediğiniz satır numarası.
|
flash.text:TextLineMetrics — Bir TextLineMetrics nesnesi.
|
Atar
RangeError — Belirtilen satır numarası aralık dışındadır.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
Eklenen metin Walt Whitman'ın Song of Myself şiirinden iki satır uzaktadır. Yeni bir TextFormat nesnesi olan (newFormat
) ikinci satırın biçimini ayarlamak için kullanılır. İlk satır varsayılan biçimi korur. getLineMetrics()
yöntemi belirli bir satıra yönelik bir TextLineMetrics
nesnesi döndürür. (Satır dizini 0'la başlar.) Birinci ve ikinci satırları için metrics1
ve metrics2
TextLineMetrics nesnelerini kullanırsanız, satırın çıkış, iniş, yükseklik ve genişlik değeri alınır ve görüntülenir. Sonuç olarak ortaya çıkan sayılar dizeye dönüştürülür ancak yuvarlanmaz. Bu değerin satır için olduğunu, belirli bir karakter için olmadığını unutmayın. Bir satıra yönelik karakter aralığını yansıtır. Örneğin, bir satır farklı yükseklik biçimlerine sahip farklı karakterler içeriyorsa en fazla yükseklik değerine sahip karakter değeri belirler. Bu durum ayrıca karakter biçimlerinden birinin değişmesi durumunda ölçüm değerlerinden bazılarının da değişeceği anlamına gelir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextLineMetrics; import flash.text.TextFieldAutoSize; import flash.text.AntiAliasType; import flash.text.TextFormat; public class TextField_getLineMetricsExample extends Sprite { public function TextField_getLineMetricsExample() { var myTextField:TextField = new TextField(); var newFormat:TextFormat = new TextFormat(); myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.wordWrap = false; myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.appendText("A child said What is the grass? fetching it to me with full hands;\n"); myTextField.appendText("How could I answer the child? I do not know what it is any more than he.\n\n"); newFormat.size = 14; newFormat.font = "Arial"; newFormat.italic = true; myTextField.setTextFormat(newFormat, 67, 139); var metrics1:TextLineMetrics = myTextField.getLineMetrics(0); myTextField.appendText("Metrics ascent for the line 1 is: " + metrics1.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics1.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics1.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics1.width.toString() + "\n\n"); var metrics2:TextLineMetrics = myTextField.getLineMetrics(1); myTextField.appendText("Metrics ascent for the line 2 is: " + metrics2.ascent.toString() + "\n"); myTextField.appendText("Metrics descent is: " + metrics2.descent.toString() + "\n"); myTextField.appendText("Metrics height is: " + metrics2.height.toString() + "\n"); myTextField.appendText("Metrics width is: " + metrics2.width.toString() + "\n"); addChild(myTextField); } } }
getLineOffset | () | yöntem |
public function getLineOffset(lineIndex:int):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
lineIndex
parametresinin belirttiği satırdaki ilk karakterin karakter dizinini döndürür.
Parametreler
lineIndex:int — Satıra yönelik sıfır temelli dizin değeri. (Örneğin, ilk satır 0, ikinci satır 1 şeklinde devam eder.)
|
int — Satırdaki ilk karakterin sıfır temelli dizin değeri.
|
Atar
RangeError — Belirtilen satır numarası aralık dışındadır.
|
Örnek ( Bu örnek nasıl kullanılır? )
myTextField
metin alanı kelime kaydırmaya ayarlanmıştır. countField
metin alanı 4. satırın ilk karakterini görüntüleyecektir. Kullanıcı myTextField
metin alanını tıklattığında, clickHandler()
yöntemi çağrılır.
clickHandler()
yönteminde, getLineOffset()
yöntemi, metnin dördüncü satırı olan 3. satır dizinindeki ilk karakterin dizinini döndürür. (İlk satırın dizini 0'dır.) charAt()
yöntemi, dördüncü satırdaki ilk karakterin dizinini kullanarak karakteri almak için kullanılır. countField
metin alanı içeriği, countField
metin alanının text
özelliği kullanılarak bu bilgilerle güncellenir. countField.text
özelliğinin kullanılması, her tıklatma işleminden sonra countField
metin alanının içeriğinin üzerine yazılacağı anlamına gelir. Kullanıcı görüntüyü yeniden boyutlandırırsa içerik kaydırılır ve 4. satırın ilk karakteri değişebilir. myTextField
alanını yeniden tıklattığınızda, countField
metin alanının içeriği dördüncü satırın yeni ilk karakteriyle güncellenir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getLineOffsetExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getLineOffsetExample() { myTextField.x = 10; myTextField.y = 10; myTextField.width = 150; myTextField.height = 300; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; countField.height = 20; countField.width = 200; countField.x = 10; countField.y = 320; countField.selectable = false; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file " + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var c:String; var index:int; index = myTextField.getLineOffset(3); c = myTextField.text.charAt(index); countField.text = "The first character of line 4 is: " + c; } } }
getLineText | () | yöntem |
public function getLineText(lineIndex:int):String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Satırın lineIndex
parametresi tarafından belirtilen metnini döndürür.
Parametreler
lineIndex:int — Satıra yönelik sıfır temelli dizin değeri. (Örneğin, ilk satır 0, ikinci satır 1 şeklinde devam eder.)
|
String — Belirtilen satırda bulunan metin dizesi.
|
Atar
RangeError — Belirtilen satır numarası aralık dışındadır.
|
Örnek ( Bu örnek nasıl kullanılır? )
poem
metin alanı metne otomatik olarak sığacak ve sola yaslanmış metin olarak yeniden boyutlandırılacak şekilde ayarlanır. wordWrap
özelliği false
olarak ayarlanır ve böylece şiirin satırları kaydırılmaz, ancak normalde autoSize
özelliğini kullanırken bu bir sorun oluşturmamalıdır. for
döngüsü, metin alanının numLines
özelliğini kullanarak sonenin satırları boyunca yinelenir. getLineText()
yöntemi satırın içeriğini bir dize olarak döndürür. (numLines
özelliği 1. satır ile başlayan satır numaraları döndürürken getLineText()
yönteminde satır numarasının 0 ile başladığını unutmayın.) Normal ifade kalıbını (/love/i
) kullanan if
ifadesi, kelimenin büyük veya küçük harfli herhangi bir alt dizesini arar. Kalıp bulunursa, search
yöntemi eşleşen ilk alt dizenin dizinini döndürür, aksi halde -1
değerini döndürür (eşleşme yoksa). "love" kelimesinin bulunduğu satır numarası ((i + 1)
) daha sonra lineResult
dizesine yerleştirilir. Dize olan başka bir argüman (" ") olduğu sürece dize yöntemi numara argümanını ((i + 1)
) bir dizeye dönüştürür. Aramanın satır sonuçları "loved" veya "Love's" kelimelerinin bulunduğu satırları içerir. "Love was found in lines:" satırı for
döngüsünden önce eklenirse bu satırdaki "Love" kelimesi de dahil edilir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.utils.Timer; import flash.events.TimerEvent; public class TextField_getLineTextExample extends Sprite { public function TextField_getLineTextExample() { var poem:TextField = new TextField(); var lineResult:String = ""; var pattern:RegExp = /love/i; poem.x = 10; poem.y = 10; poem.background = true; poem.wordWrap = false; poem.autoSize = TextFieldAutoSize.LEFT; poem.text = "Let me not to the marriage of true minds\n" + "Admit impediments. love is not love\n" + "Which alters when it alteration finds\n" + "Or bends with the remover to remove:\n" + "O no! it is an ever-fixed mark\n" + "That looks on tempests and is never shaken;\n" + "It is the star to every wandering bark,\n" + "Whose worth's unknown, although his height be taken.\n" + "Love's not Time's fool, though rosy lips and cheeks\n" + "Within his bending sickle's compass come:\n" + "Love alters not with his brief hours and weeks,\n" + "But bears it out even to the edge of doom.\n" + "If this be error and upon me proved,\n" + "I never writ, nor no man ever loved.\n\n"; for (var i:int = 0; i < poem.numLines; i++) { var s:String = poem.getLineText(i); if(s.search(pattern) != -1) { lineResult += (i + 1) + " "; } } poem.appendText("Love was found in lines: " + lineResult); this.addChild(poem); } } }
getParagraphLength | () | yöntem |
public function getParagraphLength(charIndex:int):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bir karakter dizini belirtilirse, belirtilen karakteri içeren paragraf uzunluğu döndürülür. Uzunluk paragraftaki ilk karakterle (getFirstCharInParagraph()
tarafından döndürüldüğü şekilde) ilişkilidir, içeri iletilen karakter diziniyle ilişkili değildir.
Parametreler
charIndex:int — Karakterin sıfır temelli dizin değeri. (Örneğin, ilk karakter 0, ikinci karakter 1 şeklinde devam eder.)
|
int — Paragraftaki karakter sayısını döndürür.
|
Atar
RangeError — Belirtilen karakter dizini aralık dışındadır.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
myTextField
metin alanı kullanıcının seçeceği paragrafları görüntüler. Kullanıcı bir metin alanını tıklattığında MouseEvent.CLICK
olayı gönderilir ve clickHandler()
yöntemi çağrılır. Paragraf uzunluğu ve "s" karakterlerinin sayısı myTextField
metin alanının altında bulunan countField
metin alanında görünecektir.
clickHandler()
yönteminde getCharIndexAtPoint()
yöntemi, fare tıklatmasının localX
ve localY
koordinatlarına dayanarak karakterin dizinini döndürür. İlk if
ifadesi kullanıcının bir karakteri tıklatıp tıklatmadığını kontrol eder. getFirstCharInParagraph()
yöntemi, aynı paragraftaki ilk karakterin dizinini döndürmek için bu dizini kullanır. getParagraphLength()
yöntemi tarafından döndürülen paragraf uzunluğu, paragrafın sonuna yönelik dizini belirlemek için paragraftaki ilk karakterin diziniyle birlikte kullanılır. Bir for
döngüsü "s" karakterlerinin sayısını hesaplayarak paragraf boyunca yinelenir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_getParagraphLengthExample extends Sprite { private var myTextField:TextField = new TextField(); private var countField:TextField = new TextField(); public function TextField_getParagraphLengthExample() { myTextField.x = 10; myTextField.y = 10; myTextField.background = true; myTextField.border = true; myTextField.wordWrap = true; myTextField.width = 300; myTextField.height = 280; myTextField.appendText("The TextField class is used to create display objects for " + "text display and input. All dynamic and input text fields in a SWF file" + "are instances of the TextField class. You can use the TextField class " + "to perform low-level text rendering. However, in Flex, you typically use " + "the Label, Text, TextArea, and TextInput controls to process text. " + "You can give a text field an instance name in the Property inspector " + "and use the methods and properties of the TextField class to manipulate it with ActionScript. " + "TextField instance names are displayed in the Movie Explorer and in the Insert " + "Target Path dialog box in the Actions panel.\n\n" + "To create a text field dynamically, use the TextField() constructor.\n\n" + "The methods of the TextField class let you set, select, and manipulate " + "text in a dynamic or input text field that you create during authoring or at runtime."); myTextField.addEventListener(MouseEvent.CLICK, clickHandler); countField.x = 10; countField.y = 300; countField.height = 50; countField.width = 250; countField.background = true; countField.selectable = false; this.addChild(myTextField); this.addChild(countField); } private function clickHandler(e:MouseEvent):void { var index:int = myTextField.getCharIndexAtPoint(e.localX, e.localY); if(index != -1) { var beginParag:int = myTextField.getFirstCharInParagraph(index); var paragLength:int = myTextField.getParagraphLength(index); var endParag:int = beginParag + paragLength; var sCount:uint = 0; for (var i:int = beginParag; i <= endParag; i++) { if ((myTextField.text.charAt(i) == "s") || (myTextField.text.charAt(i) == "S")) { sCount++; } countField.text = "Paragraph length is: " + paragLength.toString() + "\n" + "Number of 's' characters in the paragraph: " + sCount.toString(); } } } } }
getTextFormat | () | yöntem |
public function getTextFormat(beginIndex:int = -1, endIndex:int = -1):flash.text:TextFormat
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
parametrelerinin belirttiği metin aralığına yönelik biçimlendirme bilgileri içeren bir TextFormat nesnesi döndürür. Yalnızca belirtilen metnin tamamında ortak olan özellikler sonuç olarak ortaya çıkan TextFormat nesnesinde ayarlanır. Metindeki farklı noktalarda farklı değerlere sahip karmaşık olan herhangi bir özellik null
değerine sahiptir.
Bu parametreler için değer belirtmezseniz bu yöntem metin alanındaki tüm metinlere uygulanır.
Şu tablo olası üç kullanımı açıklamaktadır:
Kullanım | Açıklama |
---|---|
my_textField.getTextFormat() | Bir metin alanındaki tüm metin için biçimlendirme bilgisi içeren bir TextFormat nesnesi döndürür. Yalnızca metin alanındaki tüm metinde ortak olan özellikler sonuç olarak ortaya çıkan TextFormat nesnesinde ayarlanır. Metindeki farklı noktalarda farklı değerlere sahip karmaşık olan herhangi bir özellik null değerine sahiptir. |
my_textField.getTextFormat(beginIndex:Number) | beginIndex konumundaki karakterin metin biçimi kopyasını içeren bir TextFormat nesnesi döndürür. |
my_textField.getTextFormat(beginIndex:Number,endIndex:Number) | beginIndex ile endIndex-1 arasındaki metin yayılmasına yönelik biçimlendirme bilgilerini içeren bir TextFormat nesnesi döndürür. Yalnızca belirtilen aralıktaki tüm metinde ortak olan özellikler sonuç olarak ortaya çıkan TextFormat nesnesinde ayarlanır. Karışık değere sahip bir özelliğin (aralıktaki farklı noktalarda farklı değerlere sahip) değeri null olarak ayarlanmıştır. |
Parametreler
beginIndex:int (default = -1 ) — İsteğe bağlı; metin alanı içerisindeki metin aralığının başlangıç konumunu belirten bir tam sayı.
| |
endIndex:int (default = -1 ) — İsteğe bağlı; istenen metin yayılmasından sonraki ilk karakterin konumunu belirten bir tam sayı. Tasarlandığı gibi beginIndex ve endIndex değerlerini belirtirseniz, beginIndex ile endIndex-1 arasındaki metin okunur.
|
flash.text:TextFormat — Belirtilen metnin biçimlendirme özelliklerini temsil eden TextFormat nesnesi.
|
Atar
RangeError — Belirtilen beginIndex veya endIndex aralık dışındadır.
|
İlgili API Öğeleri
Örnek
Bu örnek nasıl kullanılır?
getTextFormat()
yönteminin nasıl kullanıldığını gösteren şekiller için getFirstCharInParagraph() veya setTextFormat() yönteminin örneğine bakın.
isFontCompatible | () | yöntem |
public static function isFontCompatible(fontName:String, fontStyle:String):Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bir gömülü font, Font.fontType
öğesinin flash.text.FontType.EMBEDDED
olduğu belirli fontName
ve fontStyle
ile mevcutsa true değeri döndürülür. Flash Player 10 ve sonraki sürümlerinde, bir SWF dosyasında iki gömülü font çeşidi bulunabilir. Normal gömülü fontlar yalnızca TextField nesneleri ile kullanılır. CFF gömülü fontlar yalnızca flash.text.engine sınıflarıyla kullanılabilir. enumerateFonts()
işleviyle döndürüldüğü gibi iki tür, Font
sınıfının fontType
özelliğiyle ayırt edilir.
TextField, EMBEDDED_CFF
türünde bir font kullanamaz. embedFonts
, true
değerine ayarlandıysa ve belirtilen ad ve stille çalışma zamanındaki mevcut tek font EMBEDDED_CFF
türüyse Flash Player, belirtilen ad ve stille gömülü font yokmuş gibi davranarak, metni oluşturmaz.
Hem EMBEDDED
hem de EMBEDDED_CFF
fontları aynı ad ve stille mevcutsa, EMBEDDED
fontu seçilir ve metin, EMBEDDED
fontuyla oluşturulur.
Parametreler
fontName:String — Denetlenecek gömülü fontun adı.
| |
fontStyle:String — Denetlenecek font stilini belirtir. flash.text.FontStyle kullanın
|
Boolean — Uyumlu bir gömülü font mevcutsa true ; değilse false olur.
|
Atar
ArgumentError — Belirtilen fontStyle , flash.text.FontStyle öğesinin bir üyesi değildir.
|
İlgili API Öğeleri
replaceSelectedText | () | yöntem |
public function replaceSelectedText(value:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geçerli seçimi, value
parametresinin içeriği ile değiştirir. Geçerli varsayılan karakter biçimi ve varsayılan paragraf biçimi kullanılarak metin geçerli seçimin konumuna eklenir. Metne HTML olarak müdahale edilmez.
Metnin geri kalanının karakterini ve paragraf biçimlendirmesini bozmadan metin eklemek ve silmek için replaceSelectedText()
yöntemini kullanabilirsiniz.
Not: Metin alanına bir stil sayfası uygulanırsa bu yöntem çalışmaz.
Parametreler
value:String — O anda seçili olan metni değiştirmek için kullanılan dize.
|
Atar
Error — Bu yöntem bir stil sayfasına sahip bir metin alanında kullanılamaz.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
İki farklı TextField nesnesi oluşturulur ve MouseEvent.MOUSE_UP
olaylarına yönelik olay dinleyicileri eklenir. Kullanıcı fareyi serbest bıraktığında fare yukarı hareket eder. Bu, bir metin seçimi yapıldıktan sonra normalde meydana gelen bir olaydır. Bir metin alanına yönelik varsayılan ayarın seçilecek metin için olduğunu unutmayın.
mouseHandler1()
yönteminde, kullanıcı bir myTextField1
metin alanındayken fareyi bıraktığında metin, boş bir dizeyle değiştirilerek değiştirilir. Bu durum tüm metin silinene kadar devam edebilir. mouseHandler2()
yönteminde, kullanıcı myTextField2
metin alanında metnin bir kısmını seçtiğinde, selectionBeginIndex
ve selectionEndIndex
özellikleri herhangi bir karakterin seçili olup olmadığını görmek için kontrol edilir. (Metnin bir kısmı seçilmişse selectionBeginIndex
ve selectionEndIndex
özellikleri aynı değere sahip olmaz.) Seçili metin daha sonra "NEW TEXT" dizesiyle değiştirilir. Bu durum ikinci metin alanındaki tüm orijinal metin "NEW TEXT" dizesiyle değiştirilene kadar devam edebilir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.events.MouseEvent; public class TextField_replaceSelectedTextExample extends Sprite { private var myTextField1:TextField = new TextField(); private var myTextField2:TextField = new TextField(); public function TextField_replaceSelectedTextExample() { myTextField1.x = 10; myTextField1.width = 300; myTextField1.height = 50; myTextField1.background = true; myTextField1.border = true; myTextField1.text = "Select the text you want to remove from the line."; myTextField2.x = 10; myTextField2.y = 60; myTextField2.width = 300; myTextField2.height = 50; myTextField2.background = true; myTextField2.border = true; myTextField2.text = "Select the text you want to replace with NEW TEXT."; myTextField1.addEventListener(MouseEvent.MOUSE_UP, mouseHandler1); myTextField2.addEventListener(MouseEvent.MOUSE_UP, mouseHandler2); this.addChild(myTextField1); this.addChild(myTextField2); } private function mouseHandler1(e:MouseEvent):void { myTextField1.replaceSelectedText(""); } private function mouseHandler2(e:MouseEvent):void { if(myTextField2.selectionBeginIndex != myTextField2.selectionEndIndex) { myTextField2.replaceSelectedText("NEW TEXT"); } } } }
replaceText | () | yöntem |
public function replaceText(beginIndex:int, endIndex:int, newText:String):void
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
parametrelerinin newText
parametresinin içeriğini belirttiği karakter aralığını değiştirir. Tasarlandığı şekilde, beginIndex
ile endIndex-1
arasındaki metin değiştirilir.
Not: Metin alanına bir stil sayfası uygulanırsa bu yöntem çalışmaz.
Parametreler
beginIndex:int — Değiştirme aralığının başlangıcı için sıfır temelli dizin değeri.
| |
endIndex:int — İlk karakterin, istenilen metin kaydırması yapıldıktan sonraki sıfır temelli dizin konumu.
| |
newText:String — Belirtilen karakter aralığını değiştirmek için kullanılan metin.
|
Atar
Error — Bu yöntem bir stil sayfasına sahip bir metin alanında kullanılamaz.
|
Örnek ( Bu örnek nasıl kullanılır? )
replaceText()
yöntemini kullanır.
outputText
metin alanı metne otomatik olarak sığacak ve sola yaslanmış metin olarak yeniden boyutlandırılacak şekilde ayarlanır. İlk replaceText()
yöntem çağrısıyla, ilk satır ("This is the wrong heading"), "THIS IS THE HEADING FOR EVERYONE" metniyle değiştirilir. İkinci yöntem çağrısıyla "THE" ve "HEADING" metinlerinin arasına "CORRECT" metni eklenir. Üçüncü yöntem çağrısıyla "FOR EVERYONE" kelimeleri silinir. appendText()
yöntemine yapılan her çağrıyla geçerli metnin başlangıç ve bitiş dizinlerinin değiştirileceğini unutmayın. Burada, yalnızca son metin (değişiklikler yapıldıktan sonraki) görüntülenecektir.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_replaceTextExample extends Sprite { public function TextField_replaceTextExample() { var outputText:TextField = new TextField(); outputText.x = 10; outputText.y = 10; outputText.background = true; outputText.autoSize = TextFieldAutoSize.LEFT; outputText.appendText("This is the wrong heading"); outputText.appendText("\n\n"); outputText.appendText("This is the body of the text."); outputText.replaceText(0, 25, "THIS IS THE HEADING FOR EVERYONE"); outputText.replaceText(12, 12, "CORRECT "); outputText.replaceText(27, 40, ""); this.addChild(outputText); } } }
setSelection | () | yöntem |
public function setSelection(beginIndex:int, endIndex:int):void
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
parametreleriyle belirlenen ilk ve son karakterin diziniyle saptanan metni seçilmiş olarak ayarlar. caretIndex
özelliğini ayarladığınızda, iki parametre değeri aynıysa bu yöntem ekleme noktasını ayarlar.
Parametreler
beginIndex:int — Seçimdeki ilk karakterin sıfır temelli dizin değeri. (Örneğin, ilk karakter 0, ikinci karakter 1 şeklinde devam eder.)
| |
endIndex:int — Seçimdeki son karakterin sıfır temelli dizin değeri.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
myTextField
metin alanına yönelik iki olay dinleyicisi, kullanıcının fare tıklatmalarına veya fareyi yukarı hareket ettirme olaylarına yanıt verir. Kullanıcı fareyi serbest bıraktığında fare yukarı hareket ettirilir. Bu, bir metin seçimi yapıldıktan sonra normalde meydana gelen bir olaydır. Bir metin alanına yönelik varsayılan ayarın seçilecek metin için olduğunu unutmayın. Metnin bir kısmı tıklatıldığında, clickHandler()
olayı çağrılır. Metnin bir kısmı seçildiğinde ve fare serbest bırakıldığında mouseUpHandler()
yöntemi çağrılır.
clickHandler()
ve mouseUpHandler()
yöntemlerinde, setSelection()
yöntemi yalnızca 54 ile 70 arasındaki dizinlerde (TEXT IN ALL CAPS) bulunan karakterleri seçilecek şekilde ayarlar.
package { import flash.display.Sprite; import flash.events.MouseEvent; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_setSelectionExample extends Sprite { private var myTextField:TextField = new TextField(); public function TextField_setSelectionExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS is selected."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); myTextField.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } private function mouseUpHandler(event:MouseEvent):void { myTextField.setSelection(54, 70); } } }
setTextFormat | () | yöntem |
public function setTextFormat(format:flash.text:TextFormat, beginIndex:int = -1, endIndex:int = -1):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
format
parametresinin belirttiği metin biçimlendirmesini bir metin alanında belirtilen metne uygular. format
değeri istenen metin biçimlendirme değişikliklerini belirten bir TextFormat nesnesi olmalıdır. Yalnızca format
parametresinin null olmayan özellikleri metin alanına uygulanır. null
olarak ayarlanmış herhangi bir format
özelliği uygulanmaz. Varsayılan olarak yeni oluşturulmuş bir TextFormat nesnesinin tüm özellikleri null
olarak ayarlanır.
Not: Metin alanına bir stil sayfası uygulanırsa bu yöntem çalışmaz.
setTextFormat()
yöntemi karakter aralığına veya bir metin alanındaki gövdenin tümüne uygulanan metin biçimlendirmesini değiştirir. Biçimin özelliklerini metin alanındaki tüm metne uygulamak için beginIndex
ve endIndex
parametreleri için değer belirtmeyin. Biçimin özelliklerini bir metin aralığına uygulamak için beginIndex
ve endIndex
parametreleri için değerler belirtin. Dizin değerlerini belirlemek için length
özelliğini kullanabilirsiniz.
Bir TextFormat nesnesindeki iki biçimlendirme bilgisi türü karakter düzeyinde biçimlendirme ve paragraf düzeyinde biçimlendirmedir. Metin alanındaki her karakter, font adı, kalın ve italik gibi kendi biçimlendirme ayarlarına sahip olabilir.
Paragraflarda, paragrafın ilk karakteri tüm paragrafa yönelik paragraf biçimlendirme ayarları açısından incelenir. Paragraf biçimlendirme ayarlarının örnekleri sol kenar boşluğu, sağ kenar boşluğu ve girinti şeklindedir.
Kullanıcı tarafından elle eklenen veya replaceSelectedText()
yöntemiyle değiştirilen herhangi bir metnin yeni metin için metin alanının varsayılan biçimlendirmesini aldığını, metin ekleme noktası için belirtilen biçimlendirmeyi almadığını unutmayın. Yeni metin için varsayılan biçimlendirmeyi ayarlamak için defaultTextFormat
özelliğini kullanın.
Parametreler
format:flash.text:TextFormat — Karakter ve biçimlendirme bilgilerini içeren bir TextFormat nesnesi.
| |||||||||
beginIndex:int (default = -1 ) — İsteğe bağlı; istenilen metin aralığındaki ilk karakteri belirleyen sıfır temelli dizin konumunu belirten bir tam sayı.
| |||||||||
endIndex:int (default = -1 ) — İsteğe bağlı; istenen metin yayılmasından sonraki ilk karakteri belirten bir tam sayı. Tasarlandığı gibi beginIndex ve endIndex değerlerini belirtirseniz, beginIndex ile endIndex-1 arasındaki metin güncellenir.
Kullanıcı tarafından elle eklenen veya |
Atar
Error — Bu yöntem bir stil sayfasına sahip bir metin alanında kullanılamaz.
| |
RangeError — Belirtilen beginIndex veya endIndex aralık dışındadır.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
myTextField
metin alanına yönelik bir olay dinleyicisi clickHandler()
yöntemini çağırarak fare tıklatmalarına yanıt vermek için eklenir. clickHandler()
yönteminde, getTextFormat()
yöntemi metnin amaçlanan aralığından geçerli karakter biçimini (dizin 55) döndürür. Bu daha sonra currentTextFormat
TextFormat nesnesine yerleştirilir. if
ifadesi aralıktaki karakterin yeni biçimi kullanıp kullanmadığını görmek için currentTextFormat
metin biçimini kontrol eder (font noktası 18'e ayarlanır). Aksi halde yeni biçim, boyutu 18, rengi kırmızı yapar ve 54-70 arasındaki metin aralığına (TEXT IN ALL CAPS) alt çizgi ve italik görüntü ekler. Aralıktaki karakter yeni biçimi kullanıyorsa, aralığın biçimi metin alanının varsayılan (orijinal) biçimine geri döndürülür.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFormat; import flash.text.TextFieldAutoSize; import flash.events.MouseEvent; public class TextField_setTextFormatExample extends Sprite { private var myTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_setTextFormatExample() { myTextField.autoSize = TextFieldAutoSize.LEFT; myTextField.selectable = false; myTextField.background = true; myTextField.text = "No matter where you click on this text field only the TEXT IN ALL CAPS changes format."; myTextField.addEventListener(MouseEvent.CLICK, clickHandler); newFormat.color = 0xFF0000; newFormat.size = 18; newFormat.underline = true; newFormat.italic = true; this.addChild(myTextField); } private function clickHandler(event:MouseEvent):void { var currentTextFormat:TextFormat = myTextField.getTextFormat(55); if(currentTextFormat.size != 18) { myTextField.setTextFormat(newFormat, 54, 70); } else { myTextField.setTextFormat(myTextField.defaultTextFormat); } } } }
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 1.0, Flash Player 9, Flash Lite 4 |
Bir denetim değeri değiştirilmeden önce gönderilen textInput
olayının aksine, değer değiştirildikten sonra gönderilir. Olayı yalnızca kontrol odağı kaybettikten sonra gönderen change
olayının W3C DOM Olay Modeli sürümünün aksine change
olayının ActionScript 3.0 sürümü kontrol her değiştiğinde gönderilir. Örneğin, kullanıcı bir metin alanına metin yazarsa, her tuş vuruşundan sonra bir change
olayı gönderilir.
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. |
Örnek ( Bu örnek nasıl kullanılır? )
Biri kullanıcı girdisi ve diğeri (headingTextField
) kullanıcı girdisinin kopyalanması için olmak üzere iki metin alanı oluşturulur. Ayrıca bir TextFormat nesnesi oluşturulur ve varsayılan metin biçimi headingTextField
metin alanına atanır. Metin alanının içeriği değiştiğinde, changeHandler()
yöntemi çağrılır ve inputTextField
metin alanındaki metni headingTextField
metin alanına atar. (Yöntem Event.CHANGE
olayı yerine TextEvent.TEXT_INPUT
olayı için çağrılmışsa, kullanıcı girdisinin içeriği yalnızca kullanıcı daha fazla metin girdikten sonra kopyalanır.)
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldType; import flash.text.TextFormat; import flash.text.TextFormatAlign; import flash.events.Event; import flash.events.TextEvent; public class TextField_Event_changeExample extends Sprite { private var inputTextField:TextField = new TextField(); private var headingTextField:TextField = new TextField(); private var newFormat:TextFormat = new TextFormat(); public function TextField_Event_changeExample() { headingTextField.x = 10; headingTextField.y = 10; headingTextField.height = 30; headingTextField.width = 400; headingTextField.background = true; headingTextField.backgroundColor = 0xF5F5DC; headingTextField.selectable = false; inputTextField.x = 10; inputTextField.y = 70; inputTextField.height = 20; inputTextField.width = 230; inputTextField.background = true; inputTextField.border = true; inputTextField.maxChars = 40; inputTextField.wordWrap = true; inputTextField.type = TextFieldType.INPUT; inputTextField.addEventListener(Event.CHANGE, changeHandler); newFormat.bold = true; newFormat.size = 18; newFormat.color = 0xFF0000; newFormat.align = TextFormatAlign.CENTER; headingTextField.defaultTextFormat = newFormat; this.addChild(inputTextField); this.addChild(headingTextField); } private function changeHandler(e:Event):void { headingTextField.text = inputTextField.text; } } }
link | Olay |
flash.events.TextEvent
özellik TextEvent.type =
flash.events.TextEvent.LINK
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kullanıcı, URL'nin "event:" ile başladığı, HTML özelliği etkinleştirilmiş bir metin alanındaki bir köprüyü tıklattığında gönderilir. URL'nin "event:" öğesinden sonra gelen geri kalan kısmı LINK olayının text özelliğine yerleştirilecektir.
Not: Varsayılan davranış olan metni metin alanına ekleme yalnızca Flash Player olayı oluşturduğunda meydana gelir. Bu durumda bu olay, bir kullanıcı metin girmeyi denediğinde meydana gelir. Kendisine textInput
olayları göndererek bir metin alanına metin yerleştiremezsiniz.
link
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 | Tıklatılan köprüyü içeren metin alanı. 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. |
text | URL'nin "event:" sonrasında kalan kısmı. |
Örnek ( Bu örnek nasıl kullanılır? )
playMP3()
işlevi tanımlanır. list
adlı bir TextField nesnesi oluşturulur ve HTML metniyle doldurulur. "Track 1"
ve "Track 2"
metni, metin alanının içindeki bağlardır. Kullanıcı bu bağlardan birini tıklattığında playMP3() işlevi çağrılır. HTML etiketinin href
niteliğindeki "event:" dizesini izleyen MP3 dosyası adı, link
olayı nesnesinin text
özelliği şeklinde linkHandler()
yöntemine iletilir.
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.IOErrorEvent; import flash.events.TextEvent; import flash.media.Sound; import flash.media.SoundChannel; import flash.net.URLRequest; import flash.text.TextField; import flash.text.TextFieldAutoSize; public class TextField_event_link extends Sprite { private var myMP3:Sound; public function TextField_event_link() { myMP3 = new Sound(); var list:TextField = new TextField(); list.autoSize = TextFieldAutoSize.LEFT; list.multiline = true; list.htmlText = "<a href=\"event:track1.mp3\">Track 1</a><br>"; list.htmlText += "<a href=\"event:track2.mp3\">Track 2</a><br>"; addEventListener(TextEvent.LINK, linkHandler); addChild(list); } private function playMP3(mp3:String):void { try { myMP3.load(new URLRequest(mp3)); myMP3.play(); } catch(err:Error) { trace(err.message); } myMP3.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); } private function linkHandler(linkEvent:TextEvent):void { playMP3(linkEvent.text); } private function errorHandler(errorEvent:IOErrorEvent):void { trace(errorEvent.text); } } }
scroll | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.SCROLL
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kullanıcı kaydırma yaptıktan sonra bir TextField nesnesi tarafından gönderilir.
Event.SCROLL
sabiti, scroll
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 | Kaydırılan TextField nesnesi. target özelliği 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. |
Örnek ( Bu örnek nasıl kullanılır? )
mouseDown
olayı gönderilir ve ilişkili mouseDownScroll
işleyicisi çağrılır. mouseDownScroll()
işleyicisi alanın kaydırılmasını sağlar. Ardından scroll
olayı gönderilir ve ilişkili scrollHandler()
işleyicisi geçerli kaydırma konumu görüntülemek için ikinci metin alanını günceller.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextScrollExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); private var myText:String = "Hello world and welcome to the show. It's really nice to meet you. Take your coat off and stay a while. OK, show is over. Hope you had fun. You can go home now. Don't forget to tip your waiter. There are mints in the bowl by the door. Thank you. Please come again."; public function TextScrollExample() { myTextBox1.text = myText; myTextBox1.width = 200; myTextBox1.height = 50; myTextBox1.multiline = true; myTextBox1.wordWrap = true; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownScroll); myTextBox1.addEventListener(Event.SCROLL, scrollHandler); } public function mouseDownScroll(event:MouseEvent):void { myTextBox1.scrollV++; } public function scrollHandler(event:Event):void { myTextBox2.text="scrolled to line: " + myTextBox1.scrollV; } } }
textInput | Olay |
flash.events.TextEvent
özellik TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kullanıcı bir veya birden çok metin karakteri girdiğinde Flash Player, textInput
olayını gönderir. Standart klavyeleri, girdi yöntemi düzenleyicilerini (IME'ler), ses veya konuşma tanıma sistemlerini ve hatta biçimlendirme veya stil bilgisine sahip olmayan düz metni yapıştırma eylemini içeren çeşitli farklı metin girdisi yöntemleri bu olayı oluşturabilir.
textInput
olay nesnesinin type
özelliğinin değerini tanımlar.
Not: Delete veya Backspace tuşları için bu olay gönderilmez.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | true |
cancelable | true ; varsayılan davranışı iptal etmek için preventDefault() yöntemini çağırır. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Karakterlerin girildiği metin alanı. Hedef 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. |
text | Kullanıcı tarafından girilen karakter veya karakter dizisi. |
Örnek ( Bu örnek nasıl kullanılır? )
textInput
olayı gönderilir, textInputHandler()
işleyicisi çağrılır ve karakterler ikinci metin alanında görüntülenir. Girdi alanına bir metin bloğu yapıştırdığınızda olay işleyicisi, bloğun tamamını başka bir alana yapıştırır.
package { import flash.display.Sprite; import flash.text.*; import flash.events.Event; import flash.events.TextEvent; import flash.events.MouseEvent; public class TextInputExample extends Sprite { private var myTextBox1:TextField = new TextField(); private var myTextBox2:TextField = new TextField(); public function TextInputExample() { myTextBox1.type = TextFieldType.INPUT; myTextBox1.width = 200; myTextBox1.height = 20; myTextBox1.background = true; myTextBox1.border = true; myTextBox2.x=220; addChild(myTextBox1); addChild(myTextBox2); myTextBox1.addEventListener(TextEvent.TEXT_INPUT,textInputHandler); } public function textInputHandler(event:TextEvent):void { myTextBox2.text=event.text; } } }
textInteractionModeChange | Olay |
flash.events.Event
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 11, Flash Lite 4 |
Kullanıcı bir metin alanının etkileşim modunu değiştirdiğinde, Flash Player textInteractionModeChange
olayını gönderir. Örneğin, Android'de bağlam menüsü seçenekleri kullanılarak NORMAL modundan SELECTION moduna geçiş yapılabilir
TextFieldExample
sınıfını kullanır. Bu işlem şu adımlar kullanılarak gerçekleştirilir:
- TextField türünde bir
label
özelliği oluşturulur. - Sınıf yapıcısı
configureLabel()
işlevini çağırır. -
configureLabel()
yöntemi ilk olarak yeni bir TextField nesnesi oluşturur ve bunulabel
özelliğine atar ve ardından bu nesnenin parametrelerini şu şekilde ayarlar:- Metin alanını sola yaslayarak.
- Arka plan dolgusunu etkinleştirerek.
- Kenarlığı etkinleştirerek.
configureLabel()
yöntemiformat
değişkenini oluşturur ve bunu parametreleri şu şekilde ayarlı olacak biçimde yeni bir TextFormat örneğine atar:- Font type = Verdana
- Font color = solid red
- Font size = 10
- Font underline = true
label
metin alanınındefaultTextFormat
özelliğiformat
olarak ayarlanır velabel
örneği görüntüleme listesine eklenir ve böylece sahne alanı üzerinde metin olmayacak şekilde ilk olarak bir metin alanını görüntülenir.- Yapıcı,
label
metin alanının metninisetLabel()
yöntemini çağırarak"Hello world and welcome to the show."
olarak ayarlar.
package { import flash.display.Sprite; import flash.text.TextField; import flash.text.TextFieldAutoSize; import flash.text.TextFormat; public class TextFieldExample extends Sprite { private var label:TextField; private var labelText:String = "Hello world and welcome to the show."; public function TextFieldExample() { configureLabel(); setLabel(labelText); } public function setLabel(str:String):void { label.text = str; } private function configureLabel():void { label = new TextField(); label.autoSize = TextFieldAutoSize.LEFT; label.background = true; label.border = true; var format:TextFormat = new TextFormat(); format.font = "Verdana"; format.color = 0xFF0000; format.size = 10; format.underline = true; label.defaultTextFormat = format; addChild(label); } } }
Tue Jun 12 2018, 01:09 PM Z