ホーム › System.Ole › OLEUICONVERTW
OLEUICONVERTW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbStruct | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。このメンバーは入力時に設定する必要があります。 |
| dwFlags | UI_CONVERT_FLAGS | 4 | +4 | +4 | 入力時、このフィールドは初期化フラグと作成フラグを指定します。終了時には、ユーザーの選択内容を示します。次のフラグの組み合わせを指定できます。 |
| hWndOwner | HWND | 8/4 | +8 | +8 | ダイアログ ボックスを所有するウィンドウ。このメンバーは NULL にしないでください。 |
| lpszCaption | LPWSTR | 8/4 | +16 | +12 | ダイアログ ボックスのタイトルとして使用する文字列へのポインター。NULL の場合、ライブラリは Convert を使用します。 |
| lpfnHook | LPFNOLEUIHOOK | 8/4 | +24 | +16 | ダイアログ ボックス宛てのメッセージを処理するフック関数へのポインター。フック関数は、自身が処理しなかったメッセージをライブラリ内のダイアログ ボックス プロシージャに渡すために 0 を返さなければなりません。既に処理したメッセージをライブラリのダイアログ ボックス プロシージャに処理させないようにするには、フック関数は 0 以外の値を返さなければなりません。 |
| lCustData | LPARAM | 8/4 | +32 | +20 | lpfnHook メンバーが指すフック関数にライブラリが渡す、アプリケーション定義のデータ。ライブラリは WM_INITDIALOG メッセージの lParam パラメーターで OLEUICONVERT 構造体へのポインターを渡します。このポインターを使用して lCustData メンバーを取得できます。 |
| hInstance | HINSTANCE | 8/4 | +40 | +24 | lpszTemplate メンバーで指定されたダイアログ ボックス テンプレートを含むインスタンス。lpszTemplate メンバーが NULL または無効な場合、このメンバーは無視されます。 |
| lpszTemplate | LPWSTR | 8/4 | +48 | +28 | ライブラリの Convert ダイアログ ボックス テンプレートの代わりに使用するダイアログ ボックス テンプレートの、リソース ファイル名を指定する null 終端文字列へのポインター。 |
| hResource | HRSRC | 8/4 | +56 | +32 | カスタム ダイアログ ボックスのリソース ハンドル。このメンバーが NULL の場合、ライブラリは標準の Convert ダイアログ ボックス テンプレートを使用します。lpszTemplate メンバーが有効な場合は、そのメンバーで指定されたテンプレートを使用します。 |
| clsid | GUID | 16 | +64 | +36 | 変換またはアクティブ化するオブジェクトの CLSID。このメンバーは入力時に設定します。 |
| clsidConvertDefault | GUID | 16 | +80 | +52 | Convert To が選択されたときに既定のクラスとして使用する CLSID。dwFlags メンバーに CF_SETCONVERTDEFAULT が含まれていない場合、このメンバーは無視されます。このメンバーは入力時に設定します。 |
| clsidActivateDefault | GUID | 16 | +96 | +68 | Activate As が選択されたときに既定のクラスとして使用する CLSID。dwFlags メンバーに CF_SETACTIVATEDEFAULT が含まれていない場合、このメンバーは無視されます。このメンバーは入力時に設定します。 |
| clsidNew | GUID | 16 | +112 | +84 | 選択されたクラスの CLSID。このメンバーは出力時に設定されます。 |
| dvAspect | DWORD | 4 | +128 | +100 | オブジェクトの表示形式 (アスペクト)。DVASPECT_CONTENT または DVASPECT_ICON のいずれかでなければなりません。入力時に dvAspect が DVASPECT_ICON の場合、Display As Icon ボックスがオンになり、オブジェクトのアイコンが表示されます。このメンバーは入力時と出力時に設定されます。詳細については、DVASPECT を参照してください。 |
| wFormat | WORD | 2 | +132 | +104 | 変換またはアクティブ化するオブジェクトのデータ形式。 |
| fIsLinkedObject | BOOL | 4 | +136 | +108 | オブジェクトがリンクされている場合は TRUE です。このメンバーは入力時に設定します。 |
| hMetaPict | HGLOBAL | 8/4 | +144 | +112 | アイコン表示形式を含む METAFILEPICT。このメンバーは入力時と出力時に設定されます。 |
| lpszUserType | LPWSTR | 8/4 | +152 | +116 | 変換またはアクティブ化するオブジェクトのユーザー タイプ名へのポインター。この値が NULL の場合、ダイアログ ボックスはレジストリからユーザー タイプ名を取得します。この文字列は終了時に解放されます。 |
| fObjectsIconChanged | BOOL | 4 | +160 | +120 | オブジェクトのアイコンが変更された場合 (つまり OleUIChangeIcon が呼び出され、キャンセルされなかった場合) は TRUE です。このメンバーは出力時に設定されます。 |
| lpszDefLabel | LPWSTR | 8/4 | +168 | +124 | アイコンに使用する既定のラベルへのポインター。NULL の場合は、短いユーザー タイプ名が使用されます。オブジェクトがリンクの場合、呼び出し元はリンク ソースの表示名を渡してください。これは終了時に解放されます。 |
| cClsidExclude | DWORD | 4 | +176 | +128 | lpClsidExclude 内の CLSID の数。 |
| lpClsidExclude | GUID* | 8/4 | +184 | +132 | リストから除外する CLSID の一覧へのポインター。 |
公式ドキュメント
OLE ユーザー インターフェイス ライブラリが Convert ダイアログ ボックスを初期化するために使用する情報と、ダイアログ ボックスが閉じられたときにライブラリが情報を返すための領域を格納します。
解説(Remarks)
メモ
oledlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、OLEUICONVERT を定義します。エンコードに中立なエイリアスと、エンコードに中立でないコードを混在させて使用すると、不一致が生じ、コンパイル エラーまたは実行時エラーの原因となる場合があります。詳細については、Conventions for Function Prototypes を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// OLEUICONVERTW (x64 192 / x86 136 バイト)
typedef struct OLEUICONVERTW {
DWORD cbStruct;
UI_CONVERT_FLAGS dwFlags;
HWND hWndOwner;
LPWSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPWSTR lpszTemplate;
HRSRC hResource;
GUID clsid;
GUID clsidConvertDefault;
GUID clsidActivateDefault;
GUID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPWSTR lpszUserType;
BOOL fObjectsIconChanged;
LPWSTR lpszDefLabel;
DWORD cClsidExclude;
GUID* lpClsidExclude;
} OLEUICONVERTW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OLEUICONVERTW
{
public uint cbStruct;
public uint dwFlags;
public IntPtr hWndOwner;
public IntPtr lpszCaption;
public IntPtr lpfnHook;
public IntPtr lCustData;
public IntPtr hInstance;
public IntPtr lpszTemplate;
public IntPtr hResource;
public Guid clsid;
public Guid clsidConvertDefault;
public Guid clsidActivateDefault;
public Guid clsidNew;
public uint dvAspect;
public ushort wFormat;
[MarshalAs(UnmanagedType.Bool)] public bool fIsLinkedObject;
public IntPtr hMetaPict;
public IntPtr lpszUserType;
[MarshalAs(UnmanagedType.Bool)] public bool fObjectsIconChanged;
public IntPtr lpszDefLabel;
public uint cClsidExclude;
public IntPtr lpClsidExclude;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OLEUICONVERTW
Public cbStruct As UInteger
Public dwFlags As UInteger
Public hWndOwner As IntPtr
Public lpszCaption As IntPtr
Public lpfnHook As IntPtr
Public lCustData As IntPtr
Public hInstance As IntPtr
Public lpszTemplate As IntPtr
Public hResource As IntPtr
Public clsid As Guid
Public clsidConvertDefault As Guid
Public clsidActivateDefault As Guid
Public clsidNew As Guid
Public dvAspect As UInteger
Public wFormat As UShort
<MarshalAs(UnmanagedType.Bool)> Public fIsLinkedObject As Boolean
Public hMetaPict As IntPtr
Public lpszUserType As IntPtr
<MarshalAs(UnmanagedType.Bool)> Public fObjectsIconChanged As Boolean
Public lpszDefLabel As IntPtr
Public cClsidExclude As UInteger
Public lpClsidExclude As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class OLEUICONVERTW(ctypes.Structure):
_fields_ = [
("cbStruct", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("hWndOwner", ctypes.c_void_p),
("lpszCaption", ctypes.c_void_p),
("lpfnHook", ctypes.c_void_p),
("lCustData", ctypes.c_ssize_t),
("hInstance", ctypes.c_void_p),
("lpszTemplate", ctypes.c_void_p),
("hResource", ctypes.c_void_p),
("clsid", GUID),
("clsidConvertDefault", GUID),
("clsidActivateDefault", GUID),
("clsidNew", GUID),
("dvAspect", wintypes.DWORD),
("wFormat", ctypes.c_ushort),
("fIsLinkedObject", wintypes.BOOL),
("hMetaPict", ctypes.c_void_p),
("lpszUserType", ctypes.c_void_p),
("fObjectsIconChanged", wintypes.BOOL),
("lpszDefLabel", ctypes.c_void_p),
("cClsidExclude", wintypes.DWORD),
("lpClsidExclude", ctypes.c_void_p),
]#[repr(C)]
pub struct OLEUICONVERTW {
pub cbStruct: u32,
pub dwFlags: u32,
pub hWndOwner: *mut core::ffi::c_void,
pub lpszCaption: *mut core::ffi::c_void,
pub lpfnHook: *mut core::ffi::c_void,
pub lCustData: isize,
pub hInstance: *mut core::ffi::c_void,
pub lpszTemplate: *mut core::ffi::c_void,
pub hResource: *mut core::ffi::c_void,
pub clsid: GUID,
pub clsidConvertDefault: GUID,
pub clsidActivateDefault: GUID,
pub clsidNew: GUID,
pub dvAspect: u32,
pub wFormat: u16,
pub fIsLinkedObject: i32,
pub hMetaPict: *mut core::ffi::c_void,
pub lpszUserType: *mut core::ffi::c_void,
pub fObjectsIconChanged: i32,
pub lpszDefLabel: *mut core::ffi::c_void,
pub cClsidExclude: u32,
pub lpClsidExclude: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type OLEUICONVERTW struct {
cbStruct uint32
dwFlags uint32
hWndOwner uintptr
lpszCaption uintptr
lpfnHook uintptr
lCustData uintptr
hInstance uintptr
lpszTemplate uintptr
hResource uintptr
clsid windows.GUID
clsidConvertDefault windows.GUID
clsidActivateDefault windows.GUID
clsidNew windows.GUID
dvAspect uint32
wFormat uint16
fIsLinkedObject int32
hMetaPict uintptr
lpszUserType uintptr
fObjectsIconChanged int32
lpszDefLabel uintptr
cClsidExclude uint32
lpClsidExclude uintptr
}type
OLEUICONVERTW = record
cbStruct: DWORD;
dwFlags: DWORD;
hWndOwner: Pointer;
lpszCaption: Pointer;
lpfnHook: Pointer;
lCustData: NativeInt;
hInstance: Pointer;
lpszTemplate: Pointer;
hResource: Pointer;
clsid: TGUID;
clsidConvertDefault: TGUID;
clsidActivateDefault: TGUID;
clsidNew: TGUID;
dvAspect: DWORD;
wFormat: Word;
fIsLinkedObject: BOOL;
hMetaPict: Pointer;
lpszUserType: Pointer;
fObjectsIconChanged: BOOL;
lpszDefLabel: Pointer;
cClsidExclude: DWORD;
lpClsidExclude: Pointer;
end;const OLEUICONVERTW = extern struct {
cbStruct: u32,
dwFlags: u32,
hWndOwner: ?*anyopaque,
lpszCaption: ?*anyopaque,
lpfnHook: ?*anyopaque,
lCustData: isize,
hInstance: ?*anyopaque,
lpszTemplate: ?*anyopaque,
hResource: ?*anyopaque,
clsid: GUID,
clsidConvertDefault: GUID,
clsidActivateDefault: GUID,
clsidNew: GUID,
dvAspect: u32,
wFormat: u16,
fIsLinkedObject: i32,
hMetaPict: ?*anyopaque,
lpszUserType: ?*anyopaque,
fObjectsIconChanged: i32,
lpszDefLabel: ?*anyopaque,
cClsidExclude: u32,
lpClsidExclude: ?*anyopaque,
};type
OLEUICONVERTW {.bycopy.} = object
cbStruct: uint32
dwFlags: uint32
hWndOwner: pointer
lpszCaption: pointer
lpfnHook: pointer
lCustData: int
hInstance: pointer
lpszTemplate: pointer
hResource: pointer
clsid: GUID
clsidConvertDefault: GUID
clsidActivateDefault: GUID
clsidNew: GUID
dvAspect: uint32
wFormat: uint16
fIsLinkedObject: int32
hMetaPict: pointer
lpszUserType: pointer
fObjectsIconChanged: int32
lpszDefLabel: pointer
cClsidExclude: uint32
lpClsidExclude: pointerstruct OLEUICONVERTW
{
uint cbStruct;
uint dwFlags;
void* hWndOwner;
void* lpszCaption;
void* lpfnHook;
ptrdiff_t lCustData;
void* hInstance;
void* lpszTemplate;
void* hResource;
GUID clsid;
GUID clsidConvertDefault;
GUID clsidActivateDefault;
GUID clsidNew;
uint dvAspect;
ushort wFormat;
int fIsLinkedObject;
void* hMetaPict;
void* lpszUserType;
int fObjectsIconChanged;
void* lpszDefLabel;
uint cClsidExclude;
void* lpClsidExclude;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OLEUICONVERTW サイズ: 136 バイト(x86)
dim st, 34 ; 4byte整数×34(構造体サイズ 136 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : UI_CONVERT_FLAGS (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hWndOwner : HWND (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; lpszCaption : LPWSTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpfnHook : LPFNOLEUIHOOK (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lCustData : LPARAM (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; hInstance : HINSTANCE (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; lpszTemplate : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; hResource : HRSRC (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; clsid : GUID (+36, 16byte) varptr(st)+36 を基点に操作(16byte:入れ子/配列)
; clsidConvertDefault : GUID (+52, 16byte) varptr(st)+52 を基点に操作(16byte:入れ子/配列)
; clsidActivateDefault : GUID (+68, 16byte) varptr(st)+68 を基点に操作(16byte:入れ子/配列)
; clsidNew : GUID (+84, 16byte) varptr(st)+84 を基点に操作(16byte:入れ子/配列)
; dvAspect : DWORD (+100, 4byte) st.25 = 値 / 値 = st.25 (lpoke/lpeek も可)
; wFormat : WORD (+104, 2byte) wpoke st,104,値 / 値 = wpeek(st,104)
; fIsLinkedObject : BOOL (+108, 4byte) st.27 = 値 / 値 = st.27 (lpoke/lpeek も可)
; hMetaPict : HGLOBAL (+112, 4byte) st.28 = 値 / 値 = st.28 (lpoke/lpeek も可)
; lpszUserType : LPWSTR (+116, 4byte) st.29 = 値 / 値 = st.29 (lpoke/lpeek も可)
; fObjectsIconChanged : BOOL (+120, 4byte) st.30 = 値 / 値 = st.30 (lpoke/lpeek も可)
; lpszDefLabel : LPWSTR (+124, 4byte) st.31 = 値 / 値 = st.31 (lpoke/lpeek も可)
; cClsidExclude : DWORD (+128, 4byte) st.32 = 値 / 値 = st.32 (lpoke/lpeek も可)
; lpClsidExclude : GUID* (+132, 4byte) varptr(st)+132 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OLEUICONVERTW サイズ: 192 バイト(x64)
dim st, 48 ; 4byte整数×48(構造体サイズ 192 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : UI_CONVERT_FLAGS (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; hWndOwner : HWND (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpszCaption : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpfnHook : LPFNOLEUIHOOK (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lCustData : LPARAM (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; hInstance : HINSTANCE (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpszTemplate : LPWSTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; hResource : HRSRC (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; clsid : GUID (+64, 16byte) varptr(st)+64 を基点に操作(16byte:入れ子/配列)
; clsidConvertDefault : GUID (+80, 16byte) varptr(st)+80 を基点に操作(16byte:入れ子/配列)
; clsidActivateDefault : GUID (+96, 16byte) varptr(st)+96 を基点に操作(16byte:入れ子/配列)
; clsidNew : GUID (+112, 16byte) varptr(st)+112 を基点に操作(16byte:入れ子/配列)
; dvAspect : DWORD (+128, 4byte) st.32 = 値 / 値 = st.32 (lpoke/lpeek も可)
; wFormat : WORD (+132, 2byte) wpoke st,132,値 / 値 = wpeek(st,132)
; fIsLinkedObject : BOOL (+136, 4byte) st.34 = 値 / 値 = st.34 (lpoke/lpeek も可)
; hMetaPict : HGLOBAL (+144, 8byte) qpoke st,144,値 / qpeek(st,144) ※IronHSPのみ。3.7/3.8は lpoke st,144,下位 : lpoke st,148,上位
; lpszUserType : LPWSTR (+152, 8byte) qpoke st,152,値 / qpeek(st,152) ※IronHSPのみ。3.7/3.8は lpoke st,152,下位 : lpoke st,156,上位
; fObjectsIconChanged : BOOL (+160, 4byte) st.40 = 値 / 値 = st.40 (lpoke/lpeek も可)
; lpszDefLabel : LPWSTR (+168, 8byte) qpoke st,168,値 / qpeek(st,168) ※IronHSPのみ。3.7/3.8は lpoke st,168,下位 : lpoke st,172,上位
; cClsidExclude : DWORD (+176, 4byte) st.44 = 値 / 値 = st.44 (lpoke/lpeek も可)
; lpClsidExclude : GUID* (+184, 8byte) varptr(st)+184 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global OLEUICONVERTW
#field int cbStruct
#field int dwFlags
#field intptr hWndOwner
#field intptr lpszCaption
#field intptr lpfnHook
#field intptr lCustData
#field intptr hInstance
#field intptr lpszTemplate
#field intptr hResource
#field GUID clsid
#field GUID clsidConvertDefault
#field GUID clsidActivateDefault
#field GUID clsidNew
#field int dvAspect
#field short wFormat
#field bool fIsLinkedObject
#field intptr hMetaPict
#field intptr lpszUserType
#field bool fObjectsIconChanged
#field intptr lpszDefLabel
#field int cClsidExclude
#field intptr lpClsidExclude
#endstruct
stdim st, OLEUICONVERTW ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct