DTBLLABEL

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
ulbLpszLabelName	DWORD	4	+0	+0	ラベル文字列へのオフセット。構造体先頭からのバイトオフセットで指定する。
ulFlags	DWORD	4	+4	+4	ラベルの文字種別を示すフラグ。MAPI_UNICODE指定で文字列をUnicodeと解釈する。

公式ドキュメント

適用対象: Outlook 2013 | Outlook 2016

表示テーブルから構築されるダイアログボックスで使用されるラベルを記述します。

プロパティ	値
ヘッダーファイル:	Mapidefs.h
関連マクロ	SizedDtblLabel

typedef struct _DTBLLABEL
{
  ULONG ulbLpszLabelName;
  ULONG ulFlags;
} DTBLLABEL, FAR *LPDTBLLABEL;

解説(Remarks)

DTBLLABEL 構造体は、他の種類のコントロールと共に表示され、そのコントロールに意味を付加するラベルコントロールのテキストを記述します。たとえば、ほとんどの編集コントロールは、入力すべき情報の種類をユーザーに知らせるためにラベルの隣に配置されます。グループボックスやラジオボタンなど、一部のコントロールは独自のラベルを保持しています。

ラベルには Windows のアクセラレータを含めることができます。アクセラレータはアンパサンド (&) の後に続く文字として識別されます。アクセラレータキーを押すと、表示テーブル内でこのラベルの後にある最初の、ラベルでもボタンでもないコントロールにフォーカスが移動します。

複数行のラベルはサポートされていません。複数行を表示するには、複数のラベルが必要です。

ラベルを読み取り専用の編集コントロールとして使用することはできません。両者の違いは、編集コントロールは選択してコピーできるのに対し、ラベルはそれができない点です。

表示テーブルの概要については、「Display Tables」を参照してください。表示テーブルの実装方法については、「Implementing a Display Table」を参照してください。

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

各言語での定義

#include <windows.h>

// DTBLLABEL  (x64 8 / x86 8 バイト)
typedef struct DTBLLABEL {
    DWORD ulbLpszLabelName;
    DWORD ulFlags;
} DTBLLABEL;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DTBLLABEL
{
    public uint ulbLpszLabelName;
    public uint ulFlags;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DTBLLABEL
    Public ulbLpszLabelName As UInteger
    Public ulFlags As UInteger
End Structure

import ctypes
from ctypes import wintypes

class DTBLLABEL(ctypes.Structure):
    _fields_ = [
        ("ulbLpszLabelName", wintypes.DWORD),
        ("ulFlags", wintypes.DWORD),
    ]

#[repr(C)]
pub struct DTBLLABEL {
    pub ulbLpszLabelName: u32,
    pub ulFlags: u32,
}

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

type DTBLLABEL struct {
	ulbLpszLabelName uint32
	ulFlags uint32
}

type
  DTBLLABEL = record
    ulbLpszLabelName: DWORD;
    ulFlags: DWORD;
  end;

const DTBLLABEL = extern struct {
    ulbLpszLabelName: u32,
    ulFlags: u32,
};

type
  DTBLLABEL {.bycopy.} = object
    ulbLpszLabelName: uint32
    ulFlags: uint32

struct DTBLLABEL
{
    uint ulbLpszLabelName;
    uint ulFlags;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DTBLLABEL サイズ: 8 バイト(x64)
dim st, 2    ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; ulbLpszLabelName : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DTBLLABEL
    #field int ulbLpszLabelName
    #field int ulFlags
#endstruct

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