CDC::GetCharacterPlacement
文字列に関するさまざまな情報を取得します。
DWORD GetCharacterPlacement(
LPCTSTR lpString,
int nCount,
int nMaxExtent,
LPGCP_RESULTS lpResults,
DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
CString& str,
int nMaxExtent,
LPGCP_RESULTS lpResults,
DWORD dwFlags
) const;
パラメーター
lpString
処理する文字列へのポインター。nCount
文字列の長さを指定します。ANSI バージョンごとに、byte 数を示し、Unicode の関数の場合 word を計算します。詳細については、GetCharacterPlacementを参照してください。nMaxExtent
文字列が処理される最大の範囲を指定します (論理単位で)。この処理された範囲を超える文字は無視されます。必要な命令またはグリフの配列の計算には、含まれる文字にのみ適用されます。このパラメーターは GCP_MAXEXTENT の値が dwFlags のパラメーターで指定した場合にのみ使用されます。関数が入力文字列を処理するため、合計範囲がまだ最大値を超えてされていない場合にだけ出力および各文字範囲は、範囲、およびそのほかの配列に追加されます。制限に達すると、処理を中断します。lpResults
関数の結果を受け取る GCP_RESULTS の構造体へのポインター。dwFlags
必要な配列に文字列を処理する方法を指定します。このパラメーターは GetCharacterPlacement のトピックの dwFlags のセクションに示されている値の一つ以上である場合があります。str
プロセスへの CString オブジェクトへのポインター。
戻り値
関数が正常に終了した場合、戻り値は論理単位での文字列の幅と高さです。
関数が失敗した場合、戻り値はゼロです。
解説
このメンバー関数は Windows SDKに説明されているように、関数 GetCharacterPlacementの機能をエミュレートします。
必要条件
ヘッダー: afxwin.h