CHARFORMATW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 指定した構造体のサイズ (バイト単位)。このメンバーは、構造体をリッチ エディット コントロールに渡す前に設定しておく必要があります。 | ||||||||||||||||||||||||||
| dwMask | CFM_MASK | 4 | +4 | +4 | 有効な情報を含むメンバー、または設定する属性。このメンバーには、0、または次の値のうち 1 つ以上を指定できます。
| ||||||||||||||||||||||||||
| dwEffects | CFE_EFFECTS | 4 | +8 | +8 | 文字効果。このメンバーには、次の値の組み合わせを指定できます。
| ||||||||||||||||||||||||||
| yHeight | INT | 4 | +12 | +12 | 文字の高さ (twip 単位。1 twip は 1/1440 インチ、またはプリンターのポイントの 1/20)。 | ||||||||||||||||||||||||||
| yOffset | INT | 4 | +16 | +16 | ベースラインからの文字のオフセット (twip 単位)。このメンバーの値が正の場合、文字は上付き文字になり、負の場合は下付き文字になります。 | ||||||||||||||||||||||||||
| crTextColor | COLORREF | 4 | +20 | +20 | テキストの色。CFE_AUTOCOLOR 文字効果が指定されている場合、このメンバーは無視されます。COLORREF を生成するには、RGB マクロを使用します。 | ||||||||||||||||||||||||||
| bCharSet | FONT_CHARSET | 1 | +24 | +24 | 文字セットの値。bCharSet メンバーには、LOGFONT 構造体の lfCharSet メンバーに指定できる値のいずれかを指定できます。対象の文字に対して無効な値である場合、Microsoft Rich Edit 3.0 はこの値を上書きすることがあります。 | ||||||||||||||||||||||||||
| bPitchAndFamily | BYTE | 1 | +25 | +25 | フォント ファミリとピッチ。このメンバーは、LOGFONT 構造体の lfPitchAndFamily メンバーと同じです。 | ||||||||||||||||||||||||||
| szFaceName | WCHAR | 64 | +26 | +26 | フォント名を指定する、NULL で終わる文字配列。 |
公式ドキュメント
リッチ エディット コントロールの文字書式に関する情報を格納します。
Rich Edit 2.0: CHARFORMAT2 構造体は、CHARFORMAT 構造体の Microsoft Rich Edit 2.0 拡張です。Microsoft Rich Edit 2.0 以降では、EM_GETCHARFORMAT メッセージおよび EM_SETCHARFORMAT メッセージで、どちらの構造体も使用できます。
解説(Remarks)
書式属性をオフにするには、dwMask に該当する値を設定し、dwEffects には対応する値を設定しないでください。たとえば、斜体をオフにするには、CFM_ITALIC を設定し、CFE_ITALIC は設定しません。
richedit.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして CHARFORMAT を定義します。エンコードに依存しないエイリアスを、エンコードに依存するコードと混在させると、不一致が生じてコンパイル エラーや実行時エラーの原因となることがあります。詳細については、「Conventions for Function Prototypes」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CHARFORMATW (x64 92 / x86 92 バイト)
typedef struct CHARFORMATW {
DWORD cbSize;
CFM_MASK dwMask;
CFE_EFFECTS dwEffects;
INT yHeight;
INT yOffset;
COLORREF crTextColor;
FONT_CHARSET bCharSet;
BYTE bPitchAndFamily;
WCHAR szFaceName[32];
} CHARFORMATW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CHARFORMATW
{
public uint cbSize;
public uint dwMask;
public uint dwEffects;
public int yHeight;
public int yOffset;
public uint crTextColor;
public byte bCharSet;
public byte bPitchAndFamily;
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string szFaceName;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CHARFORMATW
Public cbSize As UInteger
Public dwMask As UInteger
Public dwEffects As UInteger
Public yHeight As Integer
Public yOffset As Integer
Public crTextColor As UInteger
Public bCharSet As Byte
Public bPitchAndFamily As Byte
<MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public szFaceName As String
End Structureimport ctypes
from ctypes import wintypes
class CHARFORMATW(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("dwMask", wintypes.DWORD),
("dwEffects", wintypes.DWORD),
("yHeight", ctypes.c_int),
("yOffset", ctypes.c_int),
("crTextColor", wintypes.DWORD),
("bCharSet", ctypes.c_ubyte),
("bPitchAndFamily", ctypes.c_ubyte),
("szFaceName", ctypes.c_wchar * 32),
]#[repr(C)]
pub struct CHARFORMATW {
pub cbSize: u32,
pub dwMask: u32,
pub dwEffects: u32,
pub yHeight: i32,
pub yOffset: i32,
pub crTextColor: u32,
pub bCharSet: u8,
pub bPitchAndFamily: u8,
pub szFaceName: [u16; 32],
}import "golang.org/x/sys/windows"
type CHARFORMATW struct {
cbSize uint32
dwMask uint32
dwEffects uint32
yHeight int32
yOffset int32
crTextColor uint32
bCharSet byte
bPitchAndFamily byte
szFaceName [32]uint16
}type
CHARFORMATW = record
cbSize: DWORD;
dwMask: DWORD;
dwEffects: DWORD;
yHeight: Integer;
yOffset: Integer;
crTextColor: DWORD;
bCharSet: Byte;
bPitchAndFamily: Byte;
szFaceName: array[0..31] of WideChar;
end;const CHARFORMATW = extern struct {
cbSize: u32,
dwMask: u32,
dwEffects: u32,
yHeight: i32,
yOffset: i32,
crTextColor: u32,
bCharSet: u8,
bPitchAndFamily: u8,
szFaceName: [32]u16,
};type
CHARFORMATW {.bycopy.} = object
cbSize: uint32
dwMask: uint32
dwEffects: uint32
yHeight: int32
yOffset: int32
crTextColor: uint32
bCharSet: uint8
bPitchAndFamily: uint8
szFaceName: array[32, uint16]struct CHARFORMATW
{
uint cbSize;
uint dwMask;
uint dwEffects;
int yHeight;
int yOffset;
uint crTextColor;
ubyte bCharSet;
ubyte bPitchAndFamily;
wchar[32] szFaceName;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CHARFORMATW サイズ: 92 バイト(x64)
dim st, 23 ; 4byte整数×23(構造体サイズ 92 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwMask : CFM_MASK (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwEffects : CFE_EFFECTS (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; yHeight : INT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; yOffset : INT (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; crTextColor : COLORREF (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; bCharSet : FONT_CHARSET (+24, 1byte) poke st,24,値 / 値 = peek(st,24)
; bPitchAndFamily : BYTE (+25, 1byte) poke st,25,値 / 値 = peek(st,25)
; szFaceName : WCHAR (+26, 64byte) varptr(st)+26 を基点に操作(64byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CHARFORMATW
#field int cbSize
#field int dwMask
#field int dwEffects
#field int yHeight
#field int yOffset
#field int crTextColor
#field byte bCharSet
#field byte bPitchAndFamily
#field wchar szFaceName 32
#endstruct
stdim st, CHARFORMATW ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize