Kelas CComSafeArrayBound

Nota

Pustaka Templat Aktif (ATL) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.

Kelas ini adalah pembungkus untuk struktur SAFEARRAYBOUND .

Sintaks

class CComSafeArrayBound : public SAFEARRAYBOUND

Anggota

Metode

Fungsi	Deskripsi
CComSafeArrayBound	Konstruktor.
GetCount	Panggil metode ini untuk mengembalikan jumlah elemen.
GetLowerBound	Panggil metode ini untuk mengembalikan batas bawah.
GetUpperBound	Panggil metode ini untuk mengembalikan batas atas.
SetCount	Panggil metode ini untuk mengatur jumlah elemen.
SetLowerBound	Panggil metode ini untuk mengatur batas bawah.

Operator

Operator	Deskripsi
operator =	Mengatur ke CComSafeArrayBound nilai baru.

Keterangan

Kelas ini adalah pembungkus untuk struktur yang SAFEARRAYBOUND digunakan oleh CComSafeArray. Ini menyediakan metode untuk mengkueri dan mengatur batas atas dan bawah dari satu dimensi CComSafeArray objek dan jumlah elemen yang dikandungnya. Objek multidimensi CComSafeArray menggunakan array CComSafeArrayBound objek, satu untuk setiap dimensi. Oleh karena itu, saat menggunakan metode seperti GetCount, ketahuilah bahwa metode ini tidak akan mengembalikan jumlah total elemen dalam array multididat.

Header: atlsafe.h

Persyaratan

Header: atlsafe.h

CComSafeArrayBound::CComSafeArrayBound

Konstruktor.

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

Parameter

ulCount
Jumlah elemen dalam array.

lLowerBound
Batas bawah tempat array diberi nomor.

Keterangan

Jika array akan diakses dari program C++, disarankan agar batas bawah didefinisikan sebagai 0. Mungkin lebih baik menggunakan nilai terikat yang lebih rendah yang berbeda jika array akan digunakan dengan bahasa lain, seperti Visual Basic.

CComSafeArrayBound::GetCount

Panggil metode ini untuk mengembalikan jumlah elemen.

ULONG GetCount() const throw();

Tampilkan Nilai

Mengembalikan jumlah elemen.

Keterangan

Jika objek terkait mewakili array multidimensi CComSafeArray , metode ini hanya akan mengembalikan jumlah total elemen dalam dimensi paling kanan. Gunakan CComSafeArray::GetCount untuk mendapatkan jumlah total elemen.

CComSafeArrayBound::GetLowerBound

Panggil metode ini untuk mengembalikan batas bawah.

LONG GetLowerBound() const throw();

Tampilkan Nilai

Mengembalikan batas CComSafeArrayBound bawah objek.

CComSafeArrayBound::GetUpperBound

Panggil metode ini untuk mengembalikan batas atas.

LONG GetUpperBound() const throw();

Tampilkan Nilai

Mengembalikan batas CComSafeArrayBound atas objek.

Keterangan

Batas atas tergantung pada jumlah elemen dan nilai terikat yang lebih rendah. Misalnya, jika batas bawah adalah 0 dan jumlah elemen adalah 10, batas atas akan secara otomatis diatur ke 9.

CComSafeArrayBound::operator =

Mengatur ke CComSafeArrayBound nilai baru.

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

Parameter

Terikat
Objek CComSafeArrayBound.

ulCount
Jumlah elemen.

Tampilkan Nilai

Mengembalikan penunjuk ke CComSafeArrayBound objek.

Keterangan

Objek CComSafeArrayBound dapat ditetapkan menggunakan CComSafeArrayBound, atau dengan menyediakan jumlah elemen, dalam hal ini batas bawah diatur ke 0 secara default.

CComSafeArrayBound::SetCount

Panggil metode ini untuk mengatur jumlah elemen.

ULONG SetCount(ULONG ulCount) throw();

Parameter

ulCount
Jumlah elemen.

Tampilkan Nilai

Mengembalikan jumlah elemen dalam CComSafeArrayBound objek.

CComSafeArrayBound::SetLowerBound

Panggil metode ini untuk mengatur batas bawah.

LONG SetLowerBound(LONG lLowerBound) throw();

Parameter

lLowerBound
Batas bawah.

Tampilkan Nilai

Mengembalikan batas CComSafeArrayBound bawah baru objek.

Keterangan

Jika array akan diakses dari program Visual C++, disarankan agar batas bawah didefinisikan sebagai 0. Mungkin lebih baik menggunakan nilai terikat yang lebih rendah yang berbeda jika array akan digunakan dengan bahasa lain, seperti Visual Basic.

Batas atas tergantung pada jumlah elemen dan nilai terikat yang lebih rendah. Misalnya, jika batas bawah adalah 0 dan jumlah elemen adalah 10, batas atas akan secara otomatis diatur ke 9.

Lihat juga

Gambaran Umum Kelas