ホーム › UI.Shell › IVisualProperties

IVisualProperties

COM

📘 Microsoft Learn (日本語) · English

IIDe693cf68-d967-4112-8763-99172aee5e5a継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

視覚的なプロパティを設定および取得するメソッドを公開します。

メソッド 8

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetWatermark(HBITMAP hbmp, VPWATERMARKFLAGS vpwf)

ウォーターマークとして使用するビットマップを指定します。

hbmp	HBITMAP	in	ビットマップへのハンドル。
vpwf	VPWATERMARKFLAGS	in	ウォーターマークをカスタマイズする VPWATERMARKFLAGS フラグ。

戻り値

型: HRESULT

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

vtbl 4 HRESULT SetColor(VPCOLORFLAGS vpcf, COLORREF cr)

指定された色を設定します。

vpcf	VPCOLORFLAGS	in	カラーフラグ。VPCOLORFLAGS を参照してください。
cr	COLORREF	in	COLORREF 型の値。

戻り値

型: HRESULT

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

vtbl 5 HRESULT GetColor(VPCOLORFLAGS vpcf, COLORREF* pcr)

指定された色を取得します。

vpcf	VPCOLORFLAGS	in	カラーフラグ。VPCOLORFLAGS を参照してください。
pcr	COLORREF*	out	COLORREF 型の値へのポインター。

戻り値

型: HRESULT

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

vtbl 6 HRESULT SetItemHeight(INT cyItemInPixels)

指定された項目の高さを設定します。

cyItemInPixels

INT

項目の高さ(ピクセル単位)。

戻り値

型: HRESULT

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

vtbl 7 HRESULT GetItemHeight(INT* cyItemInPixels)

項目の高さを取得します。

cyItemInPixels

INT*

out

項目の高さ(ピクセル単位)へのポインター。

戻り値

型: HRESULT

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

vtbl 8 HRESULT SetFont(LOGFONTW* plf, BOOL bRedraw)

フォントの属性を設定します。

plf	LOGFONTW*	in	設定する属性を格納した LOGFONT 構造体へのポインター。
bRedraw	BOOL	in	新しい属性を設定した後に項目を再描画する場合は TRUE、それ以外の場合は FALSE。

戻り値

型: HRESULT

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

vtbl 9 HRESULT GetFont(LOGFONTW* plf)

フォントに現在設定されている属性を取得します。

plf

LOGFONTW*

out

このメソッドが正常に返されたときに、フォントの現在の属性を受け取る LOGFONT 構造体へのポインター。

戻り値

型: HRESULT

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

vtbl 10 HRESULT SetTheme(LPWSTR pszSubAppName, LPWSTR pszSubIdList)

指定されたテーマを設定します。

pszSubAppName	LPWSTR	in	呼び出し元アプリケーションの名前の代わりに使用するアプリケーション名を格納した Unicode 文字列へのポインター。このパラメーターが NULL の場合は、呼び出し元アプリケーションの名前が使用されます。
pszSubIdList	LPWSTR	in	ウィンドウのクラスによって渡される実際のリストの代わりに使用する、セミコロン区切りの CLSID 名リストを格納した Unicode 文字列へのポインター。このパラメーターが NULL の場合は、呼び出し元クラスの ID リストが使用されます。

戻り値

型: HRESULT

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

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

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_IVisualProperties "{E693CF68-D967-4112-8763-99172AEE5E5A}"
#usecom global IVisualProperties IID_IVisualProperties "{}"
#comfunc global IVisualProperties_SetWatermark   3 sptr,int
#comfunc global IVisualProperties_SetColor       4 int,int
#comfunc global IVisualProperties_GetColor       5 int,var
#comfunc global IVisualProperties_SetItemHeight  6 int
#comfunc global IVisualProperties_GetItemHeight  7 var
#comfunc global IVisualProperties_SetFont        8 var,int
#comfunc global IVisualProperties_GetFont        9 var
#comfunc global IVisualProperties_SetTheme       10 wstr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVisualProperties "{E693CF68-D967-4112-8763-99172AEE5E5A}"
#usecom global IVisualProperties IID_IVisualProperties "{}"
#comfunc global IVisualProperties_SetWatermark   3 sptr,int
#comfunc global IVisualProperties_SetColor       4 int,int
#comfunc global IVisualProperties_GetColor       5 int,sptr
#comfunc global IVisualProperties_SetItemHeight  6 int
#comfunc global IVisualProperties_GetItemHeight  7 sptr
#comfunc global IVisualProperties_SetFont        8 sptr,int
#comfunc global IVisualProperties_GetFont        9 sptr
#comfunc global IVisualProperties_SetTheme       10 wstr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。