Paket | flash.text.engine |
Sınıf | public final class GroupElement |
Miras Alma | GroupElement ContentElement Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
content
özelliğine bir birim olarak atayabileceğiniz TextElement, GraphicElement veya diğer GroupElement nesnelerini bir arada gruplar. GroupElement nesnesi aynı zamanda başka bir GroupElement nesnesi içindeki yaygın özellikleri de paylaşır.
GroupElement başka bir GroupElement içerdiğinde, iç GroupElement öğesi kendi biçimini korur (ElementFormat ayarları). Dış GroupElement öğesinin biçimini miras almaz.
Bir GroupElement öğesinde, biçim özelliklerinin çoğunun etkisi yoktur. Bu nedenle, GroupElement nesnesi için null elementFormat
parametresine sahip bir metin satırı oluşturulması geçerli bir durumdur. kerning
ve ligature
gibi birkaç biçim özelliği, grup üyeleri arasında kesişimlerin oluştuğu yerlerdeki biçimi etkiler. Grubun biçimi null ise, önceki öğenin biçimi, grup üyeleri arasında kesişimlerin oluşacağı yerlerdeki biçimi belirler.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
elementCount : int [salt okunur]
Gruptaki öğelerin sayısı. | GroupElement | ||
elementFormat : ElementFormat
Öğe için kullanılan ElementFormat nesnesi. | ContentElement | ||
eventMirror : EventDispatcher
Bu içerik öğesi esas alınarak geçerli metin satırlarına gönderilen her olayın kopyalarını alan EventDispatcher nesnesi. | ContentElement | ||
groupElement : GroupElement [salt okunur]
Bu öğeyi içeren GroupElement nesnesi veya grupta yer almıyorsa null değeri. | ContentElement | ||
rawText : String [salt okunur]
U+FDEF karakterleri de dahil olmak üzere, öğedeki metnin bir kopyası. | ContentElement | ||
text : String [salt okunur]
U+FDEF öğeleri hariç olmak üzere, öğedeki metnin bir kopyası; bu String öğesi içindeki grafik öğelerini temsil eder. | ContentElement | ||
textBlock : flash.text.engine:TextBlock [salt okunur]
Bu öğenin ait olduğu TextBlock. | ContentElement | ||
textBlockBeginIndex : int [salt okunur]
Bu öğenin birinci karakterinin metin bloğundaki dizin. | ContentElement | ||
textRotation : String
Bir birim olarak öğeye uygulanacak döndürme değeri. | ContentElement | ||
userData : *
Uygulamaya, rastgele verileri öğeyle ilişkilendirme yolu sağlar. | ContentElement |
Yöntem | Tanımlayan: | ||
---|---|---|---|
GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Yeni bir GroupElement örneği oluşturur. | GroupElement | ||
Grup içerisinden bir öğe alır. | GroupElement | ||
charIndex parametresi tarafından belirtilen karakteri içeren öğeyi döndürür. | GroupElement | ||
element parametresi tarafından belirtilen öğenin dizinini döndürür. | GroupElement | ||
beginIndex ve endIndex parametrelerinin belirttiği öğeler aralığını, bu öğeleri içeren yeni bir GroupElement ile değiştirir. | GroupElement | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
beginIndex ve endIndex parametrelerinin belirttiği öğeler aralığındaki metni, beginIndex tarafından belirtilen öğeyle, o öğenin biçimini etkilemeden birleştirir. | GroupElement | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
beginIndex ve endIndex parametrelerinin newElements parametresinin içeriğini belirttiği öğe aralığını değiştirir. | GroupElement | ||
Gruptaki öğeleri Vector içeriğine ayarlar. | GroupElement | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bir TextElement öğesini ikiye bölerek belirtilen konumda yeni bir TextElement oluşturur. | GroupElement | ||
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 | ||
Dış bir GroupElement nesnesi içinde, groupIndex öğesinin belirttiği yuvalanmış GroupElement öğesindeki nesnelerin grubunu çözer. | GroupElement | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
elementCount | özellik |
GroupElement | () | Yapıcı |
public function GroupElement(elements:Vector.<ContentElement> = null, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Yeni bir GroupElement örneği oluşturur.
Parametrelerelements:Vector.<ContentElement> (default = null ) — GroupElement öğesine dahil edilecek ContentElement nesnelerinden oluşan bir Vector öğesi. Vector boş olabilir. Varsayılan değer null şeklindedir.
| |
elementFormat:ElementFormat (default = null ) — Gruba yönelik öğe biçimi. Varsayılan değer null şeklindedir. Bu biçim, gruptaki öğeler arasında bulunan kesişmeler için geçerlidir; bu öğeler biçimi miras almaz.
| |
eventMirror:EventDispatcher (default = null ) — Bu içerik öğesi esas alınarak oluşturulan metin satırlarına gönderilen her olayın kopyalarını alan EventDispatcher nesnesi. Varsayılan değer null şeklindedir.
| |
textRotation:String (default = "rotate0 ") — Öğeye bir birim olarak döndürme değeri uygulanır. Bu özellik için TextRotation sabitlerini kullanın. Varsayılan değer TextRotation.ROTATE_0 olur.
|
Atar
ArgumentError — Belirtilen element , null öğelerini içerir.
| |
ArgumentError — Belirtilen element , ContentElement öğesinin bilinen bir alt sınıfı olmayan öğeyi içerir.
| |
ArgumentError — Belirtilen element , TextBlock öğesinin content öğesi olarak belirtilen öğeleri içerir.
| |
ArgumentError — Belirtilen element , zaten bir grubun üyesi olan veya elements içinde birden çok defa görüntülenen öğeleri içerir.
|
İlgili API Öğeleri
getElementAt | () | yöntem |
public function getElementAt(index:int):ContentElement
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Grup içerisinden bir öğe alır.
Parametreler
index:int — Alınacak öğenin dizini.
|
ContentElement |
Atar
RangeError — index aralık dışındaysa.
|
getElementAtCharIndex | () | yöntem |
public function getElementAtCharIndex(charIndex:int):ContentElement
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
charIndex
parametresi tarafından belirtilen karakteri içeren öğeyi döndürür.
Parametreler
charIndex:int — Öğesini bulmak istediğiniz karakter için sıfır temelli dizin değeri. 0 değeri TextBlock öğesindeki ilk karaktere değil, gruptaki ilk karaktere karşılık gelir.
|
ContentElement — charIndex öğesindeki karakteri içeren öğe.
|
Atar
RangeError — charIndex öğesi, 0 - rawText.length öğesinin aralığında değilse.
|
getElementIndex | () | yöntem |
public function getElementIndex(element:ContentElement):int
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
element
parametresi tarafından belirtilen öğenin dizinini döndürür.
Parametreler
element:ContentElement — Dizinini almak istediğiniz gruptaki öğe.
|
int — element tarafından belirtilen öğenin dizini veya öğe grupta değilse -1.
|
groupElements | () | yöntem |
public function groupElements(beginIndex:int, endIndex:int):GroupElement
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
ve endIndex
parametrelerinin belirttiği öğeler aralığını, bu öğeleri içeren yeni bir GroupElement
ile değiştirir. Tasarlandığı gibi, beginIndex ile endIndex-1 arasında öğeler değiştirilir.
Parametreler
beginIndex:int — Gruplanacak aralığın başlangıç konumuna yönelik sıfır temelli dizin değeri.
| |
endIndex:int — Gruplanacak aralığın bitiş konumunu izleyen sıfır temelli dizin değeri.
|
GroupElement — Yeni grup.
|
Atar
RangeError — Belirtilen beginIndex veya endIndex aralık dışındaysa.
|
mergeTextElements | () | yöntem |
public function mergeTextElements(beginIndex:int, endIndex:int):flash.text.engine:TextElement
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
ve endIndex
parametrelerinin belirttiği öğeler aralığındaki metni, beginIndex
tarafından belirtilen öğeyle, o öğenin biçimini etkilemeden birleştirir. Tasarlandığı gibi, beginIndex ile endIndex-1 arasındaki öğelerin metinleri birleştirilir. Metinleri birleştirildikten sonra, null
group
özellikleriyle beginIndex+1 ile endIndex-1 arasındaki öğeler gruptan kaldırılır ve artıklı hale getirilir.
Parametreler
beginIndex:int — Birleştirilecek aralığın başlangıç konumuna yönelik sıfır temelli dizin değeri.
| |
endIndex:int — Birleştirilecek aralığın bitiş konumunu izleyen sıfır temelli dizin değeri.
|
flash.text.engine:TextElement — Artık aralıktaki metnin tümünü içeren, aralıktaki ilk metin öğesi.
|
Atar
RangeError — Belirtilen beginIndex veya endIndex aralık dışındaysa.
| |
ArgumentError — Belirtilen aralıktaki öğelerden herhangi biri TextElement değilse.
|
İlgili API Öğeleri
replaceElements | () | yöntem |
public function replaceElements(beginIndex:int, endIndex:int, newElements:Vector.<ContentElement>):Vector.<ContentElement>
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
beginIndex
ve endIndex
parametrelerinin newElements
parametresinin içeriğini belirttiği öğe aralığını değiştirir. beginIndex ile endIndex-1 arasındaki öğeler değiştirilir.
Öğeleri silmek üzere newElements
için null
değerini iletin. Bir öğe eklemek için, beginIndex
ve endIndex
için aynı değeri iletin. Yeni öğe, belirtilen dizinden önce eklenir. Bir öğe eklemek üzere beginIndex
ve endIndex
öğesi için elementCount
öğesini iletin.
İşlemden sonra, değiştirilen öğeler null
group
özellikleri ile artık haline getirilir ve döndürülür.
Parametreler
beginIndex:int — Değiştirme aralığının başlangıcı için sıfır temelli dizin değeri.
| |
endIndex:int — Değiştirme aralığının bitişini izleyen sıfır temelli dizin değeri.
| |
newElements:Vector.<ContentElement> — Belirtilen öğe aralığını değiştirmek için kullanılan öğeler.
|
Vector.<ContentElement> — Değiştirilmiş öğeleri içeren bir Vector.
|
Atar
RangeError — Belirtilen beginIndex veya endIndex aralık dışındadır.
| |
ArgumentError — Belirtilen newElements null öğeler içerir.
| |
ArgumentError — Belirtilen newElements bunu içerir.
| |
ArgumentError — Belirtilen newElements , ContentElement öğesinin bilinen bir alt sınıfı olmayan öğeleri içerir.
| |
ArgumentError — Belirtilen newElements , TextBlock öğesinin content öğesi olarak belirtilen öğeleri içerir.
| |
ArgumentError — Belirtilen newElements , zaten bir grubun üyesi olan veya elements içinde birden çok defa görüntülenen öğeleri içerir.
| |
ArgumentError — İşlem GroupElement öğesi içerisinde yuvalanmış döndürmelerle sonuçlanırsa.
|
setElements | () | yöntem |
public function setElements(value:Vector.<ContentElement>):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Gruptaki öğeleri Vector içeriğine ayarlar.
Parametreler
value:Vector.<ContentElement> |
Atar
ArgumentError — Belirtilen değer null öğeler içerir.
| |
ArgumentError — Belirtilen değer bunu içerir.
| |
ArgumentError — Belirtilen value , ContentElement öğesinin bilinen bir alt sınıfı olmayan öğeleri içerir.
| |
ArgumentError — Belirtilen value , TextBlock öğesinin content öğesi olarak belirtilen öğeleri içerir.
| |
ArgumentError — Belirtilen value , zaten bir grubun üyesi olan veya value içinde birden çok defa görüntülenen öğeleri içerir.
| |
ArgumentError — İşlem GroupElement öğesi içerisinde yuvalanmış döndürmelerle sonuçlanırsa.
|
splitTextElement | () | yöntem |
public function splitTextElement(elementIndex:int, splitIndex:int):flash.text.engine:TextElement
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Bir TextElement öğesini ikiye bölerek belirtilen konumda yeni bir TextElement oluşturur.
Parametreler
elementIndex:int — Gruptaki öğenin konumuna yönelik sıfır temelli dizin değeri.
| |
splitIndex:int — Ayırma işleminin gerçekleşeceği TextElement öğesindeki karaktere yönelik sıfır temelli dizin değeri. Belirtilen karakter, yeni TextElement öğesindeki ilk karakter olacaktır.
|
flash.text.engine:TextElement — Orijinal metin öğesinin son bölümünü içeren yeni metin öğesi.
|
Atar
RangeError — elementIndex veya charIndex öğesi aralık dışındaysa.
| |
ArgumentError — elementIndex öğesindeki öğe bir TextElement değilse.
|
İlgili API Öğeleri
ungroupElements | () | yöntem |
public function ungroupElements(groupIndex:int):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Dış bir GroupElement nesnesi içinde, groupIndex
öğesinin belirttiği yuvalanmış GroupElement öğesindeki nesnelerin grubunu çözer. İşlemden sonra, grubu çözülen öğeler, artık olan yuvalanmış GroupElement öğesini bir null
group
özelliğiyle değiştirir.
Parametreler
groupIndex:int — Ayrılacak grubun konumuna yönelik sıfır temelli dizin değeri.
|
Atar
RangeError — groupIndex aralık dışındaysa.
| |
ArgumentError — groupIndex öğesindeki öğe bir GroupElement değilse.
|
content
özelliğine atar, buradan üç satır oluşturur.
package { import flash.display.Sprite; import flash.display.MovieClip; import flash.text.engine.ContentElement; import flash.text.engine.TextBlock; import flash.text.engine.TextElement; import flash.text.engine.GraphicElement; import flash.text.engine.GroupElement; import flash.text.engine.TextLine; import flash.text.engine.ElementFormat; import flash.text.engine.FontDescription; public class GroupElementExample extends Sprite { public function GroupElementExample():void { var redBox:MovieClip = new MovieClip(); redBox.graphics.beginFill(0xCC0000, 1.0); redBox.graphics.drawRect(0, 0, 20, 20); redBox.graphics.endFill(); var format:ElementFormat = new ElementFormat(); var fontDescription:FontDescription = new FontDescription("Arial"); format.fontSize = 16; format.fontDescription = fontDescription; var str1:String = "This red box is a GraphicElement "; var str2:String = " in the middle of two TextElements, " + " which together make " + "up a GroupElement in a TextBlock that is broken into three lines."; var textElement1:TextElement = new TextElement(str1,format); var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format); var textElement2:TextElement = new TextElement(str2, format); var groupVector:Vector.<ContentElement> = new Vector.<ContentElement>(); groupVector.push(textElement1, graphicElement, textElement2); var groupElement = new GroupElement(groupVector); var textBlock:TextBlock = new TextBlock(); textBlock.content = groupElement; createTextLines(textBlock); } private function createTextLines(textBlock:TextBlock):void { var yPos = 20; var line_length:Number = 450; var textLine:TextLine = textBlock.createTextLine (null, line_length); while (textLine) { addChild(textLine); textLine.x = 15; yPos += textLine.height+8; textLine.y = yPos; textLine = textBlock.createTextLine(textLine, line_length); } } } }
Tue Jun 12 2018, 01:09 PM Z