Menambahkan properti IDL MFC

Wizard Tambahkan Properti MFC IDL menambahkan properti ke antarmuka Pustaka Definisi Antarmuka (IDL) yang ditentukan dalam proyek Kelas Kerangka Kerja Microsoft (MFC) Anda.

Untuk menggunakan wizard ini, Anda harus berada dalam Proyek MFC, proyek ActiveX, atau proyek ATL yang mendukung MFC. Misalnya, jika Anda memiliki proyek kontrol Microsoft ActiveX, Anda dapat menggunakan prosedur berikut untuk menambahkan properti ke antarmuka IDL dalam solusi.

Menambahkan properti IDL MFC ke antarmuka Anda

1. Pada menu Tampilan, pilih Tampilan Kelas.

2. Di panel Tampilan Kelas, klik kanan nama antarmuka yang ingin Anda tambahkan propertinya.

   Catatan

   Anda juga dapat menambahkan properti ke dispinterfaces, yang disarangkan dalam node pustaka, kecuali proyek diatributkan.

3. Dari menu pintasan, pilih Tambahkan>Properti.

4. Di wizard tambahkan properti MFC IDL, berikan informasi untuk membuat properti.

5. Pilih OK untuk menambahkan properti.

Untuk dispinterface MFC:

• Jika Anda memilih Variabel anggota sebagai jenis implementasi, metode dan variabel ditambahkan ke kelas yang mengimplementasikannya.
• Jika Anda memilih Metode Get/Set sebagai jenis implementasi, dua metode ditambahkan ke kelas yang mengimplementasikannya.

Daftar elemen antarmuka pengguna

Bagian berikut ini menjelaskan wizard Tambahkan Properti IDL MFC:

• Nama properti

  Tentukan nama properti.

  Untuk dispinterface MFC yang terkait dengan kontrol ActiveX, Anda dapat memberikan nama Anda sendiri atau Anda dapat memilih nama properti stok dari daftar yang telah ditentukan sebelumnya. Jika Anda memberikan nama properti Anda sendiri, jenis implementasi Stok tidak tersedia.

  Untuk informasi selengkapnya tentang deskripsi properti stok dalam daftar, lihat properti stok.

  Jenis antarmuka	Opsi nama properti
  Antarmuka ganda ATL, antarmuka kustom, dan antarmuka kustom lokal	Berikan nama properti.
  Dispinterface MFC, dispinterface kontrol MFC ActiveX	Berikan nama properti atau pilih properti stok dari daftar. Jika Anda memilih properti dari daftar, nilai yang sesuai muncul dalam kotak Jenis properti. Anda dapat mengubah jenis ini, tergantung pada pilihan Jenis implementasi.

• Jenis properti

  Mengatur jenis properti yang Anda tambahkan.

  Untuk dispinterface MFC, berikan jenis Anda sendiri atau pilih dari daftar yang telah ditentukan sebelumnya. Jika Anda memberikan implementasi stok properti, Jenis properti adalah jenis stok dan tidak dapat diubah.

• Nama variabel

  Mengatur nama variabel anggota tempat properti dikaitkan.

  Secara default, nama variabelnya adalah m_PropertyName. Anda dapat mengedit nama ini.

  Bidang ini hanya terlihat untuk dispinterface MFC dan jika Anda menentukan variabel Anggota di bawah Jenis implementasi.

• Fungsi pemberitahuan

  Mengatur nama fungsi pemberitahuan yang dipanggil jika properti berubah.

  Secara default, nama fungsi pemberitahuan adalah OnPropertyNameChanged. Anda dapat mengedit nama ini.

  Bidang ini hanya terlihat untuk dispinterface MFC dan jika Anda menentukan variabel Anggota di bawah Jenis implementasi.

• Fungsi Get

  Mengatur nama fungsi untuk mendapatkan properti .

  Secara default, nama fungsi Get adalah GetPropertyName. Anda dapat mengedit nama ini.

  Jika Anda menghapus nama, fungsi GetNotSupported dimasukkan ke dalam peta pengiriman antarmuka.

  Bidang ini hanya terlihat untuk dispinterface MFC dan jika Anda menentukan metode Get/Set di bawah Jenis implementasi.

• Mengatur fungsi

  Mengatur nama fungsi untuk mengatur properti.

  Secara default, nama fungsi Set adalah SetPropertyName. Anda dapat mengedit nama ini.

  Jika Anda menghapus nama, fungsi SetNotSupported dimasukkan ke dalam peta pengiriman antarmuka.

  Bidang ini hanya terlihat untuk dispinterface MFC dan jika Anda menentukan metode Get/Set di bawah Jenis implementasi.

• Jenis implementasi

  Menentukan cara mengimplementasikan properti yang Anda tambahkan.

  Hanya tersedia untuk dispinterface MFC.

  Jenis implementasi	Deskripsi
  Stok	Menentukan implementasi default untuk properti yang dipilih dalam Nama properti. Untuk informasi selengkapnya, lihat properti stok. Jika Anda menentukan Stok, maka Jenis properti, Jenis parameter, dan Nama parameter diredupkan.
  Variabel anggota	Menambahkan properti sebagai variabel anggota. Anda dapat menambahkan properti kustom atau sebagian besar properti stok sebagai variabel anggota. Menyediakan nama default di bawah Nama variabel dan fungsi Pemberitahuan. Anda dapat mengedit nama ini. Anda tidak dapat menentukan variabel Anggota untuk Captionproperti , , hWndatau Text .
  Dapatkan/Atur metode	Menentukan properti ditambahkan sebagai Getfungsi PropertyName dan SetPropertyName secara default. Nama-nama ini muncul di bawah Fungsi Get dan Atur fungsi. Anda dapat mengubah jenis Properti default, yang meneruskan nilai untuk fungsi Get. Anda dapat menentukan parameter untuk Get fungsi dan Set .

• Properti default

  Mengatur properti sebagai default untuk antarmuka.

  Antarmuka hanya dapat memiliki satu properti default.

  Setelah Anda menentukan properti default, kotak centang ini tidak tersedia untuk properti lain yang Anda tambahkan ke antarmuka. Hanya tersedia untuk dispinterface MFC.

• Parameter

  Menampilkan parameter metode dan jenisnya.

• +

  Menambahkan parameter. Di Parameter, ketik jenis parameter dan nama dan pilih OK. Misalnya: int x

• x

  Menghapus parameter yang dipilih dari daftar Parameter.

• Ikon pensil

  Mengedit parameter terpilih.

• id

  Mengatur ID numerik yang mengidentifikasi properti .

  Opsi ini tidak tersedia untuk properti antarmuka kustom. Untuk informasi selengkapnya, lihat id di Referensi MIDL.

• helpcontext

  Menentukan ID konteks yang memungkinkan pengguna melihat informasi tentang properti ini di file Bantuan.

  Untuk informasi selengkapnya, lihat helpcontext di Referensi MIDL.

• helpstring

  Menentukan string karakter yang digunakan untuk menjelaskan elemen yang diterapkannya. Secara default, ini adalah propertyNama properti.

  Untuk informasi selengkapnya, lihat helpstring di Referensi MIDL.

Properti stok

Jika Anda menambahkan properti ke dispinterface MFC, Anda dapat memilih salah satu properti stok berikut dari daftar dropdown Nama properti:

Nama properti	Deskripsi
Appearance	Mengembalikan atau menetapkan nilai yang menentukan tampilan kontrol. Properti kontrol Appearance dapat menyertakan atau menghilangkan efek tampilan tiga dimensi. Properti ini adalah properti baca/tulis sekitar.
BackColor	Mengembalikan atau mengatur properti sekitar BackColor kontrol ke warna palet (RGB) atau warna sistem yang telah ditentukan sebelumnya. Secara default, nilainya sesuai dengan warna latar depan kontainer kontrol. Properti ini adalah properti baca/tulis sekitar.
BorderStyle	Mengembalikan atau mengatur gaya batas untuk kontrol. Properti ini adalah properti baca/tulis.
Caption	Mengembalikan atau mengatur properti kontrol Caption . Keterangannya adalah judul jendela. Caption tidak memiliki jenis implementasi variabel Anggota.
Enabled	Mengembalikan atau mengatur properti kontrol Enabled . Kontrol yang diaktifkan dapat merespons peristiwa yang dihasilkan pengguna.
Font	Mengembalikan atau mengatur font sekitar kontrol. Null jika kontrol tidak memiliki font.
ForeColor	Mengembalikan atau mengatur properti sekitar ForeColor kontrol.
hWnd	Mengembalikan atau mengatur properti kontrol hWnd . Tidak memiliki jenis implementasi variabel Anggota.
ReadyState	Mengembalikan atau mengatur properti kontrol ReadyState . Kontrol dapat tidak diinisialisasi, diinisialisasi, dimuat, interaktif, atau lengkap. Untuk informasi selengkapnya, lihat READYSTATE di Internet SDK.
Text	Mengembalikan atau mengatur teks yang terkandung dalam kontrol. Tidak memiliki jenis implementasi variabel Anggota.

Lihat Juga

Tambahkan Properti

Tambahkan Properti IDL