GetTextMetrics

GetTextMetrics，該函式把程式當前的字型信息，存放到TEXTMETRIC（即MSDN原文中的specified buffer）中。

基本介紹

• 外文名：GetTextMetrics
• 函式原型：BOOL GetTextMetrics
• hdc：設備環境句柄
• lptm：指向結構TEXTMETRIC的指針

函式功能

該函式把程式當前的字型信息，存放到TEXTMETRIC（即MSDN原文中的specified buffer）中。

函式原型：

BOOL GetTextMetrics(HDC hdc, LPTEXTMETRIC lptm)；

參數

hdc：設備環境句柄。

lptm：指向結構TEXTMETRIC的指針，該結構用於獲得字型信息。

返回值：

如果函式調用成功，返回值非零，如果函式調用失敗，返回值是0。

Windows NT\2000\XP：若想獲得更多錯誤信息，請調用GetLastError函式。

Windows 95/98/Me:對於這樣的版本,需要去下載Microsoft layer提供的MSLU（詳見：2008年12月的MSDN）.

需要

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；

頭檔案：wingdi.h；

庫檔案：gdi32.lib；

Unicode：在Windows NT環境下實現為Unicode和ANSI兩種版本。

包含的頭檔案：afxwin.h

示例：

BOOL GetTextMetrics(

LPTEXTMETRIC lpMetrics

） const;

參數結構為

TEXTMETRIC Structure

The TEXTMETRIC structure has the following form:

typedef struct tagTEXTMETRIC { /* tm */

int tmHeight; int tmAscent;

int tmDescent;

int tmInternalLeading;

int tmExternalLeading;

int tmAveCharWidth;

int tmMaxCharWidth;

int tmWeight;

BYTE tmItalic;

BYTE tmUnderlined;

BYTE tmStruckOut;

BYTE tmFirstChar;

BYTE tmLastChar;

BYTE tmDefaultChar;

BYTE tmBreakChar;

BYTE tmPitchAndFamily;

BYTE tmCharSet;

int tmOverhang;

int tmDigitizedAspectX;

int tmDigitizedAspectY;

} TEXTMETRIC;

TEXTMETRIC結構包含了關於字型的基本物理信息。所有的大小都是以邏輯單位給出的，也就是說，它們依賴於顯示設備的當前圖形編碼模式。

有關此結構更完整的信息，請查閱Win32 SDK文檔中的TEXTMETRIC。