C++/WinRT-naamconventies

C++/WinRT heeft de volgende naamconventies vastgesteld:

  • De winrt::impl-naamruimte is gereserveerd voor C++/WinRT en u mag deze niet gebruiken in uw toepassing.
  • In de winrt-naamruimte horen namen die beginnen met een kleine letter bij C++/WinRT, maar u kunt deze in uw toepassing gebruiken. De documentatie wijst de namen aan die u kunt overbelasten of specialiseren. Bijvoorbeeld mag uw toepassing de functiesjabloon winrt::is_guid_of specialiseren.
  • In subnaamruimten van de winrt-naamruimte (met uitzondering van winrt::impl) zijn namen die beginnen met een hoofdletter beschikbaar voor uw toepassing.
  • In alle naamruimten zijn namen die beginnen met WINRT_IMPL_ gereserveerd voor C++/WinRT en moet u deze niet gebruiken in uw toepassing.
  • In alle naamruimten zijn namen die beginnen met WINRT_ (behalve namen die beginnen met WINRT_IMPL_) gereserveerd voor C++/WinRT. U kunt die gebruiken, en in de documentatie worden de namen vermeld die door uw toepassing kunnen worden gedefinieerd, zoals WINRT_LEAN_AND_MEAN.

Het is gebruikelijk dat toepassingen naamruimtesamenstelling uitvoeren en subnaamruimten van de winrt-hoofdnaamruimte importeren in de winrt-hoofdnaamruimte:

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

Daarom moet uw toepassing voldoen aan de bovenstaande naamconventies in subnaamruimten van de winrt-naamruimte .

Hier volgt een samenvatting.

Namespace Name Apps kunnen definiƫren Apps kunnen gebruikmaken van
winrt::impl Welk dan ook No No
winrt - en subnaamruimten (behalve impl) Begint met een kleine letter No Yes
winrt - en subnaamruimten (behalve impl) Begint met hoofdletters Yes Yes
Welk dan ook WINRT_IMPL_* No No
Welk dan ook WINRT_* (behalve WINRT_IMPL_*) Case-by-case Yes