CComSafeArrayBound Sınıfı
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, CComSafeArray tarafından kullanılan yapı için SAFEARRAYBOUND 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.