Win32 API 日本語リファレンス
ホームUI.Controls.Dialogs › OFNOTIFYW

OFNOTIFYW

構造体
サイズx64: 40 バイト / x86: 20 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
hdrNMHDR24/12+0+0この構造体の code メンバーには、送信されるメッセージを識別する次の通知メッセージのいずれかを指定できます: CDN_FILEOKCDN_FOLDERCHANGECDN_HELPCDN_INITDONECDN_SELCHANGECDN_SHAREVIOLATIONCDN_TYPECHANGE
lpOFNOPENFILENAMEW*8/4+24+12Open または Save As ダイアログボックスの作成時に指定された OPENFILENAME 構造体へのポインターです。一部の通知メッセージでは、この構造体に通知の原因となったイベントに関する追加情報が格納されます。
pszFileLPWSTR8/4+32+16ネットワーク共有違反が発生したファイル名です。このメンバーは CDN_SHAREVIOLATION 通知メッセージの場合にのみ有効です。

公式ドキュメント

Open または Save As ダイアログボックスの OFNHookProc フック プロシージャに送信される WM_NOTIFY メッセージに関する情報を格納します。WM_NOTIFY メッセージの lParam パラメーターは、OFNOTIFY 構造体へのポインターです。

解説(Remarks)

すべての Open および Save As 通知メッセージが OFNOTIFY 構造体を使用するわけではありません。CDN_INCLUDEITEM 通知メッセージは OFNOTIFYEX 構造体を使用します。

メモ

commdlg.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして OFNOTIFY を定義します。エンコード中立のエイリアスと、エンコード中立でないコードを混在させると、コンパイル エラーや実行時エラーにつながる不一致が生じる可能性があります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

// NMHDR  (x64 24 / x86 12 バイト)
typedef struct NMHDR {
    HWND hwndFrom;
    UINT_PTR idFrom;
    DWORD code;
} NMHDR;

// OFNOTIFYW  (x64 40 / x86 20 バイト)
#pragma pack(push, 1)
typedef struct OFNOTIFYW {
    NMHDR hdr;
    OPENFILENAMEW* lpOFN;
    LPWSTR pszFile;
} OFNOTIFYW;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NMHDR
{
    public IntPtr hwndFrom;
    public UIntPtr idFrom;
    public uint code;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct OFNOTIFYW
{
    public NMHDR hdr;
    public IntPtr lpOFN;
    public IntPtr pszFile;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NMHDR
    Public hwndFrom As IntPtr
    Public idFrom As UIntPtr
    Public code As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure OFNOTIFYW
    Public hdr As NMHDR
    Public lpOFN As IntPtr
    Public pszFile As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class NMHDR(ctypes.Structure):
    _fields_ = [
        ("hwndFrom", ctypes.c_void_p),
        ("idFrom", ctypes.c_size_t),
        ("code", wintypes.DWORD),
    ]

class OFNOTIFYW(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("hdr", NMHDR),
        ("lpOFN", ctypes.c_void_p),
        ("pszFile", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct NMHDR {
    pub hwndFrom: *mut core::ffi::c_void,
    pub idFrom: usize,
    pub code: u32,
}

#[repr(C, packed(1))]
pub struct OFNOTIFYW {
    pub hdr: NMHDR,
    pub lpOFN: *mut core::ffi::c_void,
    pub pszFile: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type NMHDR struct {
	hwndFrom uintptr
	idFrom uintptr
	code uint32
}

type OFNOTIFYW struct {
	hdr NMHDR
	lpOFN uintptr
	pszFile uintptr
}
type
  NMHDR = record
    hwndFrom: Pointer;
    idFrom: NativeUInt;
    code: DWORD;
  end;

  OFNOTIFYW = packed record
    hdr: NMHDR;
    lpOFN: Pointer;
    pszFile: Pointer;
  end;
const NMHDR = extern struct {
    hwndFrom: ?*anyopaque,
    idFrom: usize,
    code: u32,
};

const OFNOTIFYW = extern struct {
    hdr: NMHDR,
    lpOFN: ?*anyopaque,
    pszFile: ?*anyopaque,
};
type
  NMHDR {.bycopy.} = object
    hwndFrom: pointer
    idFrom: uint
    code: uint32

  OFNOTIFYW {.packed.} = object
    hdr: NMHDR
    lpOFN: pointer
    pszFile: pointer
struct NMHDR
{
    void* hwndFrom;
    size_t idFrom;
    uint code;
}

align(1)
struct OFNOTIFYW
{
    NMHDR hdr;
    void* lpOFN;
    void* pszFile;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; OFNOTIFYW サイズ: 20 バイト(x86)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; hdr : NMHDR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; lpOFN : OPENFILENAMEW* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; pszFile : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; OFNOTIFYW サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; hdr : NMHDR (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; lpOFN : OPENFILENAMEW* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; pszFile : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global NMHDR
    #field intptr hwndFrom
    #field intptr idFrom
    #field int code
#endstruct

#defstruct global OFNOTIFYW, pack=1
    #field NMHDR hdr
    #field intptr lpOFN
    #field intptr pszFile
#endstruct

stdim st, OFNOTIFYW        ; NSTRUCT 変数を確保