Aracılığıyla paylaş

TextEdit Denetim Düzeni

ITextEditProvideruygulamak için özellikler ve yöntemler hakkında bilgiler de dahil olmak üzere yönergeler ve kurallar sunar. TextEdit denetim deseni, metni değiştiren bir denetime(örneğin, otomatik düzeltme gerçekleştiren veya giriş oluşturmayı etkinleştiren bir denetim) programlı erişim için kullanılır.

Not

Bu konudaki uygulama notları, Metin Hizmetleri Çerçevesi'nden (TSF) gelen API'lere başvurur. TSF ve API başvurusu hakkında daha fazla bilgi için bkz. Text Services Framework.

ITextEditProvider için Gerekli Üyeler

Bu özellikler ve yöntemler, ITextEditProvider arabirimini uygulamak için gereklidir.

Gerekli üyeler Üye türü Notlar
GetActiveComposition Yöntem Geçerli dönüştürme aralığını döndürür (dönüştürme yoksa yok). Etkin bileşimi döndür (TSF'de bu, GUID_PROP_COMPOSINGtarafından işaretlenen aralıktır). Örneğin, Microsoft Japonca Giriş Yöntemi Düzenleyicisi 'nde (IME), bu tam altı çizili metin olacaktır.
GetConversionTarget Yöntem Geçerli dönüştürme hedef aralığını döndürür (dönüştürme yoksa yok). TSF'de bu, TF_DISPLAYATTRIBUTE yapısından TF_ATTR_TARGET_NOTCONVERTED veya TF_ATTR_TARGET_CONVERTED olarak işaretlenmiş karakter aralığıdır.

TextEditTextChanged ve ConversionTargetChanged olaylarının, TextEdit desenini destekleyen Microsoft UI Otomasyonu öğeleri tarafından tetiklenmesi gerekir.

TextEditTextChanged

  • TextEditTextChanged olayını yükseltmek için UiaRaiseTextEditTextChangedEvent işlevini kullanın.
  • Aşağıdaki tabloda olayı tetiklemeniz gereken durumlar ve kullanılacak UiaRaiseTextEditTextChangedEventparametrelerilistelenir.
TextEditChangeType Olay Yükü Notlar
Otomatik Düzeltme Yeni düzeltilmiş dize Denetim tarafından otomatik düzeltme yapıldığında oluşturulur. Ya da TSF aracılığıyla bir değiştirme yapıldığında ve aralığın GUID_PROP_TKB_ALTERNATES değeri TKB_ALTERNATES_AUTOCORRECTION_APPLIEDolduğunda.
Oluşturma Güncelleştirilmiş dize Yük yalnızca değiştirilen karakterleri içermelidir (oluşturma dizesinin tamamını göndermeyin). Bir kompozisyon değişimi yapıldığında yükseltilir. TSF'de, oluşturma değiştirme, GUID_PROP_COMPOSING bayrağının ayarlandığı bir değiştirme olarak tanımlanır. TSF uygulayan düzenleme denetimleri, OnEndEdit bildirimi aracılığıyla bu değişiklikleri izleyebilir.
CompositionFinalized Son haline getirilmiş oluşturma dizesi (bkz. Notlar) TSF'de, sonlandırılan dönüştürme dizesi, bir bileşimden kaldırılan GUID_PROP_COMPOSING bayrağı tarafından tanımlanır. TSF uygulayan düzenleme denetimleri, EndComposition son haline getirilmiş dizeyi belirlemeli ve OnEndEdit çağrıldığında olayı tetiklemelidir.
Birleştirme iptal edildiyse veya silindiyse, son haline getirilmiş oluşturma dizesi boş olabilir.

ConversionTargetChanged

  • dönüştürme hedefi bir hedeften diğerine değiştiğinde ConversionTargetChanged gerçekleşir.
  • ConversionTargetChanged olayını yükseltmek için UiaRaiseAutomationEvent işlevini kullanın (UIA_TextEdit_ConversionTargetChangedEventId olay tanımlayıcısını geçirin).
  • ConversionTargetChanged hedef içeriği değiştiğinde tetiklenmemelidir. Hedef değişiklik bir oluşturma değişikliğiyle aynı anda gerçekleşirse, herhangi bir oluşturma olayı zaten oluşturulduktan sonra hedef değişiklik olayının tetiklenmiş olması gerekir.
  • TSF'de dönüştürme hedefi, TF_DISPLAYATTRIBUTE yapısından ayarlanan değer TF_ATTR_TARGET_CONVERTED tanımlanır. Değişiklikler onEndEdit kullanılarak izlenebilir.

kavramsal

Denetim Türlerini ve Desteklenen Denetim Desenlerini

UI Otomasyonu Denetim Desenlerine Genel Bakış

UI Otomasyon Ağacına Genel Bakış

  • Last updated on