Win32 API 日本語リファレンス
ホーム › System.Search › IInterval

IInterval

COM
📘 Microsoft Learn (日本語) · English
IID6bf0a714-3c18-430b-8b5d-83b1c234d3db継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

インターバル(区間)の限界値を取得するメソッドを提供します。

メソッド 1

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

vtbl 3 HRESULT GetLimits(INTERVAL_LIMIT_KIND* pilkLower, PROPVARIANT* ppropvarLower, INTERVAL_LIMIT_KIND* pilkUpper, PROPVARIANT* ppropvarUpper)

インターバルの下限と上限を指定します。それぞれ無限大または特定の値を取ることができます。

pilkLowerINTERVAL_LIMIT_KIND*outインターバルの下限が境界値を含むか、含まないか、あるいは無限かを示す INTERVAL_LIMIT_KIND 列挙型の値へのポインターを受け取ります。
ppropvarLowerPROPVARIANT*outインターバルの下限値へのポインターを受け取ります。pilkLower パラメーターに ILK_NEGATIVE_INFINITY または ILK_POSITIVE_INFINITY が設定されている場合、この値は VT_EMPTY に設定されます。
pilkUpperINTERVAL_LIMIT_KIND*outインターバルの上限が境界値を含むか、含まないか、あるいは無限かを示す INTERVAL_LIMIT_KIND 列挙型の値へのポインターを受け取ります。
ppropvarUpperPROPVARIANT*outインターバルの上限値へのポインターを受け取ります。pilkUpper パラメーターに ILK_NEGATIVE_INFINITY または ILK_POSITIVE_INFINITY が設定されている場合、この値は VT_EMPTY に設定されます。

戻り値

型: HRESULT

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

解説(Remarks)

このメソッドは、インターバルの限界値を 2 組の INTERVAL_LIMIT_KIND と PROPVARIANT のペアとして取得します。1 番目のペアはインターバルの下限を指定し、2 番目のペアはインターバルの上限を指定します。

下限は上限より小さくなければなりません。そうでない場合、インターバルは空になります。唯一の例外は、下限と上限が等しく、かつ両方に ILK_EXPLICIT_INCLUDED が設定されている場合です。この場合、範囲は両方の限界に設定された単一の値となります。次の表は、これらのペアがインターバルをどのように定義するかを示しています。

pilkLower ppropvarLower pilkLower ppropvarLower 説明
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_INCLUDED 3 3 が明示的に範囲に含まれるため、範囲内の最小値は 3 です。

範囲内の最大値も 3 (明示的に含まれる) であり、インターバルは数値 3 のみで構成されます。
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 3 範囲内の最小値は 3 (明示的に含まれる) ですが、上限も 3 であり、こちらは明示的に除外されます。したがって、記述されるインターバルは空のインターバルになります。
ILK_EXPLICIT_INCLUDED 3 ILK_EXPLICIT_EXCLUDED 6 整数のインターバルは 3 から始まり 3 を含み、6 で終わりますが 6 は含みません。
ILK_NEGATIVE_INFINITY VT_EMPTY ILK_POSITIVE_INFINITY VT_EMPTY すべての整数がインターバルに含まれます。
出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IInterval "{6BF0A714-3C18-430B-8B5D-83B1C234D3DB}"
#usecom global IInterval IID_IInterval "{D957171F-4BF9-4DE2-BCD5-C70A7CA55836}"
#comfunc global IInterval_GetLimits  3 var,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。