Bagikan melalui

Tambahkan variabel anggota

  • Artikel

Anda bisa menambahkan variabel anggota ke kelas menggunakan Tampilan Kelas. Variabel anggota dapat digunakan untuk pertukaran data dan validasi data, atau dapat bersifat umum. Wizard variabel anggota data dirancang untuk mengambil informasi yang relevan serta menggunakannya untuk menyisipkan elemen dalam file sumber Anda di lokasi yang sesuai. Anda bisa menambahkan variabel anggota dari editor Dialog di Tampilan Sumber Daya, atau dari Tampilan Kelas.

Catatan

Saat Anda mendesain dan mengimplementasikan kotak dialog, Anda mungkin merasa lebih efisien menggunakan editor Dialog untuk menambahkan kontrol kotak dialog, lalu mengimplementasikan variabel anggota kontrol.

Untuk menambahkan variabel anggota pada kontrol dialog di Tampilan Sumber Daya menggunakan Wizard Tambahkan Variabel Anggota:

  1. Di Tampilan Sumber Daya, perluas node proyek serta simpul Dialog untuk menampilkan daftar kotak dialog proyek.

  2. Klik dua kali kotak dialog tempat Anda ingin menambahkan variabel anggota untuk membukanya di editor Dialog.

  3. Dalam kotak dialog yang ditampilkan di editor Dialog, klik kanan kontrol yang ingin Anda tambahkan variabel anggotanya.

  4. Pada menu pintasan, pilih Tambahkan Variabel untuk menampilkan Wizard tambahkan variabel anggota.

    Catatan

    Nilai default sudah disediakan di ID Kontrol.

  5. Sediakan informasi dalam kotak wizard yang sesuai. Untuk informasi selengkapnya, lihat kontrol kotak dialog serta jenis variabel.

  6. Pilih Selesai untuk menambahkan definisi serta kode implementasi ke proyek dan menutup wizard.

Untuk menambahkan variabel anggota dari Tampilan Kelas menggunakan Wizard Tambahkan Variabel Anggota:

  1. Di Tampilan Kelas, perluas node proyek untuk menampilkan kelas dalam proyek.

  2. Klik kanan kelas yang ingin Anda tambahkan variabelnya.

  3. Pada menu pintasan, pilih Tambahkan, lalu pilihTambahkan Variabel untuk menampilkan Wizard Tambahkan Variabel Anggota.

  4. Sediakan informasi dalam kotak wizard yang sesuai. Untuk informasi selengkapnya, lihat Wizard tambahkan variabel anggota.

  5. Pilih Selesai untuk menambahkan definisi serta kode implementasi ke proyek dan menutup wizard.

Di bagian ini

Wizard tambahkan variabel anggota

Wizard ini menambahkan deklarasi variabel anggota ke file header. Tergantung pada opsinya, wizard ini bisa menambahkan kode ke file .cpp. Setelah menambahkan variabel anggota menggunakan wizard, Anda dapat mengedit kode di lingkungan pengembangan.

  • Access

    Mengatur akses ke variabel anggota. Pengubah akses adalah kata kunci yang menentukan akses yang dimiliki kelas lain ke variabel anggota. Untuk informasi selengkapnya tentang menentukan akses, lihat kontrol akses anggota. Tingkat akses variabel anggota diatur ke public secara default.

  • Jenis variabel

    Mengatur jenis pengembalian untuk variabel anggota yang Anda tambahkan.

    • Jika Anda menambahkan variabel anggota yang bukan kontrol kotak dialog, pilih dari daftar jenis yang tersedia.

      Untuk informasi tentang jenis tersebut, lihat jenis mendasar.

      • char
      • double
      • float
      • int
      • long
      • short
      • unsigned char
      • unsigned int
      • unsigned long

    • Jika Anda menambahkan variabel anggota untuk kontrol kotak dialog, kotak ini diisi dengan jenis objek yang dikembalikan untuk kontrol atau nilai. Apabila Anda memilih Kontrol, maka Jenis variabel menentukan kelas dasar kontrol yang Anda pilih dalam kotak ID Kontrol. Jika kontrol kotak dialog bisa menyimpan nilai, dan jika Anda memilih Nilai, maka Jenis variabel menentukan jenis yang sesuai untuk nilai yang bisa ditangguhkan kontrol. Untuk informasi selengkapnya, lihat kontrol kotak dialog serta jenis variabel.

      Nilai ini bergantung pada pilihan di ID Kontrol dan tidak bisa diubah.

  • Nama variabel

    Mengatur nama variabel anggota yang Anda tambahkan. Variabel anggota biasanya dimulai dengan string identifikasi m_, yang disediakan untuk Anda secara default.

  • Variabel kontrol

    Menunjukkan bahwa variabel anggota mengelola sebuah kontrol dalam kotak dialog dengan pertukaran data serta dukungan validasi data. Untuk informasi selengkapnya, lihat DoDataExchange. Opsi ini hanya tersedia untuk variabel anggota yang ditambahkan ke kelas yang berasal dari CDialog. Pilih kotak ini untuk mengaktifkan opsi ID Kontrol serta Jenis kontrol.

  • ID Kontrol

    Mengatur ID untuk variabel kontrol yang Anda tambahkan. Dari daftar, pilih ID untuk jenis kontrol yang akan menerima tambahan variabel anggota. Daftar hanya aktif saat kotak Variabel kontrol dipilih, dan terbatas pada ID untuk kontrol yang telah ditambahkan ke kotak dialog. Misalnya, untuk tombol OK standar, ID Kontrolnya adalah IDOK.

    Opsi Deskripsi
    Kontrol Opsi ini diatur secara default untuk jenis kontrolnya. Opsi ini mengelola kontrol itu sendiri, bukan status atau konten kontrol (karena Anda mungkin ingin mengelola kotak daftar, kotak kombo, atau kotak edit).
    Nilai Opsi ini tersedia untuk jenis kontrol yang bisa menampung nilai atau memperlihatkan sebuah status, seperti kotak edit atau kotak centang. Ini juga tersedia untuk jenis kontrol yang mungkin rentang, konten, atau statusnya dapat Anda kelola. Untuk informasi selengkapnya, lihat kontrol kotak dialog serta jenis variabel.

  • Kategori

    Menentukan apakah variabel didasarkan pada jenis kontrol atau nilai kontrol.

  • Jenis kontrol

    Mengatur jenis kontrol yang ditambahkan. Kotak ini tidak bisa diubah. Misalnya, tombol memiliki jenis kontrol BUTTON, serta kotak kombo memiliki jenis kontrol COMBOBOX. Untuk informasi selengkapnya, lihat kontrol kotak dialog serta jenis variabel.

  • Karakter maks

    Hanya tersedia ketika Jenis variabel diatur ke CString. Menunjukkan jumlah karakter terbanyak yang bisa ditahan kontrol.

  • Nilai min

    Hanya tersedia ketika jenis variabel adalah BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency atau CTime. Menunjukkan nilai terendah yang bisa diterima untuk skala atau rentang tanggal.

  • Nilai maks

    Hanya tersedia jika jenis variabel adalah BOOL, int, UINT, long, DWORD, float, double, BYTE, short, COLECurrency, atau CTime. Menunjukkan nilai tertinggi yang bisa diterima untuk skala atau rentang tanggal.

  • .h file

    Untuk kontrol ActiveX, yang variabel anggotanya memerlukan kelas wrapper. Mengatur nama file header untuk menambahkan deklarasi kelas.

  • file .cpp

    Untuk kontrol ActiveX, yang variabel anggotanya memerlukan kelas wrapper. Mengatur nama file implementasi untuk menambahkan definisi kelas.

  • Komentar

    Menyediakan komentar dalam file header untuk variabel anggota.

Kontrol kotak dialog dan jenis variabel

Anda bisa menggunakan wizard tambahkan variabel anggota untuk menambahkan variabel anggota ke kontrol kotak dialog yang dibuat menggunakan MFC. Jenis kontrol yang akan menerima variabel anggota menentukan opsi yang muncul dalam kotak dialog.

Tabel berikut ini menjelaskan semua tipe kontrol kotak dialog yang didukung di MFC serta Editor dialog. Ini juga menampilkan jenis serta nilai yang tersedia.

Kontrol Jenis kontrol Jenis variabel kontrol Jenis variabel nilai Nilai min/maks (hanya jenis nilai)
Kontrol animasi SysAnimate32 CAnimateCtrl Tidak ada; hanya kontrol T/A
Tombol BUTTON CButton Tidak ada; hanya kontrol T/A
Kotak centang CHECK CButton BOOL Nilai min/Nilai maks
Kotak kombo COMBOBOX CComboBox CString Karakter maks
Kontrol pemilih waktu tanggal SysDateTimePick32 CDateTimeCtrl CTime Nilai min/nilai maks
Kotak edit EDIT CEdit CString, int, UINT, long, DWORD, float, double, BYTE, short, BOOL, COleDateTime, atau COleCurrency Nilai min/nilai maks; beberapa mendukung karakter maks
Kontrol tombol pintas msctls_hotkey32 CHotKeyCtrl Tidak ada; hanya kontrol T/A
Kotak daftar LISTBOX CListBox CString Karakter maks
Kontrol daftar SysListView32 CListCtrl Tidak ada; hanya kontrol T/A
Kontrol Kalender Bulan SysMonthCal32 CMonthCalCtrl CTime Nilai min/nilai maks
Kontrol kemajuan msctls_progress32 CProgressCtrl Tidak ada; hanya kontrol T/A
Kontrol Rich Edit 2 RichEdit20A CRichEditCtrl CString Karakter maks
Kontrol Rich Edit RICHEDIT CRichEditCtrl CString Karakter maks
Bilah gulir (vertikal atau horizontal SCROLLBAR CScrollBar int Nilai min/nilai maks
Kontrol penggeser msctls_trackbar32 CSliderCtrl int Nilai min/nilai maks
Kontrol putar msctls_updown32 CSpinButtonCtrl Tidak ada; hanya kontrol T/A
Kontrol tab SysTabControl32 CTabCtrl Tidak ada; hanya kontrol T/A
Kontrol pohon SysTreeView32 CTreeCtrl Tidak ada; hanya kontrol T/A