CDC::ExtTextOut

發行項
06/10/2015

使用目前選取的字型，呼叫此成員函式以矩形區域中的字串。

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  
);

參數

x
針對第一個指定字元儲存格的邏輯 X 座標 (以指定的字串。
y
針對第一個指定字元儲存格頂端的邏輯 y 座標 (以指定的字串。
nOptions
指定的型別。這個參數可以是下列其中一個值，或者兩者都不會:
- ETO_CLIPPED 指定文字會裁剪為矩形。
- ETO_OPAQUE 指定目前的背景色彩來填滿矩形。 (您可以設定和查詢與 SetBkColor 和 GetBkColor 成員函式的目前背景色彩)。
lpRect
要判斷矩形的維度的的長度結構的點。這個參數可以是 NULL。您也可以透過這個參數的 CRect 物件。
lpszString
要繪製的指定字串的點。您也可以透過這個參數的 CString 物件。
nCount
在指定字串中的字元數。
lpDxWidths
out 表示相鄰字元儲存格之間的原點距離的點值。例如， lpDxWidths[i] 邏輯單位可以分隔字元儲存格我和字元儲存格的原點我 + 1。如果 lpDxWidths 是 NULL， ExtTextOut 使用字元之間的預設間距。
str
包含要繪製的指定字元的 CString 物件。

傳回值

如果不是零，則函式成功，則為 0。

備註

矩形區域可以是不透明的 (以目前的背景色彩填滿，為)，而且是裁剪區域。

如果 nOptions 是 0，而 lpRect 是 NULL函式，提供裝置內容寫入文字，而不需要使用一個矩形區域。根據預設，函式不會使用目前位置也不會更新。如果應用程式需要更新目前的位置，則當呼叫 ExtTextOut時，應用程式可能會使用 nFlags 的 CDC 成員函式 SetTextAlign 設為 TA_UPDATECP。當設定這個旗標時，視窗會忽略 x 和 y 在後續的呼叫會 ExtTextOut 並使用目前的位置。當應用程式使用 TA_UPDATECP 更新目前的位置時， ExtTextOut 將目前的位置至前一行文字的結束或套用至陣列的最後一個項目中所指定之位置 lpDxWidths，端視何者較大。