Bagikan melalui

Konvensi penamaan C++/WinRT

  • Artikel

C++/WinRT telah menetapkan konvensi penamaan berikut:

  • Namespace winrt::impl dicadangkan untuk C++/WinRT, dan Anda tidak boleh menggunakannya dalam aplikasi Anda.
  • Di namespace winrt, nama yang dimulai dengan huruf kecil milik C++/WinRT, tetapi Anda dapat menggunakannya dalam aplikasi Anda. Dokumentasi memanggil nama-nama yang dapat Anda kelebihan beban atau spesialisasi. Misalnya, aplikasi Anda diizinkan untuk mengkhususkan templat fungsi winrt::is_guid_of .
  • Di sub-namespace namespace winrt (kecuali winrt ::impl), nama yang dimulai dengan huruf besar tersedia untuk aplikasi Anda.
  • Di semua namespace, nama yang dimulai dengan WINRT_IMPL_ dicadangkan untuk C++/WinRT, dan Anda tidak boleh menggunakannya dalam aplikasi Anda.
  • Di semua namespace, nama yang dimulai dengan WINRT_ (kecuali yang dimulai dengan WINRT_IMPL_) dicadangkan untuk C++/WinRT. Anda dapat menggunakannya, dan dokumentasi memanggil nama-nama yang mungkin ditentukan oleh aplikasi Anda, seperti WINRT_LEAN_AND_MEAN.

Umum bagi aplikasi untuk melakukan komposisi namespace, dan mengimpor sub-namespace layanan namespace layanan akar winrt ke dalam namespace layanan akar winrt :

namespace winrt
{
    using namespace winrt::Windows::Foundation;
}

Oleh karena itu, aplikasi Anda harus mematuhi konvensi penamaan di atas di sub-namespace layanan namespace winrt .

Berikut ringkasannya.

Ruang nama Nama Aplikasi dapat menentukan Aplikasi dapat menggunakan
winrt::impl Mana pun Tidak Tidak
winrt dan sub-namespace (kecuali impl) Dimulai dengan huruf kecil Tidak Ya
winrt dan sub-namespace (kecuali impl) Dimulai dengan huruf besar Ya Ya
Mana pun WINRT_IMPL_* Tidak Tidak
Mana pun WINRT_* (kecuali WINRT_IMPL_*) Kasus per kasus Ya