Rutinitas Validasi Data Dialog Standar
Topik ini mencantumkan rutinitas validasi data dialog standar (DDV) yang digunakan untuk kontrol dialog MFC umum.
Catatan
Rutinitas pertukaran data dialog standar ditentukan dalam file header afxdd_.h. Namun, aplikasi harus menyertakan afxwin.h.
Fungsi DDV
Nama | Deskripsi |
---|---|
DDV_MaxChars | Memverifikasi jumlah karakter dalam nilai kontrol tertentu tidak melebihi maksimum tertentu. |
DDV_MinMaxByte | Memverifikasi nilai kontrol tertentu tidak melebihi rentang BYTE tertentu. |
DDV_MinMaxDateTime | Memverifikasi nilai kontrol tertentu tidak melebihi rentang waktu tertentu. |
DDV_MinMaxDouble | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tertentu double . |
DDV_MinMaxDWord | Memverifikasi nilai kontrol tertentu tidak melebihi rentang DWORD tertentu. |
DDV_MinMaxFloat | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tertentu float . |
DDV_MinMaxInt | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tertentu int . |
DDV_MinMaxLong | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tertentu long . |
DDV_MinMaxLongLong | Memverifikasi nilai kontrol tertentu tidak melebihi rentang LONGLONG tertentu. |
DDV_MinMaxMonth | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tanggal tertentu. |
DDV_MinMaxShort | Memverifikasi nilai kontrol tertentu tidak melebihi rentang tertentu short . |
DDV_MinMaxSlider | Memverifikasi nilai kontrol slider tertentu berada dalam rentang tertentu. |
DDV_MinMaxUInt | Memverifikasi nilai kontrol tertentu tidak melebihi rentang UINT tertentu. |
DDV_MinMaxUnsigned | Memverifikasi nilai kontrol tertentu berada di antara dua nilai yang ditentukan. |
DDV_MinMaxULongLong | Memverifikasi nilai kontrol tertentu tidak melebihi rentang ULONGLONG tertentu. |
DDV_MaxChars
Panggil DDV_MaxChars
untuk memverifikasi bahwa jumlah karakter dalam kontrol yang terkait dengan nilai tidak melebihi nChars.
void AFXAPI DDV_MaxChars(
CDataExchange* pDX,
CString const& value,
int nChars);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
nChars
Jumlah maksimum karakter yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxByte
Panggil DDV_MinMaxByte
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxByte(
CDataExchange* pDX,
BYTE value,
BYTE minVal,
BYTE maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (jenis BYTE) diperbolehkan.
maxVal
Nilai maksimum (tipe BYTE) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxDateTime
Panggil DDV_MinMaxDateTime
untuk memverifikasi bahwa nilai waktu/tanggal dalam kontrol pemilih tanggal dan waktu ( CDateTimeCtrl) yang terkait dengan refValue berada di antara refMinRange dan refMaxRange.
void AFXAPI DDV_MinMaxDateTime(
CDataExchange* pDX,
CTime& refValue,
const CTime* refMinRange,
const CTime* refMaxRange);
void AFXAPI DDV_MinMaxDateTime(
CDataExchange* pDX,
COleDateTime& refValue,
const COleDateTime* refMinRange,
const COleDateTime* refMaxRange);
Parameter
pDX
Penunjuk ke objek CDataExchange . Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya. Anda tidak perlu menghapus objek ini.
refValue
Referensi ke objek CTime atau COleDateTime yang terkait dengan variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol. Objek ini berisi data yang akan divalidasi.
refMinRange
Nilai tanggal/waktu minimum yang diizinkan.
refMaxRange
Nilai tanggal/waktu maksimum yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxDouble
Panggil DDV_MinMaxDouble
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxDouble(
CDataExchange* pDX,
double const& value,
double minVal,
double maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis double
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis double
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxDWord
Panggil DDV_MinMaxDWord
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxDWord(
CDataExchange* pDX,
DWORD const& value,
DWORD minVal,
DWORD maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (jenis DWORD) yang diizinkan.
maxVal
Nilai maksimum (jenis DWORD) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxFloat
Panggil DDV_MinMaxFloat
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxFloat(
CDataExchange* pDX,
float value,
float minVal,
float maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis float
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis float
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxInt
Panggil DDV_MinMaxInt
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxInt(
CDataExchange* pDX,
int value,
int minVal,
int maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis int
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis int
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxLong
Panggil DDV_MinMaxLong
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxLong(
CDataExchange* pDX,
long value,
long minVal,
long maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis long
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis long
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxLongLong
Panggil DDV_MinMaxLongLong
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxLongLong(
CDataExchange* pDX,
LONGLONG value,
LONGLONG minVal,
LONGLONG maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (jenis LONGLONG) diperbolehkan.
maxVal
Nilai maksimum (tipe LONGLONG) diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxMonth
Panggil DDV_MinMaxMonth
untuk memverifikasi bahwa nilai waktu/tanggal dalam kontrol kalender bulan ( CMonthCalCtrl) yang terkait dengan refValue berada di antara refMinRange dan refMaxRange.
void AFXAPI DDV_MinMaxMonth(
CDataExchange* pDX,
CTime& refValue,
const CTime* refMinRange,
const CTime* refMaxRange);
void AFXAPI DDV_MinMaxMonth(
CDataExchange* pDX,
COleDateTime& refValue,
const COleDateTime* refMinRange,
const COleDateTime* refMaxRange);
Parameter
pDX
Penunjuk ke objek CDataExchange . Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
refValue
Referensi ke objek jenis CTime
atau COleDateTime
terkait dengan variabel anggota dari kotak dialog, tampilan formulir, atau objek tampilan kontrol. Objek ini berisi data yang akan divalidasi. MFC meneruskan referensi ini ketika DDV_MinMaxMonth
dipanggil.
refMinRange
Nilai tanggal/waktu minimum yang diizinkan.
refMaxRange
Nilai tanggal/waktu maksimum yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxShort
Panggil DDV_MinMaxShort
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxShort(
CDataExchange* pDX,
short value,
short minVal,
short maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis short
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis short
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxSlider
Panggil DDV_MinMaxSlider
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxSlider(
CDataExchange* pDX,
DWORD value,
DWORD minVal,
DWORD maxVal);
Parameter
pDX
Penunjuk ke objek CDataExchange . Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke nilai yang akan divalidasi. Parameter ini menyimpan atau mengatur posisi jempol kontrol penggelas saat ini.
minVal
Nilai minimum yang diizinkan.
maxVal
Nilai maksimum yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi. Untuk informasi tentang kontrol slider, lihat Menggunakan CSliderCtrl.
Persyaratan
Header afxdd_.h
DDV_MinMaxUInt
Panggil DDV_MinMaxUInt
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxUInt(
CDataExchange* pDX,
UINT value,
UINT minVal,
UINT maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (tipe UINT) diizinkan.
maxVal
Nilai maksimum (tipe UINT) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxULongLong
Panggil DDV_MinMaxULongLong
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
void AFXAPI DDV_MinMaxULongLong(
CDataExchange* pDX,
ULONGLONG value,
ULONGLONG minVal ,
ULONGLONG maxVal);
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (jenis ULONGLONG) diizinkan.
maxVal
Nilai maksimum (tipe ULONGLONG) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header afxdd_.h
DDV_MinMaxUnsigned
Panggil DDV_MinMaxUnsigned
untuk memverifikasi bahwa nilai dalam kontrol yang terkait dengan nilai berada di antara minVal dan maxVal.
Sintaks
void AFXAPI DDV_MinMaxUnsigned(
CDataExchange* pDX,
unsigned value,
unsigned minVal,
unsigned maxVal );
Parameter
pDX
Penunjuk ke CDataExchange
objek. Kerangka kerja menyediakan objek ini untuk menetapkan konteks pertukaran data, termasuk arahnya.
value
Referensi ke variabel anggota kotak dialog, tampilan formulir, atau objek tampilan kontrol yang datanya divalidasi.
minVal
Nilai minimum (dari jenis unsigned
) yang diizinkan.
maxVal
Nilai maksimum (dari jenis unsigned
) yang diizinkan.
Keterangan
Untuk informasi selengkapnya tentang DDV, lihat Pertukaran Data Dialog dan Validasi.
Persyaratan
Header: afxdd_.h
Baca juga
Rutinitas Pertukaran Data Dialog Standar
Makro dan Global
DDX_Slider
DDX_FieldSlider
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk