CComSafeArrayBound 類別
這個類別是 SAFEARRAYBOUND 結構的包裝函式。
語法
class CComSafeArrayBound : public SAFEARRAYBOUND
成員
方法
| 函式 | 描述 |
|---|---|
| CComSafeArrayBound | 建構函式。 |
| GetCount | 呼叫這個方法以傳回項目數目。 |
| GetLowerBound | 呼叫此方法以傳回下限。 |
| GetUpperBound | 呼叫這個方法以傳回上限。 |
| SetCount | 呼叫此方法以設定項目數目。 |
| SetLowerBound | 呼叫此方法以設定下限。 |
操作員
| 運算子 | 描述 |
|---|---|
| operator = | CComSafeArrayBound將設定為新的值。 |
備註
這個類別是 CComSafeArray 所使用結構的包裝函SAFEARRAYBOUND式。 它提供方法來查詢和設定物件之單一維度 CComSafeArray 的上限和下限，以及它所包含的元素數目。 多維度 CComSafeArray 物件會使用 對象的陣列 CComSafeArrayBound ，每個維度各一個。 因此，使用 GetCount 之類的方法時，請注意此方法不會傳回多維度陣列中的元素總數。
標頭︰ atlsafe.h
需求
標頭︰ atlsafe.h
CComSafeArrayBound：：CComSafeArrayBound
建構函式。
CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();
參數
ulCount
陣列中的項目數。
lLowerBound
從中編號陣列的下限。
備註
如果要從C++程式存取數位，建議將下限定義為0。 如果陣列要搭配其他語言使用，則最好使用不同的下限值，例如Visual Basic。
CComSafeArrayBound：：GetCount
呼叫這個方法以傳回項目數目。
ULONG GetCount() const throw();
傳回值
傳回項目數目。
備註
如果相關聯的 CComSafeArray 物件代表多維度陣列，這個方法只會傳回最右邊維度中的元素總數。 使用 CComSafeArray：：GetCount 取得元素總數。
CComSafeArrayBound：：GetLowerBound
呼叫此方法以傳回下限。
LONG GetLowerBound() const throw();
傳回值
傳回 物件的下限 CComSafeArrayBound 。
CComSafeArrayBound：：GetUpperBound
呼叫這個方法以傳回上限。
LONG GetUpperBound() const throw();
傳回值
傳回物件的上限 CComSafeArrayBound 。
備註
上限取決於元素數目和下限值。 例如，如果下限為 0 且元素數目為 10，則上限會自動設定為 9。
CComSafeArrayBound：：operator =
CComSafeArrayBound將設定為新的值。
CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();
參數
綁定
CComSafeArrayBound 物件。
ulCount
項目的數目。
傳回值
傳回 物件的指標 CComSafeArrayBound 。
備註
CComSafeArrayBound您可以使用現有的 CComSafeArrayBound來指派 物件，或藉由提供元素數目，在此情況下，下限預設會設定為 0。
CComSafeArrayBound：：SetCount
呼叫此方法以設定項目數目。
ULONG SetCount(ULONG ulCount) throw();
參數
ulCount
項目的數目。
傳回值
傳回物件中的 CComSafeArrayBound 項目數目。
CComSafeArrayBound：：SetLowerBound
呼叫此方法以設定下限。
LONG SetLowerBound(LONG lLowerBound) throw();
參數
lLowerBound
下限。
傳回值
傳回 物件的新下限 CComSafeArrayBound 。
備註
如果要從 Visual C++ 程式存取陣列，建議將下限定義為 0。 如果陣列要搭配其他語言使用，則最好使用不同的下限值，例如Visual Basic。
上限取決於元素數目和下限值。 例如，如果下限為 0 且元素數目為 10，則上限會自動設定為 9。