ホーム › Media.Multimedia › DrawDibChangePalette

DrawDibChangePalette

関数

DrawDibのパレットエントリを変更する。

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

シグネチャ

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

BOOL DrawDibChangePalette(
    INT_PTR hdd,
    INT iStart,
    INT iLen,
    PALETTEENTRY* lppe
);

パラメーター

名前	型	方向	説明
hdd	INT_PTR	in	DrawDib DC のハンドルです。
iStart	INT	in	開始パレットエントリ番号です。
iLen	INT	in	パレットエントリの数です。
lppe	PALETTEENTRY*	in	パレットエントリの配列へのポインターです。

戻り値の型: BOOL

公式ドキュメント

DrawDibChangePalette 関数は、DIB の描画に使用するパレットエントリを設定します。

戻り値

成功した場合は TRUE を、それ以外の場合は FALSE を返します。

解説(Remarks)

この関数は、DrawDibRealize 関数の呼び出しによって現在の DrawDib パレットが実現されている場合にのみ、物理パレットを変更します。

カラーテーブルが変更されない場合、DDF_SAME_DRAW を指定せずに次に DrawDibDraw 関数を呼び出すと、暗黙的に DrawDibBegin 関数が呼び出されます。

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

各言語での呼び出し定義

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

BOOL DrawDibChangePalette(
    INT_PTR hdd,
    INT iStart,
    INT iLen,
    PALETTEENTRY* lppe
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll", ExactSpelling = true)]
static extern bool DrawDibChangePalette(
    IntPtr hdd,   // INT_PTR
    int iStart,   // INT
    int iLen,   // INT
    IntPtr lppe   // PALETTEENTRY*
);

<DllImport("MSVFW32.dll", ExactSpelling:=True)>
Public Shared Function DrawDibChangePalette(
    hdd As IntPtr,   ' INT_PTR
    iStart As Integer,   ' INT
    iLen As Integer,   ' INT
    lppe As IntPtr   ' PALETTEENTRY*
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' hdd : INT_PTR
' iStart : INT
' iLen : INT
' lppe : PALETTEENTRY*
Declare PtrSafe Function DrawDibChangePalette Lib "msvfw32" ( _
    ByVal hdd As LongPtr, _
    ByVal iStart As Long, _
    ByVal iLen As Long, _
    ByVal lppe As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DrawDibChangePalette = ctypes.windll.msvfw32.DrawDibChangePalette
DrawDibChangePalette.restype = wintypes.BOOL
DrawDibChangePalette.argtypes = [
    ctypes.c_ssize_t,  # hdd : INT_PTR
    ctypes.c_int,  # iStart : INT
    ctypes.c_int,  # iLen : INT
    ctypes.c_void_p,  # lppe : PALETTEENTRY*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MSVFW32.dll')
DrawDibChangePalette = Fiddle::Function.new(
  lib['DrawDibChangePalette'],
  [
    Fiddle::TYPE_INTPTR_T,  # hdd : INT_PTR
    Fiddle::TYPE_INT,  # iStart : INT
    Fiddle::TYPE_INT,  # iLen : INT
    Fiddle::TYPE_VOIDP,  # lppe : PALETTEENTRY*
  ],
  Fiddle::TYPE_INT)

#[link(name = "msvfw32")]
extern "system" {
    fn DrawDibChangePalette(
        hdd: isize,  // INT_PTR
        iStart: i32,  // INT
        iLen: i32,  // INT
        lppe: *mut PALETTEENTRY  // PALETTEENTRY*
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll")]
public static extern bool DrawDibChangePalette(IntPtr hdd, int iStart, int iLen, IntPtr lppe);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSVFW32_DrawDibChangePalette' -Namespace Win32 -PassThru
# $api::DrawDibChangePalette(hdd, iStart, iLen, lppe)

#uselib "MSVFW32.dll"
#func global DrawDibChangePalette "DrawDibChangePalette" sptr, sptr, sptr, sptr
; DrawDibChangePalette hdd, iStart, iLen, varptr(lppe)   ; 戻り値は stat
; hdd : INT_PTR -> "sptr"
; iStart : INT -> "sptr"
; iLen : INT -> "sptr"
; lppe : PALETTEENTRY* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MSVFW32.dll"
#cfunc global DrawDibChangePalette "DrawDibChangePalette" sptr, int, int, var
; res = DrawDibChangePalette(hdd, iStart, iLen, lppe)
; hdd : INT_PTR -> "sptr"
; iStart : INT -> "int"
; iLen : INT -> "int"
; lppe : PALETTEENTRY* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MSVFW32.dll"
#cfunc global DrawDibChangePalette "DrawDibChangePalette" sptr, int, int, sptr
; res = DrawDibChangePalette(hdd, iStart, iLen, varptr(lppe))
; hdd : INT_PTR -> "sptr"
; iStart : INT -> "int"
; iLen : INT -> "int"
; lppe : PALETTEENTRY* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。