C++/WinRT-Benennungskonventionen
Für C++/WinRT gelten die folgenden Namenskonventionen:
- Der Namespace winrt::impl ist für C++/WinRT reserviert und sollte nicht in Ihrer Anwendung verwendet werden.
- Im Namespace winrt gehören Namen, die mit einem Kleinbuchstaben beginnen, zu C++/WinRT, aber Sie können sie in Ihrer Anwendung verwenden. In der Dokumentation sind die Namen aufgeführt, für die Sie Überladung oder Spezialisierung durchführen können. Beispielsweise kann Ihre Anwendung für die Funktionsvorlage winrt::is_guid_of „specialize“ verwenden.
- In Unternamespaces des Namespaces winrt (mit Ausnahme von winrt::impl) sind Namen, die mit einem Großbuchstaben beginnen, für Ihre Anwendung verfügbar.
- In allen Namespaces sind Namen, die mit WINRT_IMPL_ beginnen, für C++/WinRT reserviert und sollten nicht in Ihrer Anwendung verwendet werden.
- In allen Namespaces sind Namen, die mit WINRT_ beginnen (mit Ausnahme derjenigen, die mit WINRT_IMPL_ beginnen) für C++/WinRT reserviert. Sie können sie verwenden, und in der Dokumentation sind die Namen aufgeführt, die von Ihrer Anwendung definiert werden können, z. B. WINRT_LEAN_AND_MEAN.
Es ist üblich, dass Anwendungen eine Namespacekomposition durchführen und Unternamespaces des Stammnamespace winrt in den winrt-Stammnamespace importieren:
namespace winrt
{
using namespace winrt::Windows::Foundation;
}
Daher sollte Ihre Anwendung die oben genannten Namenskonventionen in Unternamespaces des winrt-Namespaces einhalten.
Zusammenfassung:
Namespace | Name | Apps können definieren | Apps können verwenden |
---|---|---|---|
winrt::impl | Any | Nein | Nein |
winrt und Unternamespaces (mit Ausnahme von impl) | Beginnt mit einem Kleinbuchstaben | Nein | Ja |
winrt und Unternamespaces (mit Ausnahme von impl) | Beginnt mit einem Großbuchstaben | Ja | Ja |
Any | WINRT_IMPL_* | Nein | Nein |
Any | WINRT_* (außer WINRT_IMPL_*) | Fall für Fall | Ja |