GetFontSizeToHandle

フォントハンドルのサイズを取得する

val = GetFontSizeToHandle(FontHandle)

int FontHandle

(プラグイン / モジュール : DxLibW)

解説

CreateFontToHandle で作成したフォントハンドルのフォントサイズをドット単位で取得する関数です。

【引数の説明】
・FontHandle: CreateFontToHandle で作成したフォントハンドルを指定します。

【戻り値】
成功した場合はフォントサイズ(ドット単位の正の整数)が返ります。エラーの場合は -1 が返ります。

【使用例】
フォントハンドルのサイズを取得して、文字列の描画位置や行間隔を計算する場合に使用します。
int fontSize = GetFontSizeToHandle(fontHandle);
int lineHeight = fontSize + 4; // 行間を4ドット空ける

【注意事項】
・デフォルトフォントのサイズを取得する場合は GetFontSize を使用してください。
・フォントハンドルが無効(未作成または削除済み)の場合は -1 が返ります。

【関連関数】
GetFontSize(デフォルトフォントサイズ取得)、CreateFontToHandle(フォント作成)、GetDrawStringWidthToHandle(文字列描画幅取得)

戻り値: int

関連項目

GetFontSizeデフォルトフォントハンドルのサイズを取得する(DxLibW)

情報

プラグイン / モジュールDxLibW
バージョン3.24f
作成日2026/04/12
著作者DxLib: Takumi Yamada / HSP binding: IronHSP Project
URLhttps://dxlib.xsrv.jp/
備考hspdxlib.as をインクルードして使用
タイプDxLib ゲームライブラリ
グループDxLib フォント
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\hspdxlib.hs