CDC::TabbedTextOut

發行項
02/28/2013

呼叫此成員函式會在指定的位置以寫入字串，索引標籤將這個值指定定位停駐點 (Tab Stop) 位置。

virtual CSize TabbedTextOut(
   int x,
   int y,
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);
CSize TabbedTextOut(
   int x,
   int y,
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions,
   int nTabOrigin 
);

參數

x
指定字串開頭的邏輯 X 座標。
y
指定字串開頭的邏輯 Y 座標。
lpszString
要繪製的字串的點。您可以將指標傳遞至字元陣列或這個參數的 CString 物件。
nCount
在指定字串中的字元數。如果 nCount 為– 1，長度計算。
nTabPositions
在指定的值數目定位停駐點 (Tab Stop) 位置。
lpnTabStopPositions
out 包含定位停駐點 (Tab Stop) 位置的陣列中的點 (以邏輯單位 (Logical Unit)。依遞增順序排序必須定位停駐點 (Tab Stop);最小 X 值應該是陣列中的第一個項目。
nTabOrigin
指定索引標籤展開開始位置的 X 座標 (以邏輯單位 (Logical Unit)。
str
包含指定字元的 CString 物件。

傳回值

字串的大小 (以邏輯單位 (Logical Unit) 做為 CSize 物件。

備註

文字在目前選取的字型中。如果 nTabPositions 是 0，而 lpnTabStopPositions 是 NULL，索引標籤會展開為 (octuple) 平均字元寬度。

如果為 1， nTabPositions 定位停駐點 (Tab Stop) 是由第一個值所指定之距離的分隔。 lpnTabStopPositions 陣列。如果 lpnTabStopPositions 陣列包含多個值，指定定位停駐點陣列中的每個值所 nTabPositions，由指定的數目為止。 nTabOrigin 參數可讓應用程式呼叫 TabbedTextOut 函式單行的幾次。如果應用程式已多次呼叫函式以 nTabOrigin 都會設定為相同的值，則函式會展開所有索引標籤相對於 nTabOrigin所指定的位置。

根據預設，函式不會使用目前位置也不會更新。如果應用程式需要更新目前的位置，則當呼叫函式時，應用程式可能會使用 nFlags 的 SetTextAlign 成員函式設定為 TA_UPDATECP。當設定這個旗標時，視窗會忽略在後續呼叫的 x 和 y 參數為 TabbedTextOut，使用目前的位置。