ホーム › Graphics.GdiPlus › GdipRecordMetafileFileName
GdipRecordMetafileFileName
関数ファイル名を指定して描画記録用メタファイルを作成する。
シグネチャ
// gdiplus.dll
#include <windows.h>
Status GdipRecordMetafileFileName(
LPCWSTR fileName,
HDC referenceHdc,
EmfType type,
const RectF* frameRect,
MetafileFrameUnit frameUnit,
LPCWSTR description,
GpMetafile** metafile
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| fileName | LPCWSTR | in | 記録先メタファイルのパスを示すワイド文字列(LPWSTR)。 |
| referenceHdc | HDC | in | 解像度や単位の基準とするデバイスコンテキストハンドル(HDC)。 |
| type | EmfType | in | 記録するメタファイルの種類を示すEmfType列挙値。 |
| frameRect | RectF* | in | メタファイルの境界枠矩形(RectF)へのポインタ。NULL可。 |
| frameUnit | MetafileFrameUnit | in | frameRectの座標単位を示すMetafileFrameUnit列挙値。 |
| description | LPCWSTR | in | メタファイルに埋め込む説明文字列(LPWSTR)。NULL可。 |
| metafile | GpMetafile** | inout | 生成した記録用メタファイルオブジェクトを受け取るポインタのポインタ(出力)。 |
戻り値の型: Status
各言語での呼び出し定義
// gdiplus.dll
#include <windows.h>
Status GdipRecordMetafileFileName(
LPCWSTR fileName,
HDC referenceHdc,
EmfType type,
const RectF* frameRect,
MetafileFrameUnit frameUnit,
LPCWSTR description,
GpMetafile** metafile
);[DllImport("gdiplus.dll", ExactSpelling = true)]
static extern int GdipRecordMetafileFileName(
[MarshalAs(UnmanagedType.LPWStr)] string fileName, // LPCWSTR
IntPtr referenceHdc, // HDC
int type, // EmfType
IntPtr frameRect, // RectF*
int frameUnit, // MetafileFrameUnit
[MarshalAs(UnmanagedType.LPWStr)] string description, // LPCWSTR
IntPtr metafile // GpMetafile** in/out
);<DllImport("gdiplus.dll", ExactSpelling:=True)>
Public Shared Function GdipRecordMetafileFileName(
<MarshalAs(UnmanagedType.LPWStr)> fileName As String, ' LPCWSTR
referenceHdc As IntPtr, ' HDC
type As Integer, ' EmfType
frameRect As IntPtr, ' RectF*
frameUnit As Integer, ' MetafileFrameUnit
<MarshalAs(UnmanagedType.LPWStr)> description As String, ' LPCWSTR
metafile As IntPtr ' GpMetafile** in/out
) As Integer
End Function' fileName : LPCWSTR
' referenceHdc : HDC
' type : EmfType
' frameRect : RectF*
' frameUnit : MetafileFrameUnit
' description : LPCWSTR
' metafile : GpMetafile** in/out
Declare PtrSafe Function GdipRecordMetafileFileName Lib "gdiplus" ( _
ByVal fileName As LongPtr, _
ByVal referenceHdc As LongPtr, _
ByVal type As Long, _
ByVal frameRect As LongPtr, _
ByVal frameUnit As Long, _
ByVal description As LongPtr, _
ByVal metafile As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
GdipRecordMetafileFileName = ctypes.windll.gdiplus.GdipRecordMetafileFileName
GdipRecordMetafileFileName.restype = ctypes.c_int
GdipRecordMetafileFileName.argtypes = [
wintypes.LPCWSTR, # fileName : LPCWSTR
wintypes.HANDLE, # referenceHdc : HDC
ctypes.c_int, # type : EmfType
ctypes.c_void_p, # frameRect : RectF*
ctypes.c_int, # frameUnit : MetafileFrameUnit
wintypes.LPCWSTR, # description : LPCWSTR
ctypes.c_void_p, # metafile : GpMetafile** in/out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('gdiplus.dll')
GdipRecordMetafileFileName = Fiddle::Function.new(
lib['GdipRecordMetafileFileName'],
[
Fiddle::TYPE_VOIDP, # fileName : LPCWSTR
Fiddle::TYPE_VOIDP, # referenceHdc : HDC
Fiddle::TYPE_INT, # type : EmfType
Fiddle::TYPE_VOIDP, # frameRect : RectF*
Fiddle::TYPE_INT, # frameUnit : MetafileFrameUnit
Fiddle::TYPE_VOIDP, # description : LPCWSTR
Fiddle::TYPE_VOIDP, # metafile : GpMetafile** in/out
],
Fiddle::TYPE_INT)#[link(name = "gdiplus")]
extern "system" {
fn GdipRecordMetafileFileName(
fileName: *const u16, // LPCWSTR
referenceHdc: *mut core::ffi::c_void, // HDC
type: i32, // EmfType
frameRect: *const RectF, // RectF*
frameUnit: i32, // MetafileFrameUnit
description: *const u16, // LPCWSTR
metafile: *mut *mut GpMetafile // GpMetafile** in/out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("gdiplus.dll")]
public static extern int GdipRecordMetafileFileName([MarshalAs(UnmanagedType.LPWStr)] string fileName, IntPtr referenceHdc, int type, IntPtr frameRect, int frameUnit, [MarshalAs(UnmanagedType.LPWStr)] string description, IntPtr metafile);
"@
$api = Add-Type -MemberDefinition $sig -Name 'gdiplus_GdipRecordMetafileFileName' -Namespace Win32 -PassThru
# $api::GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)#uselib "gdiplus.dll"
#func global GdipRecordMetafileFileName "GdipRecordMetafileFileName" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; GdipRecordMetafileFileName fileName, referenceHdc, type, varptr(frameRect), frameUnit, description, varptr(metafile) ; 戻り値は stat
; fileName : LPCWSTR -> "sptr"
; referenceHdc : HDC -> "sptr"
; type : EmfType -> "sptr"
; frameRect : RectF* -> "sptr"
; frameUnit : MetafileFrameUnit -> "sptr"
; description : LPCWSTR -> "sptr"
; metafile : GpMetafile** in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "gdiplus.dll" #cfunc global GdipRecordMetafileFileName "GdipRecordMetafileFileName" wstr, sptr, int, var, int, wstr, var ; res = GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile) ; fileName : LPCWSTR -> "wstr" ; referenceHdc : HDC -> "sptr" ; type : EmfType -> "int" ; frameRect : RectF* -> "var" ; frameUnit : MetafileFrameUnit -> "int" ; description : LPCWSTR -> "wstr" ; metafile : GpMetafile** in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "gdiplus.dll" #cfunc global GdipRecordMetafileFileName "GdipRecordMetafileFileName" wstr, sptr, int, sptr, int, wstr, sptr ; res = GdipRecordMetafileFileName(fileName, referenceHdc, type, varptr(frameRect), frameUnit, description, varptr(metafile)) ; fileName : LPCWSTR -> "wstr" ; referenceHdc : HDC -> "sptr" ; type : EmfType -> "int" ; frameRect : RectF* -> "sptr" ; frameUnit : MetafileFrameUnit -> "int" ; description : LPCWSTR -> "wstr" ; metafile : GpMetafile** in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; Status GdipRecordMetafileFileName(LPCWSTR fileName, HDC referenceHdc, EmfType type, RectF* frameRect, MetafileFrameUnit frameUnit, LPCWSTR description, GpMetafile** metafile) #uselib "gdiplus.dll" #cfunc global GdipRecordMetafileFileName "GdipRecordMetafileFileName" wstr, intptr, int, var, int, wstr, var ; res = GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile) ; fileName : LPCWSTR -> "wstr" ; referenceHdc : HDC -> "intptr" ; type : EmfType -> "int" ; frameRect : RectF* -> "var" ; frameUnit : MetafileFrameUnit -> "int" ; description : LPCWSTR -> "wstr" ; metafile : GpMetafile** in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; Status GdipRecordMetafileFileName(LPCWSTR fileName, HDC referenceHdc, EmfType type, RectF* frameRect, MetafileFrameUnit frameUnit, LPCWSTR description, GpMetafile** metafile) #uselib "gdiplus.dll" #cfunc global GdipRecordMetafileFileName "GdipRecordMetafileFileName" wstr, intptr, int, intptr, int, wstr, intptr ; res = GdipRecordMetafileFileName(fileName, referenceHdc, type, varptr(frameRect), frameUnit, description, varptr(metafile)) ; fileName : LPCWSTR -> "wstr" ; referenceHdc : HDC -> "intptr" ; type : EmfType -> "int" ; frameRect : RectF* -> "intptr" ; frameUnit : MetafileFrameUnit -> "int" ; description : LPCWSTR -> "wstr" ; metafile : GpMetafile** in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
gdiplus = windows.NewLazySystemDLL("gdiplus.dll")
procGdipRecordMetafileFileName = gdiplus.NewProc("GdipRecordMetafileFileName")
)
// fileName (LPCWSTR), referenceHdc (HDC), type (EmfType), frameRect (RectF*), frameUnit (MetafileFrameUnit), description (LPCWSTR), metafile (GpMetafile** in/out)
r1, _, err := procGdipRecordMetafileFileName.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(fileName))),
uintptr(referenceHdc),
uintptr(type),
uintptr(frameRect),
uintptr(frameUnit),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(description))),
uintptr(metafile),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // Statusfunction GdipRecordMetafileFileName(
fileName: PWideChar; // LPCWSTR
referenceHdc: THandle; // HDC
type: Integer; // EmfType
frameRect: Pointer; // RectF*
frameUnit: Integer; // MetafileFrameUnit
description: PWideChar; // LPCWSTR
metafile: Pointer // GpMetafile** in/out
): Integer; stdcall;
external 'gdiplus.dll' name 'GdipRecordMetafileFileName';result := DllCall("gdiplus\GdipRecordMetafileFileName"
, "WStr", fileName ; LPCWSTR
, "Ptr", referenceHdc ; HDC
, "Int", type ; EmfType
, "Ptr", frameRect ; RectF*
, "Int", frameUnit ; MetafileFrameUnit
, "WStr", description ; LPCWSTR
, "Ptr", metafile ; GpMetafile** in/out
, "Int") ; return: Status●GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile) = DLL("gdiplus.dll", "int GdipRecordMetafileFileName(char*, void*, int, void*, int, char*, void*)")
# 呼び出し: GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)
# fileName : LPCWSTR -> "char*"
# referenceHdc : HDC -> "void*"
# type : EmfType -> "int"
# frameRect : RectF* -> "void*"
# frameUnit : MetafileFrameUnit -> "int"
# description : LPCWSTR -> "char*"
# metafile : GpMetafile** in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "gdiplus" fn GdipRecordMetafileFileName(
fileName: [*c]const u16, // LPCWSTR
referenceHdc: ?*anyopaque, // HDC
type: i32, // EmfType
frameRect: [*c]RectF, // RectF*
frameUnit: i32, // MetafileFrameUnit
description: [*c]const u16, // LPCWSTR
metafile: [*c][*c]GpMetafile // GpMetafile** in/out
) callconv(std.os.windows.WINAPI) i32;proc GdipRecordMetafileFileName(
fileName: WideCString, # LPCWSTR
referenceHdc: pointer, # HDC
`type`: int32, # EmfType
frameRect: ptr RectF, # RectF*
frameUnit: int32, # MetafileFrameUnit
description: WideCString, # LPCWSTR
metafile: ptr GpMetafile # GpMetafile** in/out
): int32 {.importc: "GdipRecordMetafileFileName", stdcall, dynlib: "gdiplus.dll".}pragma(lib, "gdiplus");
extern(Windows)
int GdipRecordMetafileFileName(
const(wchar)* fileName, // LPCWSTR
void* referenceHdc, // HDC
int type, // EmfType
RectF* frameRect, // RectF*
int frameUnit, // MetafileFrameUnit
const(wchar)* description, // LPCWSTR
GpMetafile** metafile // GpMetafile** in/out
);ccall((:GdipRecordMetafileFileName, "gdiplus.dll"), stdcall, Int32,
(Cwstring, Ptr{Cvoid}, Int32, Ptr{RectF}, Int32, Cwstring, Ptr{GpMetafile}),
fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)
# fileName : LPCWSTR -> Cwstring
# referenceHdc : HDC -> Ptr{Cvoid}
# type : EmfType -> Int32
# frameRect : RectF* -> Ptr{RectF}
# frameUnit : MetafileFrameUnit -> Int32
# description : LPCWSTR -> Cwstring
# metafile : GpMetafile** in/out -> Ptr{GpMetafile}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t GdipRecordMetafileFileName(
const uint16_t* fileName,
void* referenceHdc,
int32_t type,
void* frameRect,
int32_t frameUnit,
const uint16_t* description,
void* metafile);
]]
local gdiplus = ffi.load("gdiplus")
-- gdiplus.GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)
-- fileName : LPCWSTR
-- referenceHdc : HDC
-- type : EmfType
-- frameRect : RectF*
-- frameUnit : MetafileFrameUnit
-- description : LPCWSTR
-- metafile : GpMetafile** in/out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('gdiplus.dll');
const GdipRecordMetafileFileName = lib.func('__stdcall', 'GdipRecordMetafileFileName', 'int32_t', ['str16', 'void *', 'int32_t', 'void *', 'int32_t', 'str16', 'void *']);
// GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)
// fileName : LPCWSTR -> 'str16'
// referenceHdc : HDC -> 'void *'
// type : EmfType -> 'int32_t'
// frameRect : RectF* -> 'void *'
// frameUnit : MetafileFrameUnit -> 'int32_t'
// description : LPCWSTR -> 'str16'
// metafile : GpMetafile** in/out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("gdiplus.dll", {
GdipRecordMetafileFileName: { parameters: ["buffer", "pointer", "i32", "pointer", "i32", "buffer", "pointer"], result: "i32" },
});
// lib.symbols.GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile)
// fileName : LPCWSTR -> "buffer"
// referenceHdc : HDC -> "pointer"
// type : EmfType -> "i32"
// frameRect : RectF* -> "pointer"
// frameUnit : MetafileFrameUnit -> "i32"
// description : LPCWSTR -> "buffer"
// metafile : GpMetafile** in/out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t GdipRecordMetafileFileName(
const uint16_t* fileName,
void* referenceHdc,
int32_t type,
void* frameRect,
int32_t frameUnit,
const uint16_t* description,
void* metafile);
C, "gdiplus.dll");
// $ffi->GdipRecordMetafileFileName(fileName, referenceHdc, type, frameRect, frameUnit, description, metafile);
// fileName : LPCWSTR
// referenceHdc : HDC
// type : EmfType
// frameRect : RectF*
// frameUnit : MetafileFrameUnit
// description : LPCWSTR
// metafile : GpMetafile** in/out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Gdiplus extends StdCallLibrary {
Gdiplus INSTANCE = Native.load("gdiplus", Gdiplus.class);
int GdipRecordMetafileFileName(
WString fileName, // LPCWSTR
Pointer referenceHdc, // HDC
int type, // EmfType
Pointer frameRect, // RectF*
int frameUnit, // MetafileFrameUnit
WString description, // LPCWSTR
Pointer metafile // GpMetafile** in/out
);
}@[Link("gdiplus")]
lib Libgdiplus
fun GdipRecordMetafileFileName = GdipRecordMetafileFileName(
fileName : UInt16*, # LPCWSTR
referenceHdc : Void*, # HDC
type_ : Int32, # EmfType
frameRect : RectF*, # RectF*
frameUnit : Int32, # MetafileFrameUnit
description : UInt16*, # LPCWSTR
metafile : GpMetafile** # GpMetafile** in/out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef GdipRecordMetafileFileNameNative = Int32 Function(Pointer<Utf16>, Pointer<Void>, Int32, Pointer<Void>, Int32, Pointer<Utf16>, Pointer<Void>);
typedef GdipRecordMetafileFileNameDart = int Function(Pointer<Utf16>, Pointer<Void>, int, Pointer<Void>, int, Pointer<Utf16>, Pointer<Void>);
final GdipRecordMetafileFileName = DynamicLibrary.open('gdiplus.dll')
.lookupFunction<GdipRecordMetafileFileNameNative, GdipRecordMetafileFileNameDart>('GdipRecordMetafileFileName');
// fileName : LPCWSTR -> Pointer<Utf16>
// referenceHdc : HDC -> Pointer<Void>
// type : EmfType -> Int32
// frameRect : RectF* -> Pointer<Void>
// frameUnit : MetafileFrameUnit -> Int32
// description : LPCWSTR -> Pointer<Utf16>
// metafile : GpMetafile** in/out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function GdipRecordMetafileFileName(
fileName: PWideChar; // LPCWSTR
referenceHdc: THandle; // HDC
type: Integer; // EmfType
frameRect: Pointer; // RectF*
frameUnit: Integer; // MetafileFrameUnit
description: PWideChar; // LPCWSTR
metafile: Pointer // GpMetafile** in/out
): Integer; stdcall;
external 'gdiplus.dll' name 'GdipRecordMetafileFileName';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "GdipRecordMetafileFileName"
c_GdipRecordMetafileFileName :: CWString -> Ptr () -> Int32 -> Ptr () -> Int32 -> CWString -> Ptr () -> IO Int32
-- fileName : LPCWSTR -> CWString
-- referenceHdc : HDC -> Ptr ()
-- type : EmfType -> Int32
-- frameRect : RectF* -> Ptr ()
-- frameUnit : MetafileFrameUnit -> Int32
-- description : LPCWSTR -> CWString
-- metafile : GpMetafile** in/out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let gdiprecordmetafilefilename =
foreign "GdipRecordMetafileFileName"
((ptr uint16_t) @-> (ptr void) @-> int32_t @-> (ptr void) @-> int32_t @-> (ptr uint16_t) @-> (ptr void) @-> returning int32_t)
(* fileName : LPCWSTR -> (ptr uint16_t) *)
(* referenceHdc : HDC -> (ptr void) *)
(* type : EmfType -> int32_t *)
(* frameRect : RectF* -> (ptr void) *)
(* frameUnit : MetafileFrameUnit -> int32_t *)
(* description : LPCWSTR -> (ptr uint16_t) *)
(* metafile : GpMetafile** in/out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library gdiplus (t "gdiplus.dll"))
(cffi:use-foreign-library gdiplus)
(cffi:defcfun ("GdipRecordMetafileFileName" gdip-record-metafile-file-name :convention :stdcall) :int32
(file-name (:string :encoding :utf-16le)) ; LPCWSTR
(reference-hdc :pointer) ; HDC
(type :int32) ; EmfType
(frame-rect :pointer) ; RectF*
(frame-unit :int32) ; MetafileFrameUnit
(description (:string :encoding :utf-16le)) ; LPCWSTR
(metafile :pointer)) ; GpMetafile** in/out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $GdipRecordMetafileFileName = Win32::API::More->new('gdiplus',
'int GdipRecordMetafileFileName(LPCWSTR fileName, HANDLE referenceHdc, int type, LPVOID frameRect, int frameUnit, LPCWSTR description, LPVOID metafile)');
# my $ret = $GdipRecordMetafileFileName->Call($fileName, $referenceHdc, $type, $frameRect, $frameUnit, $description, $metafile);
# fileName : LPCWSTR -> LPCWSTR
# referenceHdc : HDC -> HANDLE
# type : EmfType -> int
# frameRect : RectF* -> LPVOID
# frameUnit : MetafileFrameUnit -> int
# description : LPCWSTR -> LPCWSTR
# metafile : GpMetafile** in/out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。