CComSafeArrayBound 類別

這個類別是 SAFEARRAYBOUND 結構的包裝函式 。

語法

class CComSafeArrayBound : public SAFEARRAYBOUND

成員

方法

函式	描述
CCom保管庫ArrayBound	建構函式。
GetCount	呼叫這個方法以傳回專案數目。
GetLowerBound	呼叫此方法以傳回下限。
GetUpperBound	呼叫這個方法以傳回上限。
SetCount	呼叫此方法以設定專案數目。
SetLowerBound	呼叫此方法以設定下限。

操作員

運算子	描述
operator =	CComSafeArrayBound將 設定為新的值。

備註

這個類別是 CCom保管庫Array 所使用 結構的包裝函 SAFEARRAYBOUND 式 。 它提供方法來查詢和設定物件之單一維度 CComSafeArray 的上限和下限，以及它所包含的元素數目。 多維度 CComSafeArray 物件會使用 物件的陣列 CComSafeArrayBound ，每個維度各一個。 因此，使用 GetCount 之類的 方法時，請注意此方法不會傳回多維度陣列中的元素總數。

標頭︰ atlsafe.h

需求

標頭︰ atlsafe.h

CCom保管庫ArrayBound：：CCom保管庫ArrayBound

建構函式。

CComSafeArrayBound(ULONG ulCount = 0, LONG lLowerBound = 0) throw();

參數

ulCount
陣列中的項目數。

lLowerBound
從中編號陣列的下限。

備註

如果要從 C++ 程式存取陣列，建議將下限定義為 0。 如果陣列要搭配其他語言使用，則最好使用不同的下限值，例如 Visual Basic。

CCom保管庫ArrayBound：：GetCount

呼叫這個方法以傳回專案數目。

ULONG GetCount() const throw();

傳回值

傳回專案數目。

備註

如果相關聯的 CComSafeArray 物件代表多維度陣列，這個方法只會傳回最右邊維度中的元素總數。 使用 CCom保管庫Array：：GetCount 取得元素總數。

CCom保管庫ArrayBound：：GetLowerBound

呼叫此方法以傳回下限。

LONG GetLowerBound() const throw();

傳回值

傳回 物件的下限 CComSafeArrayBound 。

CCom保管庫ArrayBound：：GetUpperBound

呼叫這個方法以傳回上限。

LONG GetUpperBound() const throw();

傳回值

傳回 物件的上限 CComSafeArrayBound 。

備註

上限取決於元素數目和下限值。 例如，如果下限為 0 且元素數目為 10，則上限會自動設定為 9。

CCom保管庫ArrayBound：：operator =

CComSafeArrayBound將 設定為新的值。

CComSafeArrayBound& operator= (const CComSafeArrayBound& bound) throw();
CComSafeArrayBound& operator= (ULONG ulCount) throw();

參數

綁定
CComSafeArrayBound 物件。

ulCount
項目的數目。

傳回值

傳回 物件的指標 CComSafeArrayBound 。

備註

CComSafeArrayBound您可以使用現有的 CComSafeArrayBound 來指派 物件，或藉由提供元素數目，在此情況下，下限預設會設定為 0。

CCom保管庫ArrayBound：：SetCount

呼叫此方法以設定專案數目。

ULONG SetCount(ULONG ulCount) throw();

參數

ulCount
項目的數目。

傳回值

傳回 物件中的 CComSafeArrayBound 專案數目。

CCom保管庫ArrayBound：：SetLowerBound

呼叫此方法以設定下限。

LONG SetLowerBound(LONG lLowerBound) throw();

參數

lLowerBound
下限。

傳回值

傳回 物件的新下限 CComSafeArrayBound 。

備註

如果要從 Visual C++ 程式存取陣列，建議將下限定義為 0。 如果陣列要搭配其他語言使用，則最好使用不同的下限值，例如 Visual Basic。

上限取決於元素數目和下限值。 例如，如果下限為 0 且元素數目為 10，則上限會自動設定為 9。

另請參閱

類別概觀