GetThemePosition

関数

指定プロパティのテーマ位置(POINT)を取得する。

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

シグネチャ

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

HRESULT GetThemePosition(
    HTHEME hTheme,
    INT iPartId,
    INT iStateId,
    INT iPropId,
    POINT* pPoint
);

パラメーター

名前	型	方向	説明
hTheme	HTHEME	in	ウィンドウの指定されたテーマデータへのハンドル。HTHEME を作成するには OpenThemeData を使用します。
iPartId	INT	in	位置プロパティを含むパーツを指定する int 型の値。Parts and States を参照してください。
iStateId	INT	in	パーツの状態を指定する int 型の値。Parts and States を参照してください。
iPropId	INT	in	取得するプロパティを指定する int 型の値。指定可能な値の一覧については、Property Identifiers を参照してください。
pPoint	POINT*	out	位置の値を受け取る POINT 構造体へのポインター。

戻り値の型: HRESULT

公式ドキュメント

位置プロパティの値を取得します。

戻り値

型: HRESULT

この関数が成功すると、S_OK を返します。失敗した場合は、HRESULT エラーコードを返します。

解説(Remarks)

位置が存在するパーツによって、取り得る状態値が決まります。たとえば、位置がチェックボックス内にある場合、状態はチェック済みまたは未チェックになりますが、キャプション内の場合、取り得る状態はアクティブ、非アクティブ、または無効です。

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

各言語での呼び出し定義

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

HRESULT GetThemePosition(
    HTHEME hTheme,
    INT iPartId,
    INT iStateId,
    INT iPropId,
    POINT* pPoint
);

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

<DllImport("UXTHEME.dll", ExactSpelling:=True)>
Public Shared Function GetThemePosition(
    hTheme As IntPtr,   ' HTHEME
    iPartId As Integer,   ' INT
    iStateId As Integer,   ' INT
    iPropId As Integer,   ' INT
    pPoint As IntPtr   ' POINT* out
) As Integer
End Function

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

import ctypes
from ctypes import wintypes

GetThemePosition = ctypes.windll.uxtheme.GetThemePosition
GetThemePosition.restype = ctypes.c_int
GetThemePosition.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,  # pPoint : POINT* out
]

require 'fiddle'
require 'fiddle/import'

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

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

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

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

出力引数:

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