ホーム › System.Ole › OLEUICONVERTA
OLEUICONVERTA
構造体サイズ=各フィールドのバイト数(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 | LPSTR | 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 | LPSTR | 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 | LPSTR | 8/4 | +152 | +116 | 変換またはアクティブ化するオブジェクトのユーザータイプ名へのポインター。この値が NULL の場合、ダイアログボックスはレジストリからユーザータイプ名を取得します。この文字列は終了時に解放されます。 |
| fObjectsIconChanged | BOOL | 4 | +160 | +120 | オブジェクトのアイコンが変更された場合 (つまり OleUIChangeIcon が呼び出され、キャンセルされなかった場合) は TRUE。このメンバーは出力時に設定されます。 |
| lpszDefLabel | LPSTR | 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 を定義します。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させると、不一致が生じ、コンパイルエラーや実行時エラーの原因となることがあります。詳細については、関数プロトタイプの規則を参照してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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>
// OLEUICONVERTA (x64 192 / x86 136 バイト)
typedef struct OLEUICONVERTA {
DWORD cbStruct;
UI_CONVERT_FLAGS dwFlags;
HWND hWndOwner;
LPSTR lpszCaption;
LPFNOLEUIHOOK lpfnHook;
LPARAM lCustData;
HINSTANCE hInstance;
LPSTR lpszTemplate;
HRSRC hResource;
GUID clsid;
GUID clsidConvertDefault;
GUID clsidActivateDefault;
GUID clsidNew;
DWORD dvAspect;
WORD wFormat;
BOOL fIsLinkedObject;
HGLOBAL hMetaPict;
LPSTR lpszUserType;
BOOL fObjectsIconChanged;
LPSTR lpszDefLabel;
DWORD cClsidExclude;
GUID* lpClsidExclude;
} OLEUICONVERTA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OLEUICONVERTA
{
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 OLEUICONVERTA
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 OLEUICONVERTA(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 OLEUICONVERTA {
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 OLEUICONVERTA 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
OLEUICONVERTA = 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 OLEUICONVERTA = 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
OLEUICONVERTA {.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 OLEUICONVERTA
{
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 レイアウト)
; OLEUICONVERTA サイズ: 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 : LPSTR (+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 : LPSTR (+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 : LPSTR (+116, 4byte) st.29 = 値 / 値 = st.29 (lpoke/lpeek も可)
; fObjectsIconChanged : BOOL (+120, 4byte) st.30 = 値 / 値 = st.30 (lpoke/lpeek も可)
; lpszDefLabel : LPSTR (+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 レイアウト)
; OLEUICONVERTA サイズ: 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 : LPSTR (+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 : LPSTR (+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 : LPSTR (+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 : LPSTR (+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 OLEUICONVERTA
#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, OLEUICONVERTA ; NSTRUCT 変数を確保
st->cbStruct = 100
mes "cbStruct=" + st->cbStruct