ホーム › System.DataExchange › SetWinMetaFileBits

SetWinMetaFileBits

関数

16ビットメタファイルデータから拡張メタファイルを生成する。

DLLGDI32.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// GDI32.dll
#include <windows.h>

HENHMETAFILE SetWinMetaFileBits(
    DWORD nSize,
    const BYTE* lpMeta16Data,
    HDC hdcRef,   // optional
    const METAFILEPICT* lpMFP   // optional
);

パラメーター

名前	型	方向	説明
nSize	DWORD	in	Windows 形式のメタファイルを格納するバッファのサイズ(バイト単位)。
lpMeta16Data	BYTE*	in	Windows 形式のメタファイルデータを格納するバッファへのポインター。(データは GetMetaFileBitsEx または GetWinMetaFileBits 関数を使用して取得されたものと想定されます。)
hdcRef	HDC	inoptional	参照デバイスコンテキストへのハンドル。
lpMFP	METAFILEPICT*	inoptional	メタファイルピクチャの推奨サイズと、ピクチャ作成時に使用されたマッピングモードを格納する METAFILEPICT 構造体へのポインター。

戻り値の型: HENHMETAFILE

公式ドキュメント

SetWinMetaFileBits 関数は、メタファイルを古い Windows 形式から新しい拡張形式に変換し、その新しいメタファイルをメモリに格納します。

戻り値

関数が成功すると、戻り値はメモリベースの拡張メタファイルへのハンドルになります。

関数が失敗すると、戻り値は NULL になります。

解説(Remarks)

Windows は、参照デバイスコンテキストの解像度データと METAFILEPICT 構造体内のデータを使用してピクチャを拡大縮小します。hdcRef パラメーターが NULL の場合、システムは現在の出力デバイスの解像度データを使用します。lpmfp パラメーターが NULL の場合、システムは MM_ANISOTROPIC マッピングモードを使用して、ピクチャがデバイス表面全体に収まるように拡大縮小します。METAFILEPICT 構造体の hMF メンバーは使用されません。

アプリケーションが拡張メタファイルハンドルを必要としなくなったら、DeleteEnhMetaFile 関数を呼び出して削除してください。

この関数が返すハンドルは、他の拡張メタファイル関数で使用できます。

参照デバイスコンテキストが、メタファイルが元々作成されたデバイスと同一でない場合、デバイス単位を使用する一部の GDI 関数はピクチャを正しく描画できないことがあります。

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

各言語での呼び出し定義

// GDI32.dll
#include <windows.h>

HENHMETAFILE SetWinMetaFileBits(
    DWORD nSize,
    const BYTE* lpMeta16Data,
    HDC hdcRef,   // optional
    const METAFILEPICT* lpMFP   // optional
);

[DllImport("GDI32.dll", ExactSpelling = true)]
static extern IntPtr SetWinMetaFileBits(
    uint nSize,   // DWORD
    IntPtr lpMeta16Data,   // BYTE*
    IntPtr hdcRef,   // HDC optional
    IntPtr lpMFP   // METAFILEPICT* optional
);

<DllImport("GDI32.dll", ExactSpelling:=True)>
Public Shared Function SetWinMetaFileBits(
    nSize As UInteger,   ' DWORD
    lpMeta16Data As IntPtr,   ' BYTE*
    hdcRef As IntPtr,   ' HDC optional
    lpMFP As IntPtr   ' METAFILEPICT* optional
) As IntPtr
End Function

' nSize : DWORD
' lpMeta16Data : BYTE*
' hdcRef : HDC optional
' lpMFP : METAFILEPICT* optional
Declare PtrSafe Function SetWinMetaFileBits Lib "gdi32" ( _
    ByVal nSize As Long, _
    ByVal lpMeta16Data As LongPtr, _
    ByVal hdcRef As LongPtr, _
    ByVal lpMFP As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

SetWinMetaFileBits = ctypes.windll.gdi32.SetWinMetaFileBits
SetWinMetaFileBits.restype = ctypes.c_void_p
SetWinMetaFileBits.argtypes = [
    wintypes.DWORD,  # nSize : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # lpMeta16Data : BYTE*
    wintypes.HANDLE,  # hdcRef : HDC optional
    ctypes.c_void_p,  # lpMFP : METAFILEPICT* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('GDI32.dll')
SetWinMetaFileBits = Fiddle::Function.new(
  lib['SetWinMetaFileBits'],
  [
    -Fiddle::TYPE_INT,  # nSize : DWORD
    Fiddle::TYPE_VOIDP,  # lpMeta16Data : BYTE*
    Fiddle::TYPE_VOIDP,  # hdcRef : HDC optional
    Fiddle::TYPE_VOIDP,  # lpMFP : METAFILEPICT* optional
  ],
  Fiddle::TYPE_VOIDP)

#[link(name = "gdi32")]
extern "system" {
    fn SetWinMetaFileBits(
        nSize: u32,  // DWORD
        lpMeta16Data: *const u8,  // BYTE*
        hdcRef: *mut core::ffi::c_void,  // HDC optional
        lpMFP: *const METAFILEPICT  // METAFILEPICT* optional
    ) -> *mut core::ffi::c_void;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("GDI32.dll")]
public static extern IntPtr SetWinMetaFileBits(uint nSize, IntPtr lpMeta16Data, IntPtr hdcRef, IntPtr lpMFP);
"@
$api = Add-Type -MemberDefinition $sig -Name 'GDI32_SetWinMetaFileBits' -Namespace Win32 -PassThru
# $api::SetWinMetaFileBits(nSize, lpMeta16Data, hdcRef, lpMFP)

#uselib "GDI32.dll"
#func global SetWinMetaFileBits "SetWinMetaFileBits" sptr, sptr, sptr, sptr
; SetWinMetaFileBits nSize, varptr(lpMeta16Data), hdcRef, varptr(lpMFP)   ; 戻り値は stat
; nSize : DWORD -> "sptr"
; lpMeta16Data : BYTE* -> "sptr"
; hdcRef : HDC optional -> "sptr"
; lpMFP : METAFILEPICT* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "GDI32.dll"
#cfunc global SetWinMetaFileBits "SetWinMetaFileBits" int, var, sptr, var
; res = SetWinMetaFileBits(nSize, lpMeta16Data, hdcRef, lpMFP)
; nSize : DWORD -> "int"
; lpMeta16Data : BYTE* -> "var"
; hdcRef : HDC optional -> "sptr"
; lpMFP : METAFILEPICT* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "GDI32.dll"
#cfunc global SetWinMetaFileBits "SetWinMetaFileBits" int, sptr, sptr, sptr
; res = SetWinMetaFileBits(nSize, varptr(lpMeta16Data), hdcRef, varptr(lpMFP))
; nSize : DWORD -> "int"
; lpMeta16Data : BYTE* -> "sptr"
; hdcRef : HDC optional -> "sptr"
; lpMFP : METAFILEPICT* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。