CComSafeArrayBound Sınıfı

Uyarı

Etkin Şablon Kitaplığı (ATL) desteklenmeye devam eder. Ancak artık özellik eklemeyeceğiz veya belgeleri güncelleştirmeyeceğiz.

Bu sınıf, SAFEARRAYBOUND yapısı için bir sarmalayıcıdır.

Sözdizimi

class CComSafeArrayBound : public SAFEARRAYBOUND

Üyeler

Yöntemler

İşlev	Açıklama
CComSafeArrayBound	Oluşturucu.
GetCount	Öğe sayısını döndürmek için bu yöntemi çağırın.
GetLowerBound	Alt sınırı döndürmek için bu yöntemi çağırın.
GetUpperBound	Üst sınırı döndürmek için bu yöntemi çağırın.
SetCount	Öğe sayısını ayarlamak için bu yöntemi çağırın.
SetLowerBound	Alt sınırı ayarlamak için bu yöntemi çağırın.

İşleçler

Operator	Açıklama
operator =	değerini CComSafeArrayBound yeni bir değere ayarlar.

Açıklamalar

Bu sınıf, CComSafeArraySAFEARRAYBOUNDkullanılan yapı için bir sarmalayıcıdır. Bir nesnenin tek bir boyutunun CComSafeArray üst ve alt sınırlarını ve içerdiği öğe sayısını sorgulamak ve ayarlamak için yöntemler sağlar. Çok boyutlu CComSafeArray bir nesne, her boyut için bir nesne dizisi CComSafeArrayBound kullanır. Bu nedenle, GetCount gibi yöntemleri kullanırken, bu yöntemin çok boyutlu bir dizideki toplam öğe sayısını döndürmeyeceğini unutmayın.

Üst bilgi: atlsafe.h

Gereksinimler

Üst bilgi: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

Oluşturucu.

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

Parametreler

ulCount
Dizideki öğelerin sayısı

lLowerBound
Dizinin numaralandırıldığı alt sınır.

Açıklamalar

Diziye bir C++ programından erişilecekse alt sınırın 0 olarak tanımlanması önerilir. Dizi Visual Basic gibi diğer dillerle kullanılacaksa farklı bir alt sınır değeri kullanılması tercih edilebilir.

CComSafeArrayBound::GetCount

Öğe sayısını döndürmek için bu yöntemi çağırın.

ULONG GetCount() const throw();

Dönüş Değeri

Öğe sayısını döndürür.

Açıklamalar

İlişkili CComSafeArray nesne çok boyutlu bir diziyi temsil ederse, bu yöntem yalnızca en sağdaki boyuttaki toplam öğe sayısını döndürür. Toplam öğe sayısını elde etmek için CComSafeArray::GetCount kullanın.

CComSafeArrayBound::GetLowerBound

Alt sınırı döndürmek için bu yöntemi çağırın.

LONG GetLowerBound() const throw();

Dönüş Değeri

Nesnenin alt sınırlarını CComSafeArrayBound döndürür.

CComSafeArrayBound::GetUpperBound

Üst sınırı döndürmek için bu yöntemi çağırın.

LONG GetUpperBound() const throw();

Dönüş Değeri

Nesnenin üst sınırlarını CComSafeArrayBound döndürür.

Açıklamalar

Üst sınır, öğe sayısına ve alt sınır değerine bağlıdır. Örneğin, alt sınır 0 ve öğe sayısı 10 ise, üst sınır otomatik olarak 9 olarak ayarlanır.

CComSafeArrayBound::operator =

değerini CComSafeArrayBound yeni bir değere ayarlar.

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

Parametreler

sınır
Bir CComSafeArrayBound nesnesi.

ulCount
Öğe sayısı.

Dönüş Değeri

Nesneye CComSafeArrayBound bir işaretçi döndürür.

Açıklamalar

CComSafeArrayBound Nesne, mevcut CComSafeArrayBoundbir kullanılarak veya öğe sayısı sağlanarak atanabilir ve bu durumda alt sınır varsayılan olarak 0 olarak ayarlanır.

CComSafeArrayBound::SetCount

Öğe sayısını ayarlamak için bu yöntemi çağırın.

ULONG SetCount(ULONG ulCount) throw();

Parametreler

ulCount
Öğe sayısı.

Dönüş Değeri

Nesnedeki CComSafeArrayBound öğe sayısını döndürür.

CComSafeArrayBound::SetLowerBound

Alt sınırı ayarlamak için bu yöntemi çağırın.

LONG SetLowerBound(LONG lLowerBound) throw();

Parametreler

lLowerBound
Alt sınır.

Dönüş Değeri

Nesnenin yeni alt sınırlarını CComSafeArrayBound döndürür.

Açıklamalar

Diziye bir Visual C++ programından erişilecekse alt sınırın 0 olarak tanımlanması önerilir. Dizi Visual Basic gibi diğer dillerle kullanılacaksa farklı bir alt sınır değeri kullanılması tercih edilebilir.

Üst sınır, öğe sayısına ve alt sınır değerine bağlıdır. Örneğin, alt sınır 0 ve öğe sayısı 10 ise, üst sınır otomatik olarak 9 olarak ayarlanır.

Ayrıca bkz.

Sınıfa Genel Bakış