ホーム › UI.Controls › GetThemePropertyOrigin

GetThemePropertyOrigin

関数

指定テーマプロパティの定義元(由来)を取得する。

DLLUXTHEME.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

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

HRESULT GetThemePropertyOrigin(
    HTHEME hTheme,
    INT iPartId,
    INT iStateId,
    INT iPropId,
    PROPERTYORIGIN* pOrigin
);

パラメーター

名前	型	方向	説明
hTheme	HTHEME	in	ウィンドウの指定されたテーマデータへのハンドルです。HTHEME を作成するには OpenThemeData を使用します。
iPartId	INT	in	テーマを含むパーツを指定する int 型の値です。Parts and States を参照してください。
iStateId	INT	in	パーツの状態を指定する int 型の値です。Parts and States を参照してください。
iPropId	INT	in	取得するプロパティを指定する int 型の値です。Vssym32.h のプロパティ値のいずれかを使用できます。これらの値は、それらを使用する関数のリファレンスページで説明されています。たとえば、GetThemeInt 関数は TMT_BORDERSIZE 値を使用します。関数の一覧については Visual Styles Reference を参照してください。
pOrigin	PROPERTYORIGIN*	out	プロパティが見つかった場所、または見つからなかったことを示す PROPERTYORIGIN 列挙型へのポインターです。

戻り値の型: HRESULT

公式ドキュメント

プロパティのテーマプロパティ定義の場所を取得します。

戻り値

型: HRESULT

この関数が成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

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

各言語での呼び出し定義

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

HRESULT GetThemePropertyOrigin(
    HTHEME hTheme,
    INT iPartId,
    INT iStateId,
    INT iPropId,
    PROPERTYORIGIN* pOrigin
);

[DllImport("UXTHEME.dll", ExactSpelling = true)]
static extern int GetThemePropertyOrigin(
    IntPtr hTheme,   // HTHEME
    int iPartId,   // INT
    int iStateId,   // INT
    int iPropId,   // INT
    out int pOrigin   // PROPERTYORIGIN* out
);

<DllImport("UXTHEME.dll", ExactSpelling:=True)>
Public Shared Function GetThemePropertyOrigin(
    hTheme As IntPtr,   ' HTHEME
    iPartId As Integer,   ' INT
    iStateId As Integer,   ' INT
    iPropId As Integer,   ' INT
    <Out> ByRef pOrigin As Integer   ' PROPERTYORIGIN* out
) As Integer
End Function

' hTheme : HTHEME
' iPartId : INT
' iStateId : INT
' iPropId : INT
' pOrigin : PROPERTYORIGIN* out
Declare PtrSafe Function GetThemePropertyOrigin Lib "uxtheme" ( _
    ByVal hTheme As LongPtr, _
    ByVal iPartId As Long, _
    ByVal iStateId As Long, _
    ByVal iPropId As Long, _
    ByRef pOrigin As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

GetThemePropertyOrigin = ctypes.windll.uxtheme.GetThemePropertyOrigin
GetThemePropertyOrigin.restype = ctypes.c_int
GetThemePropertyOrigin.argtypes = [
    ctypes.c_ssize_t,  # hTheme : HTHEME
    ctypes.c_int,  # iPartId : INT
    ctypes.c_int,  # iStateId : INT
    ctypes.c_int,  # iPropId : INT
    ctypes.c_void_p,  # pOrigin : PROPERTYORIGIN* out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('UXTHEME.dll')
GetThemePropertyOrigin = Fiddle::Function.new(
  lib['GetThemePropertyOrigin'],
  [
    Fiddle::TYPE_INTPTR_T,  # hTheme : HTHEME
    Fiddle::TYPE_INT,  # iPartId : INT
    Fiddle::TYPE_INT,  # iStateId : INT
    Fiddle::TYPE_INT,  # iPropId : INT
    Fiddle::TYPE_VOIDP,  # pOrigin : PROPERTYORIGIN* out
  ],
  Fiddle::TYPE_INT)

#[link(name = "uxtheme")]
extern "system" {
    fn GetThemePropertyOrigin(
        hTheme: isize,  // HTHEME
        iPartId: i32,  // INT
        iStateId: i32,  // INT
        iPropId: i32,  // INT
        pOrigin: *mut i32  // PROPERTYORIGIN* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("UXTHEME.dll")]
public static extern int GetThemePropertyOrigin(IntPtr hTheme, int iPartId, int iStateId, int iPropId, out int pOrigin);
"@
$api = Add-Type -MemberDefinition $sig -Name 'UXTHEME_GetThemePropertyOrigin' -Namespace Win32 -PassThru
# $api::GetThemePropertyOrigin(hTheme, iPartId, iStateId, iPropId, pOrigin)

#uselib "UXTHEME.dll"
#func global GetThemePropertyOrigin "GetThemePropertyOrigin" sptr, sptr, sptr, sptr, sptr
; GetThemePropertyOrigin hTheme, iPartId, iStateId, iPropId, varptr(pOrigin)   ; 戻り値は stat
; hTheme : HTHEME -> "sptr"
; iPartId : INT -> "sptr"
; iStateId : INT -> "sptr"
; iPropId : INT -> "sptr"
; pOrigin : PROPERTYORIGIN* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "UXTHEME.dll"
#cfunc global GetThemePropertyOrigin "GetThemePropertyOrigin" sptr, int, int, int, var
; res = GetThemePropertyOrigin(hTheme, iPartId, iStateId, iPropId, pOrigin)
; hTheme : HTHEME -> "sptr"
; iPartId : INT -> "int"
; iStateId : INT -> "int"
; iPropId : INT -> "int"
; pOrigin : PROPERTYORIGIN* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "UXTHEME.dll"
#cfunc global GetThemePropertyOrigin "GetThemePropertyOrigin" sptr, int, int, int, sptr
; res = GetThemePropertyOrigin(hTheme, iPartId, iStateId, iPropId, varptr(pOrigin))
; hTheme : HTHEME -> "sptr"
; iPartId : INT -> "int"
; iStateId : INT -> "int"
; iPropId : INT -> "int"
; pOrigin : PROPERTYORIGIN* out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。