共用方式為


CDC::TabbedTextOut

呼叫此成員函式會在指定的位置以寫入字串, 索引標籤將這個值指定定位停駐點 (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。 當設定這個旗標時,視窗會忽略在後續呼叫的 xy 參數為 TabbedTextOut,使用目前的位置。

需求

Header: afxwin.h

請參閱

參考

CDC 類別

階層架構圖

CDC::GetTabbedTextExtent

CDC::SetTextAlign

CDC::TextOut

CDC::SetTextColor

TabbedTextOut

CSize 類別