共用方式為


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
    指定處理字串的最大範圍 (以邏輯單位計算)。 會忽略經過處理就會超出此範圍的字元。 所有必要的定序或圖像陣列的計算只適用於包含的字元。 只有在 dwFlags 參數中指定 GCP_MAXEXTENT 值時,才會使用這個參數。 函式處理輸入字串時,只有在總範圍不超過最大值的情況下,會將每個字元與其範圍加入到輸出、擴充和其他陣列。 一旦達到限制,處理就會停止。

  • lpResults
    接收函式結果之 GCP_Results 結構的指標。

  • dwFlags
    指定如何將字串處理成所需的陣列。 這個參數可以是在 GetCharacterPlacement 主題的 dwFlags 一節中列出的一或多個值。

  • str
    要處理的 CString 物件的指標。

傳回值

如果函式成功,則傳回值為以邏輯單位表示的字串寬度和高度。

如果函式失敗,則傳回值為零。

備註

此成員函式模擬函式 GetCharacterPlacement 的功能,如 Windows SDK 所描述。

需求

標題: afxwin.h

請參閱

參考

CDC 類別

階層架構圖表

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics