ホーム › Graphics.DirectWrite › DWRITE_TEXT_METRICS1

DWRITE_TEXT_METRICS1

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
Base	DWRITE_TEXT_METRICS	36	+0	+0	基本テキストメトリクス(DWRITE_TEXT_METRICS)を埋め込んだ構造体。
heightIncludingTrailingWhitespace	FLOAT	4	+36	+36	各行の末尾にある空白を考慮した、書式設定されたテキストの高さです。これは縦書きテキストで重要になります。

公式ドキュメント

レイアウト後のテキストに関連付けられたメトリックを格納します。すべての座標はデバイス非依存ピクセル (DIP) 単位です。

DWRITE_TEXT_METRICS1 は DWRITE_TEXT_METRICS を拡張し、書式設定されたテキストの高さを含めます。

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

各言語での定義

#include <windows.h>

// DWRITE_TEXT_METRICS  (x64 36 / x86 36 バイト)
typedef struct DWRITE_TEXT_METRICS {
    FLOAT left;
    FLOAT top;
    FLOAT width;
    FLOAT widthIncludingTrailingWhitespace;
    FLOAT height;
    FLOAT layoutWidth;
    FLOAT layoutHeight;
    DWORD maxBidiReorderingDepth;
    DWORD lineCount;
} DWRITE_TEXT_METRICS;

// DWRITE_TEXT_METRICS1  (x64 40 / x86 40 バイト)
typedef struct DWRITE_TEXT_METRICS1 {
    DWRITE_TEXT_METRICS Base;
    FLOAT heightIncludingTrailingWhitespace;
} DWRITE_TEXT_METRICS1;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DWRITE_TEXT_METRICS
{
    public float left;
    public float top;
    public float width;
    public float widthIncludingTrailingWhitespace;
    public float height;
    public float layoutWidth;
    public float layoutHeight;
    public uint maxBidiReorderingDepth;
    public uint lineCount;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DWRITE_TEXT_METRICS1
{
    public DWRITE_TEXT_METRICS Base;
    public float heightIncludingTrailingWhitespace;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DWRITE_TEXT_METRICS
    Public left As Single
    Public top As Single
    Public width As Single
    Public widthIncludingTrailingWhitespace As Single
    Public height As Single
    Public layoutWidth As Single
    Public layoutHeight As Single
    Public maxBidiReorderingDepth As UInteger
    Public lineCount As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DWRITE_TEXT_METRICS1
    Public Base As DWRITE_TEXT_METRICS
    Public heightIncludingTrailingWhitespace As Single
End Structure

import ctypes
from ctypes import wintypes

class DWRITE_TEXT_METRICS(ctypes.Structure):
    _fields_ = [
        ("left", ctypes.c_float),
        ("top", ctypes.c_float),
        ("width", ctypes.c_float),
        ("widthIncludingTrailingWhitespace", ctypes.c_float),
        ("height", ctypes.c_float),
        ("layoutWidth", ctypes.c_float),
        ("layoutHeight", ctypes.c_float),
        ("maxBidiReorderingDepth", wintypes.DWORD),
        ("lineCount", wintypes.DWORD),
    ]

class DWRITE_TEXT_METRICS1(ctypes.Structure):
    _fields_ = [
        ("Base", DWRITE_TEXT_METRICS),
        ("heightIncludingTrailingWhitespace", ctypes.c_float),
    ]

#[repr(C)]
pub struct DWRITE_TEXT_METRICS {
    pub left: f32,
    pub top: f32,
    pub width: f32,
    pub widthIncludingTrailingWhitespace: f32,
    pub height: f32,
    pub layoutWidth: f32,
    pub layoutHeight: f32,
    pub maxBidiReorderingDepth: u32,
    pub lineCount: u32,
}

#[repr(C)]
pub struct DWRITE_TEXT_METRICS1 {
    pub Base: DWRITE_TEXT_METRICS,
    pub heightIncludingTrailingWhitespace: f32,
}

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

type DWRITE_TEXT_METRICS struct {
	left float32
	top float32
	width float32
	widthIncludingTrailingWhitespace float32
	height float32
	layoutWidth float32
	layoutHeight float32
	maxBidiReorderingDepth uint32
	lineCount uint32
}

type DWRITE_TEXT_METRICS1 struct {
	Base DWRITE_TEXT_METRICS
	heightIncludingTrailingWhitespace float32
}

type
  DWRITE_TEXT_METRICS = record
    left: Single;
    top: Single;
    width: Single;
    widthIncludingTrailingWhitespace: Single;
    height: Single;
    layoutWidth: Single;
    layoutHeight: Single;
    maxBidiReorderingDepth: DWORD;
    lineCount: DWORD;
  end;

  DWRITE_TEXT_METRICS1 = record
    Base: DWRITE_TEXT_METRICS;
    heightIncludingTrailingWhitespace: Single;
  end;

const DWRITE_TEXT_METRICS = extern struct {
    left: f32,
    top: f32,
    width: f32,
    widthIncludingTrailingWhitespace: f32,
    height: f32,
    layoutWidth: f32,
    layoutHeight: f32,
    maxBidiReorderingDepth: u32,
    lineCount: u32,
};

const DWRITE_TEXT_METRICS1 = extern struct {
    Base: DWRITE_TEXT_METRICS,
    heightIncludingTrailingWhitespace: f32,
};

type
  DWRITE_TEXT_METRICS {.bycopy.} = object
    left: float32
    top: float32
    width: float32
    widthIncludingTrailingWhitespace: float32
    height: float32
    layoutWidth: float32
    layoutHeight: float32
    maxBidiReorderingDepth: uint32
    lineCount: uint32

  DWRITE_TEXT_METRICS1 {.bycopy.} = object
    Base: DWRITE_TEXT_METRICS
    heightIncludingTrailingWhitespace: float32

struct DWRITE_TEXT_METRICS
{
    float left;
    float top;
    float width;
    float widthIncludingTrailingWhitespace;
    float height;
    float layoutWidth;
    float layoutHeight;
    uint maxBidiReorderingDepth;
    uint lineCount;
}

struct DWRITE_TEXT_METRICS1
{
    DWRITE_TEXT_METRICS Base;
    float heightIncludingTrailingWhitespace;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DWRITE_TEXT_METRICS1 サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; Base : DWRITE_TEXT_METRICS (+0, 36byte)  varptr(st)+0 を基点に操作(36byte:入れ子/配列)
; heightIncludingTrailingWhitespace : FLOAT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DWRITE_TEXT_METRICS
    #field float left
    #field float top
    #field float width
    #field float widthIncludingTrailingWhitespace
    #field float height
    #field float layoutWidth
    #field float layoutHeight
    #field int maxBidiReorderingDepth
    #field int lineCount
#endstruct

#defstruct global DWRITE_TEXT_METRICS1
    #field DWRITE_TEXT_METRICS Base
    #field float heightIncludingTrailingWhitespace
#endstruct

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

DWRITE_TEXT_METRICS1

フィールド

公式ドキュメント

各言語での定義

HSP用 定義

HSP用定義