CDC::TabbedTextOut
タブ ストップ位置の配列で指定された位置にタブを配置する文字列を指定位置から書き込みますには、このメンバー関数を呼び出します。
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
タブ ストップ位置の配列に値の数を指定します。lpnTabStopPositions
タブ ストップ位置を含む配列へのポインター (論理単位で)。タブ位置は昇順に並べ替える必要があります。; 最小値 x は配列の最初の項目必要があります。nTabOrigin
タブが配置される開始位置の x 座標を指定します (論理単位で)。str
指定された文字を含む CString のオブジェクト。
戻り値
CSize のオブジェクトとして文字列のサイズ (論理単位で)。
解説
テキストは、現在選択されているフォントで表記されます。nTabPositions が 0、lpnTabStopPositions が nullの場合、タブには、平均文字幅の 8 倍に配置されます。
nTabPositions が 1 の場合、タブ位置は lpnTabStopPositions の配列の最初の値で指定された間隔で区切られます。lpnTabStopPositions の配列が複数の値を含む場合、タブ位置は nTabPositionsで指定された数まで、配列の各値は、設定されます。nTabOrigin のパラメーターは TabbedTextOut 関数を単一行に対して呼び出すアプリケーションを数回できます。アプリケーションが同じ値に設定されるたび nTabOrigin 関数を複数回呼び出すと関数は nTabOriginで指定した位置に関連するすべてのタブを展開します。
既定では、現在位置は関数によって使用または、更新されません。関数を呼び出すときにアプリケーションが現在位置を更新する必要がある場合、アプリケーションは nFlags 関数が TA_UPDATECPに設定 SetTextAlign のメンバーを呼び出すことができます。このフラグが設定されていると、Windows は現在位置を使用して TabbedTextOutに、後続の x と y の パラメーターを、代わりに無視されます。
必要条件
ヘッダー: afxwin.h