Bagikan melalui

Cara: Mengelola Simbol

  • Artikel

Saat Anda membuat sumber daya atau objek sumber daya baru, lingkungan pengembangan menetapkan nama simbol default, misalnya, IDD_DIALOG1. Anda dapat menggunakan jendela Properti untuk mengubah nama simbol default atau untuk mengubah nama simbol apa pun yang sudah terkait dengan sumber daya.

Untuk simbol yang terkait dengan satu sumber daya, Anda juga dapat menggunakan jendela Properti untuk mengubah nilai simbol. Anda dapat menggunakan kotak dialog Simbol Sumber Daya untuk mengubah nilai simbol yang saat ini tidak ditetapkan ke sumber daya.

Biasanya semua definisi simbol disimpan di Resource.h. Namun, Anda mungkin perlu mengubah ini termasuk nama file sehingga Anda dapat, misalnya, bekerja dengan lebih dari satu file sumber daya di direktori yang sama.

Catatan

Jika proyek Anda belum berisi file .rc, lihat Cara: Membuat Sumber Daya.

Pembatasan Nama Simbol

Pembatasan nama simbol adalah sebagai berikut:

  • Semua simbol harus unik dalam lingkup aplikasi untuk mencegah definisi simbol yang bertentangan dalam file header.

  • Karakter yang valid untuk nama simbol termasuk A-Z, a-z, 0-9, dan garis bawah ( _ ).

  • Nama simbol tidak dapat dimulai dengan angka dan dibatasi hingga 247 karakter.

  • Nama simbol tidak boleh berisi spasi.

  • Nama simbol tidak peka huruf besar/kecil, tetapi kasus definisi simbol pertama dipertahankan.

    File header yang menentukan simbol digunakan oleh pengkompilasi/editor sumber daya dan program C++ untuk merujuk sumber daya yang ditentukan dalam file sumber daya. Untuk dua nama simbol yang berbeda hanya jika, program C++ akan melihat dua simbol terpisah sementara pengkompilasi/editor sumber daya akan melihat kedua nama sebagai mengacu pada satu simbol tunggal.

Catatan

Jika Anda tidak mengikuti skema nama simbol standar (ID*_[kata kunci]) yang diuraikan di bawah ini dan nama simbol Anda kebetulan sama dengan kata kunci yang diketahui oleh pengompilasi skrip sumber daya, mencoba membangun file skrip sumber daya akan mengakibatkan pembuatan kesalahan yang tampaknya acak yang sulit didiagnosis. Untuk mencegah hal ini, patuhi skema penamaan standar.

Nama simbol memiliki awalan deskriptif yang menunjukkan jenis sumber daya atau objek yang diwakilinya. Awalan deskriptif ini dimulai dengan ID kombinasi teks. Pustaka Microsoft Foundation Class (MFC) menggunakan konvensi penamaan simbol yang diperlihatkan dalam tabel berikut:

Kategori Awalan Menggunakan
Sumber IDR_, IDD_, IDC_, IDI_, IDB_ Akselerator atau menu (dan sumber daya terkait atau kustom), kotak dialog, kursor, ikon, bitmap
Item menu ID_ Item menu
Perintah ID_ Perintah
Kontrol dan jendela anak IDC_ Menguasai
String ID_ String dalam tabel string
MFC AFX_ Dicadangkan untuk simbol MFC yang telah ditentukan sebelumnya

Untuk mengubah nama simbol (ID)

  1. Di Tampilan Sumber Daya, pilih sumber daya.

  2. Di jendela Properti , ketik nama simbol baru atau pilih dari daftar simbol yang ada di kotak ID .

    Jika Anda mengetik nama simbol baru, nama simbol tersebut secara otomatis diberi nilai.

Catatan

Anda dapat menggunakan kotak dialog Simbol Sumber Daya untuk mengubah nama simbol yang saat ini tidak ditetapkan ke sumber daya.

Pembatasan Nilai Simbol

Nilai simbol dapat berupa bilangan bulat apa pun yang dinyatakan dengan cara normal untuk #define arahan praprosedur. Berikut adalah beberapa contoh nilai simbol:

18
4001
0x0012
-3456

Nilai simbol untuk sumber daya seperti akselerator, bitmap, kursor, kotak dialog, ikon, menu, tabel string, dan informasi versi, harus berupa angka desimal dalam rentang 0 hingga 32.767 tetapi tidak boleh heksadesimal. Nilai simbol untuk bagian sumber daya, seperti kontrol kotak dialog atau string individual dalam tabel string, bisa dari 0 hingga 65.534 atau dari -32.768 hingga 32.767. Untuk informasi selengkapnya tentang rentang angka, lihat TN023: Sumber Daya MFC Standar.

Simbol sumber daya adalah angka 16-bit. Anda dapat memasukkannya sebagai ditandatangani atau tidak ditandatangani, namun, mereka digunakan secara internal sebagai bilangan bulat yang tidak ditandatangani, sehingga angka negatif akan ditransmisikan ke nilai positif yang sesuai.

Beberapa batasan nilai simbol adalah:

  • Lingkungan pengembangan Visual Studio dan MFC menggunakan beberapa rentang angka untuk tujuan khusus. Semua angka dengan bit set paling signifikan (-32.768 hingga -1 atau 32.768 hingga 65.534, tergantung pada tanda tangan) dicadangkan oleh MFC.

  • Anda tidak dapat menentukan nilai simbol menggunakan string simbol lainnya. Misalnya, definisi simbol berikut tidak didukung:

    #define IDC_MYEDIT  IDC_OTHEREDIT  //not supported

  • Anda tidak dapat menggunakan makro praprosesor dengan argumen sebagai definisi nilai. Contoh berikut bukan ekspresi yang valid terlepas dari apa yang ID dievaluasi pada waktu kompilasi:

    #define   IDD_ABOUT  ID(7) //not supported

  • Aplikasi Anda mungkin memiliki file yang sudah ada yang berisi simbol yang ditentukan dengan ekspresi.

Untuk mengubah nilai simbol

  1. Di Tampilan Sumber Daya, pilih sumber daya.

  2. Di jendela Properti , ketik nama simbol diikuti dengan tanda sama dengan dan bilangan bulat dalam kotak ID , misalnya:

    IDC_EDITNAME=5100

    Nilai baru disimpan dalam file header simbol saat Anda menyimpan proyek berikutnya. Hanya nama simbol yang tetap terlihat dalam kotak ID dan tanda dan nilai yang sama tidak ditampilkan setelah divalidasi.

Ubah atau Hapus Simbol

Saat berada dalam kotak dialog Simbol Sumber Daya, Anda dapat mengedit atau menghapus simbol yang sudah ada yang belum ditetapkan ke sumber daya atau objek.

Untuk mengubah simbol yang tidak ditetapkan

  1. Dalam kotak Nama , pilih simbol yang tidak ditetapkan, dan pilih Ubah.

  2. Edit nama atau nilai simbol dalam kotak yang disediakan dalam kotak dialog Ubah Simbol .

Catatan

Untuk mengubah simbol yang ditetapkan ke sumber daya atau objek, Anda harus menggunakan editor sumber daya atau jendela Properti .

Untuk menghapus simbol yang tidak ditetapkan (tidak digunakan)

Dalam kotak dialog Simbol Sumber Daya, pilih simbol yang ingin Anda hapus, dan pilih Hapus.

Catatan

Sebelum menghapus simbol yang tidak digunakan dalam file sumber daya, pastikan simbol tersebut tidak digunakan di tempat lain dalam program atau oleh file sumber daya yang disertakan pada waktu kompilasi.

Sertakan Simbol

Pertama kali lingkungan pengembangan membaca file sumber daya yang dibuat oleh aplikasi lain, lingkungan tersebut menandai semua file header yang disertakan sebagai baca-saja. Meskipun Anda dapat menggunakan kotak dialog Menyertakan Sumber Daya untuk menambahkan file header simbol baca-saja tambahan.

Salah satu alasan Anda mungkin ingin menggunakan definisi simbol baca-saja adalah untuk file simbol yang Anda rencanakan untuk dibagikan di antara beberapa proyek.

Anda juga dapat menggunakan file simbol yang disertakan saat Anda memiliki sumber daya yang ada dengan definisi simbol yang menggunakan ekspresi daripada bilangan bulat sederhana untuk menentukan nilai simbol. Contohnya:

#define   IDC_CONTROL1 2100
#define   IDC_CONTROL2 (IDC_CONTROL1+1)

Lingkungan akan menginterpretasikan simbol terhitung ini dengan benar selama:

  • Simbol terhitung ditempatkan dalam file simbol baca-saja.

  • File sumber daya Anda berisi sumber daya yang simbol terhitung ini sudah ditetapkan.

  • Ekspresi numerik diharapkan.

Catatan

Jika string atau ekspresi numerik diharapkan, ekspresi tidak dievaluasi.

Untuk menyertakan simbol bersama (baca-saja) dalam file sumber daya Anda

  1. Di Tampilan Sumber Daya, klik kanan file .rc Anda dan pilih Termasuk Sumber Daya.

  2. Dalam kotak Direktif simbol baca-saja, gunakan #include direktif pengkompilasi untuk menentukan file tempat Anda ingin simbol baca-saja disimpan.

    Jangan panggil file Resource.h, karena itu adalah nama file yang biasanya digunakan oleh file header simbol utama.

    Catatan

    Apa yang Anda ketik dalam kotak direktif simbol Baca-Saja disertakan dalam file sumber daya persis saat Anda mengetiknya. Pastikan apa yang Anda ketik tidak berisi kesalahan ejaan atau sintaks.

    Gunakan kotak Direktif simbol baca-saja untuk menyertakan file dengan definisi simbol saja. Jangan sertakan definisi sumber daya, definisi sumber daya duplikat lain akan dibuat saat file disimpan.

  3. Tempatkan simbol dalam file yang Anda tentukan.

    Simbol dalam file yang disertakan dengan cara ini dievaluasi setiap kali Anda membuka file sumber daya, tetapi tidak diganti pada disk saat Anda menyimpan file Anda.

  4. Pilih OK.

Untuk mengubah nama file header simbol sumber daya

  1. Di Tampilan Sumber Daya, klik kanan file .rc Anda dan pilih Termasuk Sumber Daya.

  2. Dalam kotak File header simbol, ketik nama baru untuk file sertakan.

Persyaratan

Win32

Lihat juga

Pengidentifikasi Sumber Daya (Simbol)
Cara: Membuat Simbol
ID Simbol yang telah ditentukan sebelumnya