CDC::DrawText 

sanal int DrawText ( lpctstr lpszString, int nSayı, lprect lpRect, UINT nFormat );

int Dr&awText (const CStringamp;StrlprectlpRectUINTnFormat );

Dönüş değeri

İşlev başarılı olduğunda metni yüksekliği.

Parametreleri

lpszString

Çizilmesi için dizeye işaret eder. NSayı –1 ise, dize boş sonlandırılmış olmalıdır.

nSayı

Dizesindeki karakter sayısını belirtir. NSayı –1 ise, o zaman lpszString bir boş sonlandırılmış dize ve DrawText uzun bir işaretçi karakter sayısını otomatik olarak hesaplar kabul edilir.

lpRect

Puan rect yapısı veya metnin biçimlendirilmesi olan dikdörtgen (mantıksal koordinatları) içeren CRect nesnesi.

str

 Çekilecek belirtilen karakterleri içeren CString nesnesi.

nFormat

Metin biçimlendirme yöntemi belirtir. (Bit düzey veya işlecini kullanarak birleştirme) aşağıdaki değerlerden herhangi bir kombinasyonu olabilir:

• dt_bottomnbsp;  Alt bloklanmış metin belirtir. Bu değer DT_SI&NGLELINE ile kombine edilebilir.
  
  
• dt_calcrect   Genişlik ve yükseklik dikdörtgenin belirler. Birden fazla satır metin varsa, DrawText lpRect tarafından işaret dikdörtgenin genişliğini kullanmak ve metnin son satırının bağlı dikdörtgen tabanı genişletmek. Metnin yalnızca bir hattı varsa, satırın son karakter bounds şekilde DrawText dikdörtgeni sağ tarafına değiştireceksiniz. Her iki durumda da, DrawText biçimlendirilmiş metnin yüksekliğini döndürür, ancak metin çizmek yok.
  
  
• dt_ce&nternbsp;  Metni yatay olarak ortalar.
  
  
• DT_E&ND_ELLIPSIS veya DT_PATH_ELLIPSISnbsp;Yerini dizgeyi bir parçası ile elips, gerekirse sonucu belirtilen dikdörtgende sığması. DT_MODIFYSTRING bayrağı belirtilmediği sürece dizgeyi modifiye edilmemiş.

  Dizenin sonuna karakterler yerine DT_END_ELLIPSIS veya karakterleri dizesi ortasında değiştirmek için DT_PATH_ELLIPSIS belirtebilirsiniz. Ters eğik çizgi (\) karakterleri dizesi içeriyor, DT_PATH_ELLIPSIS sonra son eğik metin mümkün olduğunca korur.

• dt_expa&ndtabsnbsp;  Sekme karakterleri genişletir. Varsayılan karakter sekmesini başına sekiz sayısıdır.
  
  
• DT_EXTER&NALLEADINGnbsp;  Fontun dış satır aralığı, satır yüksekliğini içerir. Normal olarak, dış satır aralığı metindeki bir satırın yüksekliğini bulunmaz.
  
  
• dt_left   Metin flush sola hizalar.
  
  
• DT_MODIFYSTRI&NGnbsp;Görüntülenen metni eşleşecek şekilde dizgeyi değiştirir. DT_END_ELLIPSIS ya da DT_PATH_ELLIPSIS bayrağı belirtilmediği sürece bu bayrak etkisi yoktur.

  Not Bazı uFormat bayrak bileşimleri dizge değiştirilmesine neden olabilir. DT_END_ELLIPSIS ya da DT_PATH_ELLIPSIS ile DT_MODIFYSTRING kullanarak değiştirilecek dizeyi neden olabilir, bir iddia içinde CString neden geçersiz.

• DT_&NOCLIPnbsp;  Berabere kırpma olmadan. DT_NOCLIP kullanıldığında DrawText biraz daha hızlı.
  
  
• DT_NOPREFIXnbsp;  Önek karakterleri işlenmesini devre dışı bırakır. Normalde, DrawText ampersan (&) önek anımsatıcı karakteri izleyen karakterin altını bir yönergesi ve iki işareti olarak yorumlayan (& &) anımsatıcı-önek karakterleri olarak tek bir 've'işareti yazdırmak için bir yönerge. DT_NOPREFIXbelirterek, bu işleme kapalı.
  
  
• DT_PATH_ELLIPSISnbsp; & nbsp;
  
  
• DT_RIGHT   Metin floş sağa hizalar.
  
  
• DT_SI&NGLELINEnbsp;  Yalnızca tek satır belirtir. Satır başları ve güçlüklerinden satır sonu değil.
  
  
• dt_tabstop   Sekme duraklarını ayarlar. Her sekme için karakter sayısı, nFormat yüksek sıralı bayttır. Varsayılan karakter sekmesini başına sekiz sayısıdır.
  
  
• dt_top   Üst bloklanmış metin (yalnızca tek satır) belirtir.
  
  
• dt_vce&nternbsp;  Dikey olarak ortalanmış metin (yalnızca tek satır) belirtir.
  
  
• dt_wordbreak   Sözcük bölme belirtir. Eğer bir kelime lpRecttarafından belirtilen dikdörtgenin kenarından gönderilen uzanacak satırları sözcükler arasında otomatik olarak kesilir. Bir satır return–linefeed sırası da satır sonu.

&Notenbsp;dt_calcrect, DT_EXTERNALLEADING, DT_INTERNAL, DT_NOCLIPve DT_NOPREFIX değerlerini dt_tabstop değeri ile kullanılamaz.

Açıklamalar

Verilen dikdörtgen metni biçimlendirmek için bu üye işlevini çağırın. Uygun alanlarda, metni sola, sağa, hizalama veya Merkezi verilen dikdörtgenin sekme genişletilmesi ve verilen dikdörtgen içinde uygun satırları metin girmesini metni biçimlendirir. NFormat tarafından belirtilen biçimlendirme türü.

Bu üye işlevi, metin çizmek için aygıt içeriği'nın seçili yazı tipini, metin rengini ve arka plan rengini kullanır. DT_NOCLIP biçimi kullanılmadığı sürece, böylece metnin belirtilen dikdörtgenin dışında görünmez DrawText metin klipler. Tüm biçimlendirmeyi DT_SINGLELINE biçiminde birden çok satıra sahip kabul edilir.

Seçili yazı tipi belirtilen dikdörtgeni için çok büyükse, DrawText üye işlevi daha küçük bir yazı tipi yerine denemez.

dt_calcrect bayrağı belirtilmişse, lpRect tarafından belirtilen dikdörtgeni genişlik ve Yükseklik metin çizmek için gerekli yansıtacak şekilde güncelleştirilir.

(Bkz. CDC::SetTextAlign) ta_updatecp metin hizalama bayrağı ayarlandı, DrawText belirtilen dikdörtgenin sol yerine geçerli konumdan başlayarak metin görüntüler. DrawText değil Kaydır metin ta_updatecp bayrağını ayarladığınızda ( dt_wordbreak bayrağı, hiçbir etkisi olmayacaktır).

Metin rengini CDC::SetTextColor tarafından ayarlanmış olabilir.

cdc ge&nel bakış |nbsp; Sınıf üyeleri | Hiyerarşi çizelgesi

Ayrıca bkz:nbsp;CDC::SetTextColor, CDC::ExtTextOut, CDC::TabbedTextOut, CDC::TextOut, :: DrawText, rect, CDC::SetTextAlign