GdipMeasureString:函式原型,函式聲明,VB

函式原型,函式聲明,VB - SDK,C# - SDK,C++ - SDK,F# - SDK,易語言,函式說明,相關套用,

函式原型

GpStatus WINGDIPAPI GdipMeasureString(

GpGraphics *graphics,

GDIPCONST WCHAR *string,

INT length,

GDIPCONST GpFont *font,

GDIPCONST RectF *layoutRect,

GDIPCONST GpStringFormat *stringFormat,

RectF *boundingBox,

INT *codepointsFitted,

INT *linesFilled

)

函式聲明

VB - SDK

'Declaration

Public Function MeasureString ( _

text As String, _

font As Font, _

origin As PointF, _

stringFormat As StringFormat _

) As SizeF

C# - SDK

public SizeF MeasureString(

string text,

Font font,

PointF origin,

StringFormat stringFormat

)

C++ - SDK

public:

SizeF MeasureString(

String^ text,

Font^ font,

PointF origin,

StringFormat^ stringFormat

)

F# - SDK

member MeasureString :

text:string *

font:Font *

origin:PointF *

stringFormat:StringFormat -> SizeF

易語言

.版本 2

.DLL命令 GdipMeasureString, 整數型, "GdiPlus.dll", "GdipMeasureString", 公開

.參數 graphics, 整數型

.參數 string, 位元組集

.參數 length, 整數型

.參數 font, 整數型

.參數 layoutRect, RectF

.參數 stringFormat, 整數型

.參數 boundingBox, RectF

.參數 codepointsFitted, 整數型, 傳址

.參數 linesFilled, 整數型, 傳址

函式說明

Graphics的MeasureString方法，只要指定了字型和字元串後，用這個方法就能獲得一個矩形的區域，這個區域是Graphics對象用DrawString方法在空間表面繪製字元串時所要的區域。

如果使用MeasureString去測量兩個字元串，當StringFormat參數處於默認值時，一個在尾部有空格，一個在尾部沒有空格，那么這兩個字元串測量出來的寬度是一樣的。例如“TextEditor” 和 “TextEditor ”的寬度是一樣的。（全形和半角空格的命運一樣，都被忽略不計了）。

對於這個問題，在參數StringFormat標誌位是可以設定是不是要忽略尾部空格的。

在默認情況下，在測量字元串的長度時，GDI+會添加額外的1/6em長度，為懸垂的字形留出空間，例如斜體字元f。另外，寬度的算法也需要為某些稱作grid fitting的添加空間。在對字形的輪廓進行數學表達，並把它映射到基於光柵的繪圖表面上時，允許寬度有一些輕微的變化。

有時在測量字元串的長度時，不希望GDI+增加這個額外的長度。此時可以讓GDI+使用StringFormat類，以特殊的方式處理文本。可以告訴GDI+使用特定的StringFormat對象，不增加額外的1/6em空間，而StringFormat對象是使用StringFormat.GenericTypography靜態屬性獲得的。

實際套用中，也可以使用原型API GdipStringFormatGetGenericTypographic 直接創建帶GenericTypography靜態屬性StringFormat。

此函式SDK支持的重載

MeasureString(String, Font)

MeasureString(String, Font, SizeF)

MeasureString(String, Font, Int32)

MeasureString(String, Font, PointF, StringFormat)

MeasureString(String, Font, SizeF, StringFormat)

MeasureString(String, Font, Int32, StringFormat)

MeasureString(String, Font, SizeF, StringFormat, Int32, Int32)

編程工具中如果安裝有對應的SDK，可以直接使用，也可以使用API原型調用，方法類似。

MSDN中的介紹連結：

參數

參數說明使用原型API參數介紹。

graphics

GDI+ graphics 對象

string

待處理的字元串

length

字元串長度

font

字元串使用的字型

layoutRect

RectF結構，字元串輸出矩形區域。

StringFormat

StringFormat類，用於指定字元串的樣式，需要和文本輸出函式的StringFormat相同。例如對齊，垂直排列等，會造成字元串在不同格式下輸出矩形產生變化。

boundingBox

RectF結構，函式執行後裝載的字元串位置信息，左上角X和Y，長度和寬度

codepointsFitted

暫不使用，NULL

linesFilled

暫不使用，NULL

GdipMeasureString