CDC::ExtTextOut

Makale
02/26/2013

Şu anda seçili yazı tipini kullanarak bir dikdörtgen bölgesini içinde bir karakter dizesini yazmak için bu üye işlevini çağırın.

virtual BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   LPCTSTR lpszString,
   UINT nCount,
   LPINT lpDxWidths 
);
BOOL ExtTextOut(
   int x,
   int y,
   UINT nOptions,
   LPCRECT lpRect,
   const CString& str,
   LPINT lpDxWidths 
);

Parametreler

x
Mantıksal x-koordinatı ilk karakter için karakter hücre içinde belirtilen dizeyi belirtir.
y
Mantıksal y-koordinatı ilk karakter için karakter hücrenin üstüne belirtilen dizeyi belirtir.
nOptions
Dikdörtgen türünü belirtir.Bu parametre, birini, her ikisi veya aşağıdaki değerlerden biri olabilir:
- ETO_CLIPPED metin yatay kaydırma için dikdörtgeni kırpılır belirtir.
- eto_opaque geçerli arka plan rengi dikdörtgen doldurur belirtir.(Ayarlamak ve geçerli arka plan rengiyle sorgu SetBkColor ve GetBkColor üye işlevlerini.)
lpRect
İşaret eden bir rect dikdörtgenin boyutları belirler yapısı.Bu parametre olabilir null.Ayrıca iletebilirsiniz bir CRect bu parametre nesnesi.
lpszString
Belirtilen karakter dizesinin çizilmesi için işaret ediyor.Ayrıca iletebilirsiniz bir CString bu parametre nesnesi.
nCount
Dizesindeki karakter sayısını belirtir.
lpDxWidths
Kaynaklarına kadar izlenebilen bitişik karakterin hücreler arasındaki mesafeyi gösteren değerler noktaları bir dizi.Örneğin, lpDxWidthsi mantıksal birimler karakter hücrenin kaynaklarına kadar izlenebilen ayrı i ve karakter hücre i + 1.lpDxWidths Olan null, ExtTextOut karakterlerin varsayılan aralığını kullanır.
str
A CString çizilmesi için belirtilen karakterleri içeren nesne.

Dönüş Değeri

Sıfır olmayan bir değer işlevi başarılı olursa; Aksi halde 0.

Notlar

(Geçerli arka plan rengiyle doldurmuş) dikdörtgen bölgesini opak olabilir ve bir kırpma bölgesi olabilir.

nOptions 0'dır ve lpRect olan null, dikdörtgen bölgesini kullanmadan işlevi metin için aygıt içeriği yazar.Varsayılan olarak, geçerli konum değil kullanılan veya işlev tarafından güncelleştirildi.Bir uygulama onu çağırdığında geçerli konumunu güncelleştirme gerekip gerekmediğini ExtTextOut, uygulamanın çağırabileceği CDC üye işlev SetTextAlign ile nFlags ayarlamak ta_updatecp.Bu bayrak ayarlandığında, Windows yoksayar x ve y sonraki aramalarda ExtTextOut ve bunun yerine geçerli konumu kullanır.Bir uygulama kullandığında ta_updatecp geçerli konumunu güncelleştirmek için ExtTextOut geçerli konumu önceki metin satırının sonuna veya göre sıralanmasını dizinin son öğesi ile belirtilen konuma ayarlar lpDxWidths, hangisi daha büyükse.