ホーム › Graphics.Gdi › TEXTMETRICA

TEXTMETRICA

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 56 バイト / x86: 56 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

型

サイズ

x64

x86

説明

tmHeight

INT

文字の高さ (アセント + ディセント) です。

tmAscent

INT

文字のアセント (ベースラインより上の単位数) です。

tmDescent

INT

文字のディセント (ベースラインより下の単位数) です。

tmInternalLeading

INT

+12

tmHeight メンバーで設定される範囲の内側にあるレディング (空き) の量です。アクセント記号やその他のダイアクリティカルマークがこの領域に現れる場合があります。フォントの設計者は、このメンバーを 0 に設定することもあります。

tmExternalLeading

INT

+16

アプリケーションが行間に追加する余分なレディング (空き) の量です。この領域はフォントの外側にあるため、字形は含まれず、OPAQUE モードと TRANSPARENT モードのいずれにおいてもテキスト出力の呼び出しによって変更されることはありません。フォントの設計者は、このメンバーを 0 に設定することもあります。

tmAveCharWidth

INT

+20

フォント内の文字の平均幅です (一般に文字 x の幅として定義されます)。この値には、太字や斜体の文字に必要なオーバーハングは含まれません。

tmMaxCharWidth

INT

+24

フォント内で最も広い文字の幅です。

tmWeight

INT

+28

フォントの太さ (ウェイト) です。

tmOverhang

INT

+32

一部の合成フォントで、文字列ごとに追加されることのある余分な幅です。太字や斜体などの属性を合成する際に、グラフィックスデバイスインターフェイス (GDI) またはデバイスは、文字単位と文字列単位の両方で文字列に幅を追加しなければならないことがあります。たとえば GDI は、各文字の間隔を広げ、オフセット値だけずらして重ね打ちすることで文字列を太字にし、文字列をせん断することで斜体にします。いずれの場合も、基本となる文字列を超えるオーバーハングが生じます。太字の文字列では、オーバーハングは重ね打ちがずらされる距離です。斜体の文字列では、オーバーハングはフォントの上端がフォントの下端を超えてせん断される量です。

tmOverhang メンバーを使用すると、1 文字に対する GetTextExtentPoint32 関数の呼び出しで返される文字幅のうち、どれだけが実際の文字幅で、どれだけが文字列単位の余分な幅であるかをアプリケーションが判断できます。実際の幅は、エクステントからオーバーハングを引いた値です。

tmDigitizedAspectX

INT

+36

そのフォントが設計対象としたデバイスの水平方向のアスペクトです。

tmDigitizedAspectY

INT

+40

そのフォントが設計対象としたデバイスの垂直方向のアスペクトです。tmDigitizedAspectX メンバーと tmDigitizedAspectY メンバーの比が、そのフォントが設計対象としたデバイスのアスペクト比です。

tmFirstChar

BYTE

+44

フォント内で定義されている最初の文字の値です。

tmLastChar

BYTE

+45

フォント内で定義されている最後の文字の値です。

tmDefaultChar

BYTE

+46

フォントに含まれない文字の代わりに使用される文字の値です。

tmBreakChar

BYTE

+47

テキストの均等割り付けにおいて、単語の区切りを定義するために使用される文字の値です。

tmItalic

BYTE

+48

0 以外の場合、斜体フォントであることを指定します。

tmUnderlined

BYTE

+49

0 以外の場合、下線付きフォントであることを指定します。

tmStruckOut

BYTE

+50

0 以外の場合、取り消し線付きフォントです。

tmPitchAndFamily

TMPF_FLAGS

+51

物理フォントのピッチ、テクノロジ、およびファミリに関する情報を指定します。

このメンバーの下位 4 ビットは、フォントのピッチとテクノロジに関する情報を指定します。4 つのビットそれぞれに対して定数が定義されています。

定数	意味
TMPF_FIXED_PITCH	このビットがセットされている場合、フォントは可変ピッチフォントです。このビットがクリアされている場合、フォントは固定ピッチフォントです。これらの意味が定数名から連想されるものとは逆である点に、十分に注意してください。
TMPF_VECTOR	このビットがセットされている場合、フォントはベクターフォントです。
TMPF_TRUETYPE	このビットがセットされている場合、フォントは TrueType フォントです。
TMPF_DEVICE	このビットがセットされている場合、フォントはデバイスフォントです。

アプリケーションは、これらの下位ビットにエンコードされた性質を慎重に判定し、根拠のない想定をしないようにしてください。たとえば、TrueType フォントと PostScript フォントは、それぞれ専用のビットに加えて TMPF_VECTOR ビットもセットします。等幅のビットマップフォントはこれらの下位ビットがすべてクリアされており、プロポーショナルのビットマップフォントは TMPF_FIXED_PITCH ビットをセットします。PostScript プリンターのデバイスフォントは、TMPF_DEVICE、TMPF_VECTOR、および TMPF_FIXED_PITCH の各ビットをセットします。

tmPitchAndFamily の上位 4 ビットは、そのフォントのフォントファミリを表します。アプリケーションは、値 0xF0 とビット単位の AND 演算子を使用して tmPitchAndFamily の下位 4 ビットをマスクすることで、フォントファミリ名と直接比較して完全一致を調べられる値を取得できます。フォントファミリについては、LOGFONT 構造体の説明を参照してください。

tmCharSet

BYTE

+52

フォントの文字セットです。設定可能な値の一覧については、LOGFONT 構造体の lfCharSet フィールドを参照してください。

公式ドキュメント

TEXTMETRIC 構造体は、物理フォントに関する基本的な情報を格納します。すべてのサイズは論理単位で指定されます。つまり、ディスプレイコンテキストの現在のマッピングモードに依存します。

解説(Remarks)

メモ

wingdi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、TEXTMETRIC を定義しています。エンコーディング非依存のエイリアスの使用と、エンコーディング非依存でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// TEXTMETRICA  (x64 56 / x86 56 バイト)
typedef struct TEXTMETRICA {
    INT tmHeight;
    INT tmAscent;
    INT tmDescent;
    INT tmInternalLeading;
    INT tmExternalLeading;
    INT tmAveCharWidth;
    INT tmMaxCharWidth;
    INT tmWeight;
    INT tmOverhang;
    INT tmDigitizedAspectX;
    INT tmDigitizedAspectY;
    BYTE tmFirstChar;
    BYTE tmLastChar;
    BYTE tmDefaultChar;
    BYTE tmBreakChar;
    BYTE tmItalic;
    BYTE tmUnderlined;
    BYTE tmStruckOut;
    TMPF_FLAGS tmPitchAndFamily;
    BYTE tmCharSet;
} TEXTMETRICA;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct TEXTMETRICA
{
    public int tmHeight;
    public int tmAscent;
    public int tmDescent;
    public int tmInternalLeading;
    public int tmExternalLeading;
    public int tmAveCharWidth;
    public int tmMaxCharWidth;
    public int tmWeight;
    public int tmOverhang;
    public int tmDigitizedAspectX;
    public int tmDigitizedAspectY;
    public byte tmFirstChar;
    public byte tmLastChar;
    public byte tmDefaultChar;
    public byte tmBreakChar;
    public byte tmItalic;
    public byte tmUnderlined;
    public byte tmStruckOut;
    public byte tmPitchAndFamily;
    public byte tmCharSet;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure TEXTMETRICA
    Public tmHeight As Integer
    Public tmAscent As Integer
    Public tmDescent As Integer
    Public tmInternalLeading As Integer
    Public tmExternalLeading As Integer
    Public tmAveCharWidth As Integer
    Public tmMaxCharWidth As Integer
    Public tmWeight As Integer
    Public tmOverhang As Integer
    Public tmDigitizedAspectX As Integer
    Public tmDigitizedAspectY As Integer
    Public tmFirstChar As Byte
    Public tmLastChar As Byte
    Public tmDefaultChar As Byte
    Public tmBreakChar As Byte
    Public tmItalic As Byte
    Public tmUnderlined As Byte
    Public tmStruckOut As Byte
    Public tmPitchAndFamily As Byte
    Public tmCharSet As Byte
End Structure

import ctypes
from ctypes import wintypes

class TEXTMETRICA(ctypes.Structure):
    _fields_ = [
        ("tmHeight", ctypes.c_int),
        ("tmAscent", ctypes.c_int),
        ("tmDescent", ctypes.c_int),
        ("tmInternalLeading", ctypes.c_int),
        ("tmExternalLeading", ctypes.c_int),
        ("tmAveCharWidth", ctypes.c_int),
        ("tmMaxCharWidth", ctypes.c_int),
        ("tmWeight", ctypes.c_int),
        ("tmOverhang", ctypes.c_int),
        ("tmDigitizedAspectX", ctypes.c_int),
        ("tmDigitizedAspectY", ctypes.c_int),
        ("tmFirstChar", ctypes.c_ubyte),
        ("tmLastChar", ctypes.c_ubyte),
        ("tmDefaultChar", ctypes.c_ubyte),
        ("tmBreakChar", ctypes.c_ubyte),
        ("tmItalic", ctypes.c_ubyte),
        ("tmUnderlined", ctypes.c_ubyte),
        ("tmStruckOut", ctypes.c_ubyte),
        ("tmPitchAndFamily", ctypes.c_ubyte),
        ("tmCharSet", ctypes.c_ubyte),
    ]

#[repr(C)]
pub struct TEXTMETRICA {
    pub tmHeight: i32,
    pub tmAscent: i32,
    pub tmDescent: i32,
    pub tmInternalLeading: i32,
    pub tmExternalLeading: i32,
    pub tmAveCharWidth: i32,
    pub tmMaxCharWidth: i32,
    pub tmWeight: i32,
    pub tmOverhang: i32,
    pub tmDigitizedAspectX: i32,
    pub tmDigitizedAspectY: i32,
    pub tmFirstChar: u8,
    pub tmLastChar: u8,
    pub tmDefaultChar: u8,
    pub tmBreakChar: u8,
    pub tmItalic: u8,
    pub tmUnderlined: u8,
    pub tmStruckOut: u8,
    pub tmPitchAndFamily: u8,
    pub tmCharSet: u8,
}

import "golang.org/x/sys/windows"

type TEXTMETRICA struct {
	tmHeight int32
	tmAscent int32
	tmDescent int32
	tmInternalLeading int32
	tmExternalLeading int32
	tmAveCharWidth int32
	tmMaxCharWidth int32
	tmWeight int32
	tmOverhang int32
	tmDigitizedAspectX int32
	tmDigitizedAspectY int32
	tmFirstChar byte
	tmLastChar byte
	tmDefaultChar byte
	tmBreakChar byte
	tmItalic byte
	tmUnderlined byte
	tmStruckOut byte
	tmPitchAndFamily byte
	tmCharSet byte
}

type
  TEXTMETRICA = record
    tmHeight: Integer;
    tmAscent: Integer;
    tmDescent: Integer;
    tmInternalLeading: Integer;
    tmExternalLeading: Integer;
    tmAveCharWidth: Integer;
    tmMaxCharWidth: Integer;
    tmWeight: Integer;
    tmOverhang: Integer;
    tmDigitizedAspectX: Integer;
    tmDigitizedAspectY: Integer;
    tmFirstChar: Byte;
    tmLastChar: Byte;
    tmDefaultChar: Byte;
    tmBreakChar: Byte;
    tmItalic: Byte;
    tmUnderlined: Byte;
    tmStruckOut: Byte;
    tmPitchAndFamily: Byte;
    tmCharSet: Byte;
  end;

const TEXTMETRICA = extern struct {
    tmHeight: i32,
    tmAscent: i32,
    tmDescent: i32,
    tmInternalLeading: i32,
    tmExternalLeading: i32,
    tmAveCharWidth: i32,
    tmMaxCharWidth: i32,
    tmWeight: i32,
    tmOverhang: i32,
    tmDigitizedAspectX: i32,
    tmDigitizedAspectY: i32,
    tmFirstChar: u8,
    tmLastChar: u8,
    tmDefaultChar: u8,
    tmBreakChar: u8,
    tmItalic: u8,
    tmUnderlined: u8,
    tmStruckOut: u8,
    tmPitchAndFamily: u8,
    tmCharSet: u8,
};

type
  TEXTMETRICA {.bycopy.} = object
    tmHeight: int32
    tmAscent: int32
    tmDescent: int32
    tmInternalLeading: int32
    tmExternalLeading: int32
    tmAveCharWidth: int32
    tmMaxCharWidth: int32
    tmWeight: int32
    tmOverhang: int32
    tmDigitizedAspectX: int32
    tmDigitizedAspectY: int32
    tmFirstChar: uint8
    tmLastChar: uint8
    tmDefaultChar: uint8
    tmBreakChar: uint8
    tmItalic: uint8
    tmUnderlined: uint8
    tmStruckOut: uint8
    tmPitchAndFamily: uint8
    tmCharSet: uint8

struct TEXTMETRICA
{
    int tmHeight;
    int tmAscent;
    int tmDescent;
    int tmInternalLeading;
    int tmExternalLeading;
    int tmAveCharWidth;
    int tmMaxCharWidth;
    int tmWeight;
    int tmOverhang;
    int tmDigitizedAspectX;
    int tmDigitizedAspectY;
    ubyte tmFirstChar;
    ubyte tmLastChar;
    ubyte tmDefaultChar;
    ubyte tmBreakChar;
    ubyte tmItalic;
    ubyte tmUnderlined;
    ubyte tmStruckOut;
    ubyte tmPitchAndFamily;
    ubyte tmCharSet;
}

HSP用定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TEXTMETRICA サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; tmHeight : INT (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; tmAscent : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; tmDescent : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; tmInternalLeading : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; tmExternalLeading : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; tmAveCharWidth : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; tmMaxCharWidth : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; tmWeight : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; tmOverhang : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; tmDigitizedAspectX : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; tmDigitizedAspectY : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; tmFirstChar : BYTE (+44, 1byte)  poke st,44,値  /  値 = peek(st,44)
; tmLastChar : BYTE (+45, 1byte)  poke st,45,値  /  値 = peek(st,45)
; tmDefaultChar : BYTE (+46, 1byte)  poke st,46,値  /  値 = peek(st,46)
; tmBreakChar : BYTE (+47, 1byte)  poke st,47,値  /  値 = peek(st,47)
; tmItalic : BYTE (+48, 1byte)  poke st,48,値  /  値 = peek(st,48)
; tmUnderlined : BYTE (+49, 1byte)  poke st,49,値  /  値 = peek(st,49)
; tmStruckOut : BYTE (+50, 1byte)  poke st,50,値  /  値 = peek(st,50)
; tmPitchAndFamily : TMPF_FLAGS (+51, 1byte)  poke st,51,値  /  値 = peek(st,51)
; tmCharSet : BYTE (+52, 1byte)  poke st,52,値  /  値 = peek(st,52)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global TEXTMETRICA
    #field int tmHeight
    #field int tmAscent
    #field int tmDescent
    #field int tmInternalLeading
    #field int tmExternalLeading
    #field int tmAveCharWidth
    #field int tmMaxCharWidth
    #field int tmWeight
    #field int tmOverhang
    #field int tmDigitizedAspectX
    #field int tmDigitizedAspectY
    #field byte tmFirstChar
    #field byte tmLastChar
    #field byte tmDefaultChar
    #field byte tmBreakChar
    #field byte tmItalic
    #field byte tmUnderlined
    #field byte tmStruckOut
    #field byte tmPitchAndFamily
    #field byte tmCharSet
#endstruct

stdim st, TEXTMETRICA        ; NSTRUCT 変数を確保
st->tmHeight = 100
mes "tmHeight=" + st->tmHeight

TEXTMETRICA

フィールド

公式ドキュメント

解説(Remarks)

各言語での定義

HSP用 定義

HSP用定義