IIterableConcept::GetDefaultIndexDimensionality メソッド (dbgmodel.h)
GetDefaultIndexDimensionality メソッドは、ディメンションの数を既定のインデックスに返します。 オブジェクトがインデックスを作成できない場合、このメソッドは 0 を返し、成功する必要があります (S_OK)。 このメソッドから 0 以外の値を返すオブジェクトは、次を示すプロトコル コントラクトのサポートを宣言しています。
- オブジェクトは、IIndexableConcept のサポートを介してインデックス可能な概念をサポートします
- Iterable 概念の GetIterator メソッドから返される IModelIterator の GetNext メソッドは、生成される各要素の一意の既定のインデックスを返します。 このようなインデックスには、ここに示すようにディメンションの数が含まれます。
- IModelIterator の GetNext メソッドから返されたインデックスを、インデックス可能な概念 (IIndexableConcept) の GetAt メソッドに渡すと、GetNext が生成したのと同じオブジェクトが参照されます。 同じ値が返されます。
構文
HRESULT GetDefaultIndexDimensionality(
IModelObject *contextObject,
ULONG64 *dimensionality
);
パラメーター
contextObject
クエリ対象のインスタンス (このポインター)。
dimensionality
ここでは、既定のインデクサーのディメンション数が返されます。 戻り値が 0 の場合、オブジェクトはインデックスを作成できません。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。
注釈
実装例:
IFACEMETHOD(GetDefaultIndexDimensionality)(_In_ IModelObject * /*pContextObject*/,
_Out_ ULONG64 *pDimensionality)
{
// If the object is not indexable, pDimensionality should be 0 and the
// method should return S_OK. Here, the object is indexable in one dimension.
// Providing this information requires that our iterator return these
// 1D indexes and that we have an indexer which accepts them.
*pDimensionality = 1;
return S_OK;
}
要件
要件 | 値 |
---|---|
Header | dbgmodel.h |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示