Bagikan melalui

Kelas COleVariant

  • Artikel

Merangkum jenis data VARIAN .

Sintaks

class COleVariant : public tagVARIANT

Anggota

Konstruktor Publik

Nama Deskripsi
COleVariant::COleVariant Membuat COleVariant objek.

Metode Publik

Nama Deskripsi
COleVariant::Attach Melampirkan VARIAN ke COleVariant.
COleVariant::ChangeType Mengubah tipe varian objek ini COleVariant .
COleVariant::Clear Menghapus objek ini COleVariant .
COleVariant::D etach Mencopot VARIAN dari COleVariant dan mengembalikan VARIAN.
COleVariant::GetByteArrayFromVariantArray Mengambil array byte dari array varian yang ada.
COleVariant::SetString Mengatur string ke jenis tertentu, biasanya ANSI.

Operator Publik

Nama Deskripsi
COleVariant::operator LPCVARIANT COleVariant Mengonversi nilai menjadi LPCVARIANT.
COleVariant::operator LPVARIANT COleVariant Mengonversi objek menjadi LPVARIANT.
COleVariant::operator = COleVariant Menyalin nilai.
COleVariant::operator == Membandingkan dua COleVariant nilai.
COleVariant::operator <<, COleVariant::operator >> COleVariant Menghasilkan nilai ke CArchive atau CDumpContext dan memasukkan COleVariant objek dari CArchive.

Keterangan

Jenis data ini digunakan dalam otomatisasi OLE. Secara khusus, struktur DISPPARAMS berisi pointer ke array struktur VARIAN. Struktur DISPPARAMS digunakan untuk meneruskan parameter ke IDispatch::Invoke.

Catatan

Kelas ini berasal dari VARIANT struktur. Ini berarti Anda dapat meneruskan COleVariant dalam parameter yang memanggil VARIANT dan bahwa anggota data struktur VARIANT adalah anggota data yang dapat diakses dari COleVariant.

Dua kelas MFC terkait COleCurrency dan COleDateTime merangkum jenis data varian CURRENCY ( VT_CY) dan DATE ( VT_DATE). Kelas COleVariant ini digunakan secara ekstensif di kelas DAO; lihat kelas ini untuk penggunaan umum kelas ini, misalnya CDaoQueryDef dan CDaoRecordset.

Untuk informasi selengkapnya, lihat entri VARIAN, MATA UANG, DISPPARAMS, dan IDispatch::Panggil entri di Windows SDK.

Untuk informasi selengkapnya tentang COleVariant kelas dan penggunaannya dalam otomatisasi OLE, lihat "Melewati Parameter di Otomatisasi OLE" dalam artikel Automasi.

Hierarki Warisan

tagVARIANT

COleVariant

Persyaratan

Header: afxdisp.h

COleVariant::Attach

Panggil fungsi ini untuk melampirkan objek VARIAN yang diberikan ke objek saat iniCOleVariant.

void Attach(VARIANT& varSrc);

Parameter

varSrc
Objek yang VARIANT ada untuk dilampirkan ke objek saat ini COleVariant .

Keterangan

Fungsi ini mengatur VARTYPE varSrc ke VT_EMPTY.

Untuk informasi selengkapnya, lihat entri VARIAN dan VARENUM di Windows SDK.

COleVariant::COleVariant

Membuat COleVariant objek.

COleVariant();
COleVariant(const VARIANT& varSrc);
COleVariant(const COleVariant& varSrc);
COleVariant(LPCVARIANT pSrc);
COleVariant(LPCTSTR lpszSrc);
COleVariant(LPCTSTR lpszSrc, VARTYPE vtSrc);
COleVariant(CString& strSrc);
COleVariant(BYTE nSrc);
COleVariant(short nSrc, VARTYPE vtSrc = VT_I2);
COleVariant(long lSrc,VARTYPE vtSrc = VT_I4);
COleVariant(const COleCurrency& curSrc);
COleVariant(float fltSrc);
COleVariant(double dblSrc);
COleVariant(const COleDateTime& timeSrc);
COleVariant(const CByteArray& arrSrc);
COleVariant(const CLongBinary& lbSrc);
COleVariant(LPCITEMIDLIST pidl);

Parameter

varSrc
Objek atau VARIANT yang sudah ada COleVariant untuk disalin ke dalam objek baruCOleVariant.

pSrc
Penunjuk ke VARIANT objek yang akan disalin ke objek baru COleVariant .

lpszSrc
String null-terminated yang akan disalin ke dalam objek baru COleVariant .

vtSrc
VARTYPE untuk objek baruCOleVariant.

strSrc
Objek CString yang akan disalin ke dalam objek baru COleVariant .

nSrc, lSrc Nilai numerik yang akan disalin ke dalam objek baru COleVariant .

vtSrc
VARTYPE untuk objek baruCOleVariant.

curSrc
Objek COleCurrency yang akan disalin ke dalam objek baru COleVariant .

fltSrc, dblSrc
Nilai numerik yang akan disalin ke dalam objek baru COleVariant .

timeSrc
Objek COleDateTime yang akan disalin ke objek baru COleVariant .

arrSrc
Objek CByteArray yang akan disalin ke dalam objek baru COleVariant .

lbSrc
Objek CLongBinary yang akan disalin ke dalam objek baru COleVariant .

pidl
Penunjuk ke struktur ITEMIDLIST yang akan disalin ke objek baru COleVariant .

Keterangan

Semua konstruktor ini membuat objek baru COleVariant yang diinisialisasi ke nilai yang ditentukan. Deskripsi singkat tentang masing-masing konstruktor ini mengikuti.

  • COleVariant( ) Membuat objek kosong COleVariant , VT_EMPTY.

  • COleVariant( varSrc ) Menyalin objek atau COleVariant yang adaVARIANT. Jenis varian dipertahankan.

  • COleVariant( pSrc ) Menyalin objek atau COleVariant yang adaVARIANT. Jenis varian dipertahankan.

  • COleVariant( lpszSrc ) Menyalin string ke dalam objek baru, VT_BSTR (UNICODE).

  • COleVariant( lpszSrc , vtSrc ) Menyalin string ke dalam objek baru. Parameter vtSrc harus VT_BSTR (UNICODE) atau VT_BSTRT (ANSI).

  • COleVariant( strSrc ) Menyalin string ke dalam objek baru, VT_BSTR (UNICODE).

  • COleVariant( nSrc ) Menyalin bilangan bulat 8-bit ke dalam objek baru, VT_UI1.

  • COleVariant( nSrc , vtSrc ) Menyalin bilangan bulat 16-bit (atau nilai Boolean) ke dalam objek baru. Parameter vtSrc harus VT_I2 atau VT_BOOL.

  • COleVariant( lSrc , vtSrc ) Menyalin bilangan bulat 32-bit (atau nilai SCODE) ke dalam objek baru. Parameter vtSrc harus VT_I4, VT_ERROR, atau VT_BOOL.

  • COleVariant( curSrc ) Menyalin COleCurrency nilai ke dalam objek baru, VT_CY.

  • COleVariant( fltSrc ) Menyalin nilai floating-point 32-bit ke dalam objek baru, VT_R4.

  • COleVariant( dblSrc ) Menyalin nilai floating-point 64-bit ke dalam objek baru, VT_R8.

  • COleVariant( timeSrc ) Menyalin COleDateTime nilai ke dalam objek baru, VT_DATE.

  • COleVariant( arrSrc ) Menyalin CByteArray objek ke dalam objek baru, VT_EMPTY.

  • COleVariant( lbSrc ) Menyalin CLongBinary objek ke dalam objek baru, VT_EMPTY.

Untuk informasi selengkapnya tentang SCODE, lihat Struktur Kode Kesalahan COM di Windows SDK.

COleVariant::ChangeType

Mengonversi tipe nilai varian dalam objek ini COleVariant .

void ChangeType(VARTYPE vartype, LPVARIANT pSrc = NULL);

Parameter

vartype
VARTYPE untuk objek ini COleVariant .

pSrc
Penunjuk ke objek VARIAN yang akan dikonversi. Jika nilai ini NULL, objek ini COleVariant digunakan sebagai sumber untuk konversi.

Keterangan

Untuk informasi selengkapnya, lihat entri VARIAN, VARENUM, dan VariantChangeType di Windows SDK.

COleVariant::Clear

VARIANTMenghapus .

void Clear();

Keterangan

Ini mengatur VARTYPE untuk objek ini ke VT_EMPTY. COleVariant Destruktor memanggil fungsi ini.

Untuk informasi selengkapnya, lihat VARIANT, VARTYPE, dan VariantClear entri di Windows SDK.

COleVariant::D etach

Lepaskan objek VARIAN yang mendasar dari objek iniCOleVariant.

VARIANT Detach();

Keterangan

Fungsi ini mengatur VARTYPE untuk objek ini COleVariant ke VT_EMPTY.

Catatan

Setelah memanggil Detach, pemanggil bertanggung jawab untuk memanggil VariantClear struktur yang VARIANT dihasilkan.

Untuk informasi selengkapnya, lihat entri VARIAN, VARENUM, dan VariantClear di Windows SDK.

COleVariant::GetByteArrayFromVariantArray

Mengambil array byte dari array varian yang ada

void GetByteArrayFromVariantArray(CByteArray& bytes);

Parameter

Byte
Referensi ke objek CByteArray yang sudah ada.

COleVariant::operator LPCVARIANT

Operator transmisi ini mengembalikan VARIANT struktur yang nilainya disalin dari objek ini COleVariant .

operator LPCVARIANT() const;

Keterangan

COleVariant::operator LPVARIANT

Panggil operator transmisi ini untuk mengakses struktur yang mendasar VARIANT untuk objek ini COleVariant .

operator LPVARIANT();

Keterangan

Perhatian

Mengubah nilai dalam struktur yang VARIANT diakses oleh penunjuk yang dikembalikan oleh fungsi ini akan mengubah nilai objek ini COleVariant .

COleVariant::operator =

Operator penugasan yang kelebihan beban ini menyalin nilai sumber ke dalam objek ini COleVariant .

const COleVariant& operator=(const VARIANT& varSrc);
const COleVariant& operator=(LPCVARIANT pSrc);
const COleVariant& operator=(const COleVariant& varSrc);
const COleVariant& operator=(const LPCTSTR lpszSrc);
const COleVariant& operator=(const CString& strSrc);
const COleVariant& operator=(BYTE nSrc);
const COleVariant& operator=(short nSrc);
const COleVariant& operator=(long lSrc);
const COleVariant& operator=(const COleCurrency& curSrc);
const COleVariant& operator=(float fltSrc);
const COleVariant& operator=(double dblSrc);
const COleVariant& operator=(const COleDateTime& dateSrc);
const COleVariant& operator=(const CByteArray& arrSrc);
const COleVariant& operator=(const CLongBinary& lbSrc);

Keterangan

Deskripsi singkat tentang setiap operator berikut:

  • operator =( varSrc ) Menyalin VARIAN atau COleVariant objek yang ada ke dalam objek ini.

  • operator =( pSrc ) Menyalin objek VARIAN yang diakses oleh pSrc ke dalam objek ini.

  • operator =( lpszSrc ) Menyalin string null-terminated ke dalam objek ini dan mengatur VARTYPE ke VT_BSTR.

  • operator =( strSrc ) Menyalin objek CString ke dalam objek ini dan mengatur VARTYPE ke VT_BSTR.

  • operator =( nSrc ) Menyalin nilai bilangan bulat 8 atau 16-bit ke dalam objek ini. Jika nSrc adalah nilai 8-bit, VARTYPE ini diatur ke VT_UI1. Jika nSrc adalah nilai 16-bit dan VARTYPE ini VT_BOOL, itu disimpan; jika tidak, itu diatur ke VT_I2.

  • operator =( lSrc ) Menyalin nilai bilangan bulat 32-bit ke dalam objek ini. Jika VARTYPE ini VT_ERROR, vaRTYPE disimpan; jika tidak, diatur ke VT_I4.

  • operator =( curSrc ) Menyalin objek COleCurrency ke dalam objek ini dan mengatur VARTYPE ke VT_CY.

  • operator =( fltSrc ) Menyalin nilai floating-point 32-bit ke dalam objek ini dan mengatur VARTYPE ke VT_R4.

  • operator =( dblSrc ) Menyalin nilai floating-point 64-bit ke dalam objek ini dan mengatur VARTYPE ke VT_R8.

  • operator =( dateSrc ) Menyalin objek COleDateTime ke dalam objek ini dan mengatur VARTYPE ke VT_DATE.

  • operator =( arrSrc ) Menyalin objek CByteArray ke dalam objek ini COleVariant .

  • operator =( lbSrc ) Menyalin objek CLongBinary ke dalam objek ini COleVariant .

Untuk informasi selengkapnya, lihat entri VARIAN dan VARENUM di Windows SDK.

COleVariant::operator ==

Operator ini membandingkan dua nilai varian dan mengembalikan nonzero jika sama; jika tidak, 0.

BOOL operator==(const VARIANT& varSrc) const;
BOOL operator==(LPCVARIANT pSrc) const;

COleVariant::operator <<, COleVariant::operator >>

COleVariant Menghasilkan nilai ke CArchive atau CdumpContext dan memasukkan COleVariant objek dari CArchive.

friend CDumpContext& AFXAPI operator<<(
    CDumpContext& dc,
    OleVariant varSrc);

friend CArchive& AFXAPI operator<<(
    CArchive& ar,
    COleVariant varSrc);

friend CArchive& AFXAPI operator>>(
    CArchive& ar,
    COleVariant& varSrc);

Keterangan

Operator COleVariant penyisipan (<<) mendukung pembuangan diagnostik dan penyimpanan ke arsip. Operator ekstraksi (>>) mendukung pemuatan dari arsip.

COleVariant::SetString

Mengatur string ke jenis tertentu.

void SetString(LPCTSTR lpszSrc, VARTYPE vtSrc);

Parameter

lpszSrc
String null-terminated yang akan disalin ke dalam objek baru COleVariant .

VtSrc
VARTYPE untuk objek baru COleVariant .

Keterangan

Parameter vtSrc harus VT_BSTR (UNICODE) atau VT_BSTRT (ANSI). SetString biasanya digunakan untuk mengatur string ke ANSI, karena default untuk konstruktor COleVariant::COleVariant dengan parameter string atau penunjuk string dan tidak ada VARTYPE adalah UNICODE.

Kumpulan rekaman DAO dalam build non-UNICODE mengharapkan string menjadi ANSI. Dengan demikian, untuk fungsi DAO yang menggunakan COleVariant objek, jika Anda tidak membuat kumpulan catatan UNICODE, Anda harus menggunakan bentuk konstruktor COleVariant::COleVariant( lpszSrc , vtSrc ) dengan vtSrc diatur ke VT_BSTRT (ANSI) atau menggunakan SetString dengan vtSrc diatur ke VT_BSTRT untuk membuat string ANSI. Misalnya, CDaoRecordset fungsi CDaoRecordset::Seek dan CDaoRecordset::SetFieldValue menggunakan COleVariant objek sebagai parameter. Objek ini harus ANSI jika himpunan rekaman DAO bukan UNICODE.

Lihat juga

Bagan Hierarki