HTMLLoader nesnelerinin görüntü özellikleri

Adobe AIR 1.0 ve üstü

HTMLLoader nesnesi, Adobe® Flash® Player Sprite sınıfının görüntü özelliklerini miras alır. Örneğin arka plan rengini değiştirebilir, yeniden boyutlandırabilir, taşıyabilir ve gizleyebilirsiniz. Veya filtreler, maskeler, ölçeklendirme ve döndürme gibi gelişmiş efektler uygulayabilirsiniz. Efektleri uygularken, okunaklılık üzerindeki etkilerini göz önüne alın. HTML sayfasına yüklenen SWF ve PDF içeriği, bazı efektler uygulandığında görüntülenemez.

HTML pencereleri, HTML içeriğini oluşturan bir HTMLLoader nesnesi içerir. Bu nesne pencere alanı içinde sınırlanmıştır, bu nedenle boyut, konum, döndürme veya ölçek faktörünün değiştirilmesi her zaman istenen sonuçları vermez.

Temel görüntü özellikleri

HTMLLoader nesnesinin temel görüntü özellikleri, boyutu ayarlamak ve denetimi göstermek veya gizlemek için üst display nesnesi içinde denetimi konumlandırmanıza olanak verir. HTML penceresinin HTMLLoader nesnesi için bu özellikleri değiştirmemelisiniz.

Temel özellikler:

Özellik

Notlar

x , y

Nesneyi üst kabı içinde.

width , height

Görüntü alanının boyutlarını değiştirir.

visible

Nesnenin ve sahip olduğu tüm içeriğin görünürlüğünü denetler.

HTML penceresi dışında, HTMLLoader nesnesinin width ve height özellikleri varsayılan olarak 0'dır. Yüklenen HTML içeriği görünür olmadan önce genişlik ve yüksekliği ayarlamalısınız. HTML içeriği HTMLLoader boyutuna çizilir, içerikteki HTML ve CSS özelliklerine göre şekillendirilir. HTMLLoader boyutunun değiştirilmesi içeriği yeniden akıtır.

Yeni bir HTMLLoader nesnesine (halen 0 olarak ayarlanmış width içeren) içerik yüklerken HTMLLoader görüntü width ve height özelliklerini contentWidth ve contentHeight özelliklerini kullanarak ayarlamak size uygun gelebilir. Bu teknik, HTML ve CSS akış kurallarına göre şekillendirildiğinde belirli bir minimum genişliğe sahip olan sayfalar için çalışır. Ancak, bazı sayfalar HTMLLoader tarafından sağlanan belirli bir genişlik olmadığında uzun ve dar bir mizanpajın içine akar.

Not: HTMLLoader nesnesinin genişliğini ve yüksekliğini değiştirdiğinizde, scaleX ve scaleY değerleri diğer birçok display nesnesindekinin aksine değişmez.

HTMLLoader içeriğinin şeffaflığı

HTMLLoader nesnesinin varsayılan olarak true olan paintsDefaultBackground özelliği HTMLLoader nesnesinin opak bir arka plan çizip çizmeyeceğini belirler. paintsDefaultBackground öğesi false olduğunda, arka plan boştur. Display nesnesi kabı veya HTMLLoader nesnesinin altındaki diğer display nesneleri, HTML içeriğinin ön plan öğelerinin arkasında görünür.

HTML belgesinin gövde öğesi veya diğer öğelerinden biri bir arka plan rengi belirlediğinde (örneğin, style="background-color:gray" ), HTML'in bu bölümünün arka plan rengi opaktır ve belirlenen arka plan rengiyle oluşturulur. HTMLLoader nesnesinin opaqueBackground özelliğini ayarladığınızda ve paintsDefaultBackground öğesi false olduğunda, opaqueBackground renk kümesi görünür.

Not: HTML belgesindeki öğe için alfa karışımlı bir arka plan sağlamak için şeffaf, PNG biçiminde bir grafik kullanabilirsiniz. HTML öğesinin opaklık stilini ayarlama desteklenmez.

HTMLLoader içeriğini ölçekleme

HTMLLoader nesnesini 1.0 dışında bir ölçek faktörüyle ölçeklemekten kaçının. HTMLLoader içeriğindeki metin belirli bir çözünürlükte oluşturulur ve HTMLLoader nesnesi ölçeklendiğinde pikseller halinde görünebilir. Pencere yeniden boyutlandırıldığında HTMLLoader nesnesi ve içeriğinin ölçeklenmesini engellemek için Sahne'nin scaleMode özelliğini StageScaleMode.NO_SCALE olarak ayarlayın.

HTML sayfasına SWF ve PDF içeriği yüklenirken dikkate alınması gerekenler

HTMLLoader nesnesine yüklenen SWF ve PDF içeriği aşağıdaki koşullarda kaybolur:

  • HTMLLoader nesnesini 1.0 dışında bir faktöre ölçeklerseniz.

  • HTMLLoader nesnesinin alfa özelliğini 1.0 dışında bir değere ayarlarsanız.

  • HTMLLoader içeriğini döndürürseniz.

Sorunlu özellik ayarını ve etkin filtreleri kaldırdığınızda içerik yeniden görünüz.

Ayrıca çalışma zamanı, saydam pencerelerde PDF içeriğini görüntüleyemez. Çalışma zamanı, HTML sayfasına gömülü SWF içeriğini yalnızca nesnenin veya gömme etiketinin wmode parametresi opaque veya transparent olarak ayarlandığında görüntüler. wmode öğesinin varsayılan değeri window olduğundan, wmode parametresini özellikle ayarlamadığınız sürece SWF içeriği saydam pencerelerde görüntülenmez.

Not: AIR 1.5.2'den önce, HTML'de gömülü SWF hangi wmode değeri kullanılırsa kullanılsın görüntülenemiyordu.

HTMLLoader nesnesinde bu tür medyaların yüklenmesi hakkında daha fazla bilgi için bkz. SWF içeriğini HTML'e gömme ve AIR'ye PDF içeriği ekleme .

Gelişmiş görüntü özellikleri

HTMLLoader sınıfı, özel efektler için kullanılabilecek birçok yöntemi miras alır. Bu efektler HTMLLoader görüntüsüyle kullanıldıklarında genellikle sınırlamalar içerir, ancak geçişler veya diğer geçici efektler için kullanışlı olabilir. Örneğin, kullanıcı girdisi toplamak için bir iletişim penceresi görüntülediğinizde, kullanıcı iletişim kutusunu kapatana kadar ana pencere görüntüsünü bulanıklaştırabilirsiniz. Benzer şekilde, bir pencereyi kapatırken görüntünün yavaşça kapanmasını sağlayabilirsiniz.

Gelişmiş görüntü özellikleri şunları içerir:

Özellik

Sınırlamalar

alpha

HTML içeriğinin okunaklılığını azaltabilir

filters

HTML penceresinde, dış efektler pencere kenarı tarafından kesilir.

graphics

Varsayılan arka plan dahil grafik komutlarıyla çizilen şekiller HTML içeriğinin altında görünür. Çizilen şekillerin görünür olması için paintsDefaultBackground özelliği false olmalıdır.

opaqueBackground

Varsayılan arka planın rengini değiştirmez. Bu renk katmanının görünür olması için paintsDefaultBackground özelliği false olmalıdır.

rotation

Dikdörtgen HTMLLoader alanının köşeleri pencere kenarı tarafından kesilebilir. HTML içeriğine yüklenen SWF ve PDF içeriği görüntülenmez.

scaleX , scaleY

Oluşturulan görüntü, 1'den büyük ölçek faktörlerinde pikseller halinde görünebilir. HTML içeriğine yüklenen SWF ve PDF içeriği görüntülenmez.

transform

HTML içeriğinin okunaklılığını azaltabilir. HTML görüntüsü pencere kenarı tarafından kesilebilir. Dönüştürme döndürme, ölçekleme veya eğme içeriyorsa, HTML içeriğine yüklenen SWF ve PDF içeriği görüntülenmez.

Aşağıdaki örnek, tüm HTML görüntüsünü bulanıklaştırmak için filters dizisinin nasıl ayarlanacağını gösterir:

var html:HTMLLoader = new HTMLLoader(); 
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/"); 
html.load(urlReq); 
html.width = 800; 
html.height = 600; 
 
var blur:BlurFilter = new BlurFilter(8); 
var filters:Array = [blur]; 
html.filters = filters;