IIMEClient - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.text.ime
Arabirim	public interface IIMEClient

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

IME (giriş yöntemi düzenleyicisi) istemcileri için arabirim. flash.text.engine paketini temel alan bileşenler bir IME kullanarak düzenleme metni satır içini desteklemek için bu arabirimini uygulamalıdır. Arabirim TextField nesneleriyle kullanılmaz. TextLayoutFramework (TLF), bu arabirimi satır içi IME'yi desteklemek için kullanır, böylece TLF kullanan istemcilerin bu arabirimi uygulamasına gerek kalmaz.

Satır içi IME'yi desteklemek için, bir ImeEvent.IME_START_COMPOSITION olayının imeClient özelliğini bu arabirimi uygulayan bir nesneye ayarlayın.

Aşağıdaki terimler genelde IME'yle ilişkili API'lerde kullanılır.

Bir conversation IME ve uygulama arasındaki değişimdir. Bir konuşma sırasında, bir kompozisyon bir veya birden fazla kez güncellenir ve sonra kullanıcı tarafından onaylanır.
Bir kompozisyon, kullanıcı tarafından IME üzerinden girilen metni tanımlar; seçili aralık ve herhangi bir deyimin kapsamı vb. ilişkili giriş durumu bilgisi dahil.
Bir deyim, anlamsal bilgi paylaşabilecek kompozisyon aralığıdır, örneğin girişin seçili bir durumda mı yoksa dönüştürülmüş bir durumda mı olduğunu belirlemek gibi. Bir kompozisyon sıfır veya daha fazla deyim içerir.

İlgili API Öğeleri

flash.text.ime.CompositionAttributeRange
flash.events.IMEEvent.imeClient

Genel Özellikler

	Özellik		Tanımlayan:
		compositionEndIndex : int [salt okunur] Geçerli oturum düzenleme metninin sonunun sıfır tabanlı karakter dizini değeri (örneğin, satır içi oturumda belgeyle onaylanmayan tüm metinler).	IIMEClient
		compositionStartIndex : int [salt okunur] Geçerli oturum düzenleme metninin başlangıcının sıfır tabanlı karakter dizini değeri (örneğin, satır içi oturumda belgeyle onaylanmayan tüm metinler).	IIMEClient
		selectionActiveIndex : int [salt okunur] Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri.	IIMEClient
		selectionAnchorIndex : int [salt okunur] Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri.	IIMEClient
		verticalTextLayout : Boolean [salt okunur] Bileşendeki metnin dikey olup olmadığını belirtir.	IIMEClient

Genel Yöntemler

	Yöntem		Tanımlayan:
		confirmComposition(text:String = null, preserveSelection:Boolean = false):void Satır içi düzenleme oturumunu sonlandırıp metni onaylamak için bu geri çağrıyı kullanın.	IIMEClient
		getTextBounds(startIndex:int, endIndex:int):Rectangle IME, bu yöntemi o sırada IME istemcisiyle düzenlenen metnin sınırlama kutusunu sorgulamak için kullanır.	IIMEClient
		getTextInRange(startIndex:int, endIndex:int):String Belirlenen metin aralığını bileşenden alır.	IIMEClient
		selectRange(anchorIndex:int, activeIndex:int):void Bileşendeki seçili metnin aralığını ayarlar.	IIMEClient
		updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void Satır içi düzenleme oturumunun içeriklerini güncelleştirmeye yönelik geri çağrı.	IIMEClient

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

	Olay		Özet	Tanımlayan:
		imeStartComposition	Kullanıcı bir IME (giriş yöntemi düzenleyicisi) kullanmaya başladığında gönderilir.	IIMEClient
		textInput	Kullanıcı metin girdiğinde gönderilir.	IIMEClient

Özellik Ayrıntısı

compositionEndIndex

özellik

compositionEndIndex:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Geçerli oturum düzenleme metninin sonunun sıfır tabanlı karakter dizini değeri (örneğin, satır içi oturumda belgeyle onaylanmayan tüm metinler).

Uygulama
public function get compositionEndIndex():int

compositionStartIndex

özellik

compositionStartIndex:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Geçerli oturum düzenleme metninin başlangıcının sıfır tabanlı karakter dizini değeri (örneğin, satır içi oturumda belgeyle onaylanmayan tüm metinler).

Uygulama
public function get compositionStartIndex():int

selectionActiveIndex

özellik

selectionActiveIndex:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri.

Uygulama
public function get selectionActiveIndex():int

selectionAnchorIndex

özellik

selectionAnchorIndex:int [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Geçerli seçimdeki ilk karakterin sıfır temelli karakter dizin değeri.

Uygulama
public function get selectionAnchorIndex():int

verticalTextLayout

özellik

verticalTextLayout:Boolean [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Bileşendeki metnin dikey olup olmadığını belirtir. Bu özellik aday pencerenin konumlandırmasını yönetir (örneğin, dikey metnin yanında veya yatay metnin altında).

Uygulama
public function get verticalTextLayout():Boolean

Yöntem Ayrıntısı

confirmComposition

()

yöntem

public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Satır içi düzenleme oturumunu sonlandırıp metni onaylamak için bu geri çağrıyı kullanın.

Parametreler

	`text:String` (default = `null`) — Satır içi oturumdaki metnin son durumu (onaylanan metin).

	`preserveSelection:Boolean` (default = `false`) — true olduğunda, geçerli seçimi, onaylanan metnin sonuna sıfırlamamalısınız.

getTextBounds

()

yöntem

public function getTextBounds(startIndex:int, endIndex:int):Rectangle

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

IME, bu yöntemi o sırada IME istemcisiyle düzenlenen metnin sınırlama kutusunu sorgulamak için kullanır. Bu yöntemi, IME istemcisinde aday pencereyi yerleştirip fare metin alanı üzerindeyken fare imlecini ayarlamak için veya IME'yi destekleyen başka bir bileşen için kullanın.

Parametreler

	`startIndex:int` — Metin aralığının başlangıç konumunu ölçtüğünüz sınırlama kutusundan belirleyen bir tam sayı.

	`endIndex:int` — İsteğe bağlı; metin aralığının başlangıç konumunu ölçtüğünüz sınırlama kutusundan belirleyen bir tam sayı.

Döndürür

Rectangle — Belirlenen metin aralığının sınırlama kutusu, veya dizinlerin biri veya ikisi birden geçersizse null. Bu yöntem startIndex endIndex öğesinden daha fazla veya daha az ise aynı değeri döndürür. startIndex öğesinin endIndex öğesinden büyük veya küçük olsa da olmasa da aynı değer döndürülmelidir.

getTextInRange

()

yöntem

public function getTextInRange(startIndex:int, endIndex:int):String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Belirlenen metin aralığını bileşenden alır. Yöntem IME'nin yeniden dönüştürmesinde çağrılır.

Parametreler

	`startIndex:int` — alınacak metin aralığının başlangıç konumunu belirleyen bir tam sayı.

	`endIndex:int` — alınacak metin aralığının bitiş konumunu belirleyen bir tam sayı.

Döndürür

String — İstenen metin veya istenen aralıkta bir metin yoksa ya da her iki dizin de geçersizse null değeri. startIndex öğesinin endIndex öğesinden büyük veya küçük olmasından bağımsız olarak aynı değer döndürülmelidir.

selectRange

()

yöntem

public function selectRange(anchorIndex:int, activeIndex:int):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Bileşendeki seçili metnin aralığını ayarlar. Argümanlardan herhangi biri sınırlar dışındaysa, seçim değiştirilmemelidir.

Parametreler

	`anchorIndex:int` — Seçimin tutturucu ucundaki karakterin sıfır temelli dizin değeri

	`activeIndex:int` — Seçimin etkin ucundaki karakterin sıfır temelli dizin değeri

updateComposition

()

yöntem

 public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Satır içi düzenleme oturumunun içeriklerini güncelleştirmeye yönelik geri çağrı. Bu yöntem, her IME'yle düzenlenen metin değiştiğinde ve metin içeriği satır içi düzenleme oturumunun tamamını yeniden çizmek için istemci tarafından kullanıldığında çağrılır.

Parametreler

	`text:String` — IME'nin satır içi düzenleme oturumunun metnini içerir.

	`attributes:Vector.<CompositionAttributeRange>` — Süsleme bilgilerine sahip kompozisyon deyimleri dizisini içerir.

	`compositionStartIndex:int` — Metin nesnesinin başlangıcıyla ilişkili satır içi oturumu başlangıcı.

	`compositionEndIndex:int` — Metin nesnesinin başlangıcıyla ilişkili satır içi oturumu bitişi.

Olay Ayrıntısı

imeStartComposition

Olay

Olay Nesne Türü: flash.events.IMEEvent
özellik IMEEvent.type = flash.events.IMEEvent.IME_START_COMPOSITION

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Kullanıcı bir IME (giriş yöntemi düzenleyicisi) kullanmaya başladığında gönderilir.

IME metin girdisini işlemek için, alıcı olayın imeClient alanını IIMEClient arabirimini uygulayan bir nesneye ayarlamalıdır. imeClient ayarlı değilse, çalışma zamanı onun yerine sıra dışı IME kompozisyonunu kullanır ve son kompozisyonu bir TEXT_INPUT olayı olarak gönderir.

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`	IME nesnesi.

textInput

Olay

Olay Nesne Türü: flash.events.TextEvent
özellik TextEvent.type = flash.events.TextEvent.TEXT_INPUT

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Kullanıcı metin girdiğinde gönderilir. IME istemcileri için, alıcı olay nesnesinin text özelliğinde içerilen dizeyi geçerli ekleme noktasına eklemelidir.

Bir 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.

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

IIMEClient - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.text.ime

compositionEndIndex

compositionStartIndex

selectionActiveIndex

selectionAnchorIndex

verticalTextLayout

confirmComposition

getTextBounds

getTextInRange

selectRange

updateComposition

imeStartComposition

textInput