Win32 API 日本語リファレンス
ホームSystem.Ole › OLEUIBUSYW

OLEUIBUSYW

構造体
サイズx64: 80 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
cbStructDWORD4+0+0構造体のサイズ (バイト単位)。このフィールドは入力時に設定しなければなりません。
dwFlagsBUSY_DIALOG_FLAGS4+4+4

入力時は、初期化フラグと作成フラグを指定します。終了時は、ユーザーが選択した内容を示します。次のフラグの組み合わせを指定できます。

意味
BZ_DISABLECANCELBUTTON
このフラグは Cancel ボタンを無効にします。
BZ_DISABLESWITCHTOBUTTON
入力専用です。このフラグは Switch To... ボタンを無効にします。
BZ_DISABLERETRYBUTTON
入力専用です。このフラグは Retry ボタンを無効にします。
BZ_NOTRESPONDINGDIALOG
入力専用です。このフラグは Busy ダイアログボックスの代わりに Not Responding ダイアログボックスを生成します。テキストが若干異なり、Cancel ボタンは無効になります。
hWndOwnerHWND8/4+8+8ダイアログボックスを所有するウィンドウ。このメンバーは NULL にすべきではありません。
lpszCaptionLPWSTR8/4+16+12ダイアログボックスのタイトルとして使用する文字列へのポインター。NULL の場合、ライブラリは Busy を使用します。
lpfnHookLPFNOLEUIHOOK8/4+24+16ダイアログボックス宛てのメッセージを処理するフック関数へのポインター。フック関数が処理しなかったメッセージをライブラリ内のダイアログボックスプロシージャに渡すには、フック関数は 0 を返さなければなりません。既に処理したメッセージをライブラリのダイアログボックスプロシージャが処理しないようにするには、フック関数は 0 以外の値を返さなければなりません。
lCustDataLPARAM8/4+32+20lpfnHook メンバーが指すフック関数にライブラリが渡す、アプリケーション定義のデータ。ライブラリは WM_INITDIALOG メッセージの lParam パラメーターで OLEUIBUSY 構造体へのポインターを渡します。このポインターを使用して lCustData メンバーを取得できます。
hInstanceHINSTANCE8/4+40+24lpTemplateName メンバーで指定されたダイアログボックステンプレートを含むインスタンス。
lpszTemplateLPWSTR8/4+48+28ライブラリの Busy ダイアログボックステンプレートの代わりに使用するダイアログボックステンプレートの、リソースファイル名を指定する null 終端文字列へのポインター。
hResourceHRSRC8/4+56+32カスタマイズされたテンプレートのハンドル。
hTaskHTASK8/4+64+36入力専用です。ブロックしているタスクへのハンドル。
lphWndDialogHWND*8/4+72+40ダイアログボックスの HWND へのポインター。

公式ドキュメント

OLE ユーザーインターフェイスライブラリが Busy ダイアログボックスの初期化に使用する情報と、ダイアログボックスが閉じられたときにライブラリが情報を返すための領域を格納します。

解説(Remarks)

メモ

oledlg.h ヘッダーは OLEUIBUSY を、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、Conventions for Function Prototypes を参照してください。

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

各言語での定義

#include <windows.h>

// OLEUIBUSYW  (x64 80 / x86 44 バイト)
typedef struct OLEUIBUSYW {
    DWORD cbStruct;
    BUSY_DIALOG_FLAGS dwFlags;
    HWND hWndOwner;
    LPWSTR lpszCaption;
    LPFNOLEUIHOOK lpfnHook;
    LPARAM lCustData;
    HINSTANCE hInstance;
    LPWSTR lpszTemplate;
    HRSRC hResource;
    HTASK hTask;
    HWND* lphWndDialog;
} OLEUIBUSYW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct OLEUIBUSYW
{
    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 IntPtr hTask;
    public IntPtr lphWndDialog;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure OLEUIBUSYW
    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 hTask As IntPtr
    Public lphWndDialog As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class OLEUIBUSYW(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),
        ("hTask", ctypes.c_void_p),
        ("lphWndDialog", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct OLEUIBUSYW {
    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 hTask: *mut core::ffi::c_void,
    pub lphWndDialog: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type OLEUIBUSYW struct {
	cbStruct uint32
	dwFlags uint32
	hWndOwner uintptr
	lpszCaption uintptr
	lpfnHook uintptr
	lCustData uintptr
	hInstance uintptr
	lpszTemplate uintptr
	hResource uintptr
	hTask uintptr
	lphWndDialog uintptr
}
type
  OLEUIBUSYW = record
    cbStruct: DWORD;
    dwFlags: DWORD;
    hWndOwner: Pointer;
    lpszCaption: Pointer;
    lpfnHook: Pointer;
    lCustData: NativeInt;
    hInstance: Pointer;
    lpszTemplate: Pointer;
    hResource: Pointer;
    hTask: Pointer;
    lphWndDialog: Pointer;
  end;
const OLEUIBUSYW = extern struct {
    cbStruct: u32,
    dwFlags: u32,
    hWndOwner: ?*anyopaque,
    lpszCaption: ?*anyopaque,
    lpfnHook: ?*anyopaque,
    lCustData: isize,
    hInstance: ?*anyopaque,
    lpszTemplate: ?*anyopaque,
    hResource: ?*anyopaque,
    hTask: ?*anyopaque,
    lphWndDialog: ?*anyopaque,
};
type
  OLEUIBUSYW {.bycopy.} = object
    cbStruct: uint32
    dwFlags: uint32
    hWndOwner: pointer
    lpszCaption: pointer
    lpfnHook: pointer
    lCustData: int
    hInstance: pointer
    lpszTemplate: pointer
    hResource: pointer
    hTask: pointer
    lphWndDialog: pointer
struct OLEUIBUSYW
{
    uint cbStruct;
    uint dwFlags;
    void* hWndOwner;
    void* lpszCaption;
    void* lpfnHook;
    ptrdiff_t lCustData;
    void* hInstance;
    void* lpszTemplate;
    void* hResource;
    void* hTask;
    void* lphWndDialog;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OLEUIBUSYW サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : BUSY_DIALOG_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 も可)
; hTask : HTASK (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lphWndDialog : HWND* (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OLEUIBUSYW サイズ: 80 バイト(x64)
dim st, 20    ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : BUSY_DIALOG_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,上位
; hTask : HTASK (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; lphWndDialog : HWND* (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global OLEUIBUSYW
    #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 intptr hTask
    #field intptr lphWndDialog
#endstruct

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