CDC::GetOutputTabbedTextExtent

發行項
02/28/2013

使用 m_hDC，呼叫此成員函式來計算字串，輸出裝置內容的寬度和高度。

CSize GetOutputTabbedTextExtent(
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;
CSize GetOutputTabbedTextExtent(
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;

參數

lpszString
要測量的字串的點。您也可以透過這個參數的 CString 物件。
nCount
在指定字串中的字元數。如果 nCount 為– 1，長度計算。
nTabPositions
指定定位停駐點 (Tab Stop) 位置的參數數目等於陣列中的所指向的 lpnTabStopPositions。
lpnTabStopPositions
out 包含以邏輯單位的陣列的點整數定位停駐點 (Tab Stop) 位置。依遞增順序排序必須定位停駐點 (Tab Stop);最小 X 值應該是陣列中的第一個項目。回復選項不允許的。
str
包含要測量之指定字元的 CString 物件。

傳回值

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

備註

如果字串包含一或多個定位字元，字串的寬度 (以 lpnTabStopPositions指定的定位停駐點。函式會使用目前選取的字型計算字串的大小。

目前裁剪區域不位移 GetOutputTabbedTextExtent 函式傳回的高度和寬度。

因為某些裝置在規則影像項目陣列 (也就是不會將字元克恩字元)，則字元範圍的總計的字串可能不等於在字串上的程度。

如果 nTabPositions 是 0，而 lpnTabStopPositions 是 NULL，索引標籤會展開為八個平均字元寬度。如果為 1， nTabPositions 定位停駐點 (Tab Stop) 將由第一個值所指定之距離的分隔。 lpnTabStopPositions 點的陣列。如果提供詳細的 lpnTabStopPositions 按比單一值，定位停駐點為陣列中的每個值所 nTabPositions，由指定的數目為止。