Win32 API 日本語リファレンス
ホーム › UI.WindowsAndMessaging › DLGTEMPLATE

DLGTEMPLATE

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 18 バイト / x86: 18 バイトパッキング2

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

フィールド

フィールド型サイズx64x86説明
styleDWORD4+0+0

ダイアログボックスのスタイルです。このメンバーには、ウィンドウスタイル値(WS_CAPTION や WS_SYSMENU など)と ダイアログボックススタイル値(DS_CENTER など)の組み合わせを指定できます。

style メンバーに DS_SETFONT スタイルが含まれる場合、ダイアログボックステンプレートのヘッダーには、ダイアログボックスのクライアント領域とコントロールのテキストに使用するフォントを指定する追加データが格納されます。フォントデータは、title 配列に続く WORD 境界から始まります。フォントデータは、16 ビットのポイントサイズ値と Unicode のフォント名文字列を指定します。可能であれば、システムは指定された値に従ってフォントを作成します。続いてシステムは、ダイアログボックスと各コントロールに WM_SETFONT メッセージを送信し、フォントのハンドルを提供します。DS_SETFONT が指定されていない場合、ダイアログボックステンプレートにフォントデータは含まれません。

DS_SHELLFONT スタイルは DLGTEMPLATE ヘッダーではサポートされていません。

dwExtendedStyleDWORD4+4+4ウィンドウの拡張スタイルです。このメンバーはダイアログボックスの作成には使用されませんが、ダイアログボックステンプレートを使用するアプリケーションが他の種類のウィンドウを作成する際に利用できます。値の一覧については、Extended Window Styles を参照してください。
cditWORD2+8+8ダイアログボックス内の項目の数です。
xSHORT2+10+10ダイアログボックスの左上隅の x 座標(ダイアログボックス単位)です。
ySHORT2+12+12ダイアログボックスの左上隅の y 座標(ダイアログボックス単位)です。
cxSHORT2+14+14ダイアログボックスの幅(ダイアログボックス単位)です。
cySHORT2+16+16ダイアログボックスの高さ(ダイアログボックス単位)です。

公式ドキュメント

ダイアログボックスの寸法とスタイルを定義します。この構造体は、ダイアログボックスの標準テンプレートでは常に先頭に配置され、ダイアログボックス内のコントロールの数、つまりテンプレート内で後続する DLGITEMTEMPLATE 構造体の数も指定します。

解説(Remarks)

ダイアログボックスの標準テンプレートでは、DLGTEMPLATE 構造体の直後に、ダイアログボックスのメニュー、クラス、タイトルを指定する 3 つの可変長配列が必ず続きます。DS_SETFONT スタイルが指定されている場合、これらの配列の後にはさらに、ポイントサイズを指定する 16 ビット値と、書体名を指定する別の可変長配列が続きます。各配列は 1 つ以上の 16 ビット要素で構成されます。menu、class、title、font の各配列は WORD 境界に整列していなければなりません。

DLGTEMPLATE 構造体の直後には、ダイアログボックスのメニューリソースを識別する menu 配列が続きます。この配列の最初の要素が 0x0000 の場合、ダイアログボックスにメニューはなく、配列に他の要素はありません。最初の要素が 0xFFFF の場合、配列には実行可能ファイル内のメニューリソースの序数値を指定する要素がもう 1 つ含まれます。最初の要素がそれ以外の値の場合、システムはこの配列を、実行可能ファイル内のメニューリソースの名前を指定する NULL 終端の Unicode 文字列として扱います。

menu 配列の後には、ダイアログボックスのウィンドウクラスを識別する class 配列が続きます。この配列の最初の要素が 0x0000 の場合、システムはダイアログボックスに定義済みのダイアログボックスクラスを使用し、配列に他の要素はありません。最初の要素が 0xFFFF の場合、配列には定義済みのシステムウィンドウクラスの序数値を指定する要素がもう 1 つ含まれます。最初の要素がそれ以外の値の場合、システムはこの配列を、登録済みのウィンドウクラスの名前を指定する NULL 終端の Unicode 文字列として扱います。

class 配列の後には、ダイアログボックスのタイトルを含む NULL 終端の Unicode 文字列を指定する title 配列が続きます。この配列の最初の要素が 0x0000 の場合、ダイアログボックスにタイトルはなく、配列に他の要素はありません。

16 ビットのポイントサイズ値と typeface 配列は title 配列の後に続きますが、これは style メンバーが DS_SETFONT スタイルを指定している場合に限られます。ポイントサイズ値は、 ダイアログボックスとそのコントロールのテキストに使用するフォントのポイントサイズを指定します。typeface 配列は、フォントの書体名を指定する NULL 終端の Unicode 文字列です。これらの値が指定されている場合、システムは(可能であれば)指定されたサイズと書体を持つフォントを作成し、ダイアログボックスとコントロールを作成する際に、ダイアログボックスプロシージャおよびコントロールのウィンドウプロシージャに WM_SETFONT メッセージを送信します。

標準のダイアログボックステンプレートでは、DLGTEMPLATE ヘッダーの後に、ダイアログボックス内のコントロールの寸法とスタイルを定義する 1 つ以上の DLGITEMTEMPLATE 構造体が続きます。 cdit メンバーは、テンプレート内の DLGITEMTEMPLATE 構造体の数を指定します。これらの DLGITEMTEMPLATE 構造体は DWORD 境界に整列していなければなりません。

menu、class、title、typeface の各配列に文字列を指定する場合は、Unicode 文字列を使用しなければなりません。

x、 y、 cx、 cy の各メンバーは、ダイアログボックス単位で値を指定します。これらの値は、MapDialogRect 関数を使用してスクリーン単位(ピクセル)に変換できます。

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

各言語での定義

#include <windows.h>

// DLGTEMPLATE  (x64 18 / x86 18 バイト)
#pragma pack(push, 2)
typedef struct DLGTEMPLATE {
    DWORD style;
    DWORD dwExtendedStyle;
    WORD cdit;
    SHORT x;
    SHORT y;
    SHORT cx;
    SHORT cy;
} DLGTEMPLATE;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct DLGTEMPLATE
{
    public uint style;
    public uint dwExtendedStyle;
    public ushort cdit;
    public short x;
    public short y;
    public short cx;
    public short cy;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure DLGTEMPLATE
    Public style As UInteger
    Public dwExtendedStyle As UInteger
    Public cdit As UShort
    Public x As Short
    Public y As Short
    Public cx As Short
    Public cy As Short
End Structure
import ctypes
from ctypes import wintypes

class DLGTEMPLATE(ctypes.Structure):
    _pack_ = 2
    _fields_ = [
        ("style", wintypes.DWORD),
        ("dwExtendedStyle", wintypes.DWORD),
        ("cdit", ctypes.c_ushort),
        ("x", ctypes.c_short),
        ("y", ctypes.c_short),
        ("cx", ctypes.c_short),
        ("cy", ctypes.c_short),
    ]
#[repr(C, packed(2))]
pub struct DLGTEMPLATE {
    pub style: u32,
    pub dwExtendedStyle: u32,
    pub cdit: u16,
    pub x: i16,
    pub y: i16,
    pub cx: i16,
    pub cy: i16,
}
import "golang.org/x/sys/windows"

type DLGTEMPLATE struct {
	style uint32
	dwExtendedStyle uint32
	cdit uint16
	x int16
	y int16
	cx int16
	cy int16
}
type
  DLGTEMPLATE = packed record
    style: DWORD;
    dwExtendedStyle: DWORD;
    cdit: Word;
    x: Smallint;
    y: Smallint;
    cx: Smallint;
    cy: Smallint;
  end;
const DLGTEMPLATE = extern struct {
    style: u32,
    dwExtendedStyle: u32,
    cdit: u16,
    x: i16,
    y: i16,
    cx: i16,
    cy: i16,
};
type
  DLGTEMPLATE {.packed.} = object
    style: uint32
    dwExtendedStyle: uint32
    cdit: uint16
    x: int16
    y: int16
    cx: int16
    cy: int16
align(2)
struct DLGTEMPLATE
{
    uint style;
    uint dwExtendedStyle;
    ushort cdit;
    short x;
    short y;
    short cx;
    short cy;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DLGTEMPLATE サイズ: 18 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 18 / 4 切り上げ)
; style : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwExtendedStyle : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; cdit : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; x : SHORT (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; y : SHORT (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; cx : SHORT (+14, 2byte)  wpoke st,14,値  /  値 = wpeek(st,14)
; cy : SHORT (+16, 2byte)  wpoke st,16,値  /  値 = wpeek(st,16)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DLGTEMPLATE, pack=2
    #field int style
    #field int dwExtendedStyle
    #field short cdit
    #field short x
    #field short y
    #field short cx
    #field short cy
#endstruct

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