ActivationRegistrationManager.RegisterForFileTypeActivation Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert die App, wenn der angegebene Dateityp über ShellExecute, Launcher.LaunchFileAsyncoder die Befehlszeile geöffnet wird.
public:
static void RegisterForFileTypeActivation(Platform::Array <Platform::String ^> ^ supportedFileTypes, Platform::String ^ logo, Platform::String ^ displayName, Platform::Array <Platform::String ^> ^ supportedVerbs, Platform::String ^ exePath);/// [Windows.Foundation.Metadata.Experimental]
static void RegisterForFileTypeActivation(winrt::array_view <winrt::hstring const&> const& supportedFileTypes, winrt::hstring const& logo, winrt::hstring const& displayName, winrt::array_view <winrt::hstring const&> const& supportedVerbs, winrt::hstring const& exePath); static void RegisterForFileTypeActivation(winrt::array_view <winrt::hstring const&> const& supportedFileTypes, winrt::hstring const& logo, winrt::hstring const& displayName, winrt::array_view <winrt::hstring const&> const& supportedVerbs, winrt::hstring const& exePath);[Windows.Foundation.Metadata.Experimental]
public static void RegisterForFileTypeActivation(string[] supportedFileTypes, string logo, string displayName, string[] supportedVerbs, string exePath);public static void RegisterForFileTypeActivation(string[] supportedFileTypes, string logo, string displayName, string[] supportedVerbs, string exePath);function registerForFileTypeActivation(supportedFileTypes, logo, displayName, supportedVerbs, exePath)Public Shared Sub RegisterForFileTypeActivation (supportedFileTypes As String(), logo As String, displayName As String, supportedVerbs As String(), exePath As String)Parameter
- supportedFileTypes
-
String[]
Platform::String[]
winrt::hstring[]
Mindestens ein unterstützter Dateityp, der durch die Dateierweiterung angegeben wird, einschließlich der führenden ., z. B. .docx.
- logo
-
String
Platform::String
winrt::hstring
Der Pfad zum Image oder der Ressource, das von Windows für den Dateityp verwendet wird. Bei verpackten Apps ist dieser Parameter ein paketrelativer Pfad zu einer Bilddatei. Bei Entpackung ist dieser Parameter ein Literaldateipfad zu einer Binärdatei (DLL, EXE) sowie ein Ressourcenindex.
- displayName
-
String
Platform::String
winrt::hstring
Dieser Anzeigename, der von Windows für den Dateityp verwendet wird.
- supportedVerbs
-
String[]
Platform::String[]
winrt::hstring[]
Null oder mehr appdefinierte Verben. Jedes Verb wird dem Datei-Explorer Kontextmenü hinzugefügt, wenn eine registrierte Datei mit der rechten Maustaste geklickt wird, und das ausgewählte Verb wird als IFileActivatedEventArgs.Verb-Eigenschaft an die App übergeben.
- exePath
-
String
Platform::String
winrt::hstring
Der Pfad zur ausführbaren Datei, die aktiviert werden soll. Wenn Sie eine leere Zeichenfolge übergeben, wird die aktuelle ausführbare Datei standardmäßig aktiviert. In der Regel wird dieser Parameter angegeben, wenn der Aufrufer dieser Methode nicht die App selbst, sondern das Installationsprogramm der App ist.
- Attribute
Hinweise
Verpackte Apps sollten weiterhin ihr Appx-Manifest verwenden, um sich für die Dateityp-, Protokoll- oder Startaktivierung zu registrieren. Sie können dann entweder Microsoft.Windows.AppLifecycle.AppInstance.GetActivatedEventArgs oder Windows.ApplicationModel.AppInstance.GetActivatedEventArgs verwenden, um die Argumente bei der Aktivierung abzurufen.