Windows uygulamasında dosya etkinleştirmeyi işleme

Uygulamanız, belirli bir dosya türü için varsayılan işleyici olmak üzere kaydolabilir. Hem Windows masaüstü uygulamaları hem de WinUI uygulamaları varsayılan dosya işleyicisi olmak üzere kaydolabilir. Kullanıcı uygulamanızı belirli bir dosya türü için varsayılan işleyici olarak seçerse, bu dosya türü başlatıldığında uygulamanız etkinleştirilir.

Yalnızca bu dosya türü için tüm dosya başlatma işlemlerini işlemeyi bekliyorsanız bir dosya türüne kaydolmanızı öneririz. Uygulamanızın yalnızca dahili olarak dosya türünü kullanması gerekiyorsa, varsayılan işleyici olmak için kaydolmanız gerekmez. Bir dosya türüne kaydolmayı seçerseniz, uygulamanız bu dosya türü için etkinleştirildiğinde beklenen işlevselliği son kullanıcıya sağlamanız gerekir. Örneğin, bir resim görüntüleyici uygulaması .jpg dosyasını görüntülemek için kaydolabilir. Dosya ilişkilendirmeleri hakkında daha fazla bilgi için bkz. Dosya türleri ve URI'ler için yönergeler.

Bu adımlarda özel bir dosya türü olan .alsdk'ye kaydolma ve kullanıcı bir .alsdk dosyası başlattığında uygulamanızı etkinleştirme adımları gösterilmektedir.

Uyarı

Windows'ta, bazı URI'ler ve dosya uzantıları yerleşik uygulamalar ve işletim sistemi tarafından kullanılmak üzere ayrılmıştır. Ayrılmış bir URI veya dosya uzantısıyla uygulamanızı kaydetme girişimleri göz ardı edilir. Ayrılmış veya yasak olduğundan uygulamalarınıza kaydedemediğiniz alfabetik bir Uri düzenleri listesi için bkz. Ayrılmış URI düzeni adları ve dosya türleri .

Önemli API'ler

Bu konuda aşağıdaki API'ler kullanılır:

1. Adım: Paket bildiriminde uzantı noktasını belirtin

Uygulama yalnızca paket bildiriminde listelenen dosya uzantıları için etkinleştirme olaylarını alır. Uygulamanızın .alsdk uzantısına sahip dosyaları işlediğini şu şekilde belirtirsiniz.

  1. Çözüm Gezgini'nde package.appxmanifest dosyasına çift tıklayarak bildirim tasarımcısını açın. Bildirimler sekmesini seçin ve Kullanılabilir Bildirimler açılan listesinde Dosya Türü İlişkilendirmeleri'ni seçin ve ekle'ye tıklayın. Dosya ilişkilendirmeleri tarafından kullanılan tanımlayıcıların diğer ayrıntıları için bkz. Programlı Tanımlayıcılar .

    Bildirim tasarımcısında doldurabileceğiniz alanların her birinin kısa bir açıklaması aşağıdadır:

Veri Alanı Açıklama
Görünen Ad Bir dosya türü grubu için görünen adı belirtin. Görünen ad, Denetim Masası'ndakiVarsayılan Programları Ayarla'da dosya türünü tanımlamak için kullanılır.
Logo Masaüstünde ve Denetim Masası'ndakiVarsayılan Programları Ayarla'da dosya türünü tanımlamak için kullanılan logoyu belirtin. Logo belirtilmezse uygulamanın küçük logosu kullanılır.
Bilgi İpucu Bir dosya türü grubu için bilgi ipucunu belirtin. Bu araç ipucu metni, kullanıcı bu türdeki bir dosyanın simgesinin üzerine geldiğinde görünür.
İsim Aynı görünen adı, logoyu, bilgi ipucunu ve düzenleme bayraklarını paylaşan dosya türleri grubu için bir ad seçin. Uygulama güncelleştirmeleri arasında aynı kalabilecek bir grup adı seçin. Not Ad küçük harflerle yazılmalıdır.
İçerik Türü Belirli bir dosya türü için image/jpeg gibi MIME içerik türünü belirtin. İzin verilen içerik türleri hakkında Önemli Not: Ayrılmış veya yasak olduğundan paket bildirimine giremeyeceğiniz MIME içerik türlerinin alfabetik bir listesi aşağıdadır: application/force-download, application/octet-stream, application/unknown, application/x-msdownload.
Dosya türü Dosya türünü, örneğin ".jpeg" gibi, başına bir nokta koyarak kaydettirin. Ayrılmış ve yasak dosya türleri: Ayrılmış veya yasak olduğundan WinUI uygulamalarınıza kaydedemediğiniz yerleşik uygulamalar için dosya türlerinin alfabetik bir listesi için bkz. Ayrılmış URI düzeni adları ve dosya türleri .
  1. alsdk olarak Ad girin.
  2. .alsdk olarak Dosya Türü girin.
  3. Logo olarak "images\Icon.png" yazın.
  4. Package.appxmanifest dosyasının değişikliğini kaydetmek için Ctrl+S tuşlarına basın.

Yukarıdaki adımlarda paket bildirimine bunun gibi bir Uzantı öğesi eklenir. windows.fileTypeAssociation kategorisi, uygulamanın .alsdk belirtilen uzantıya sahip dosyaları işlediğini gösterir.

      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap:FileTypeAssociation Name="alsdk">
            <uap:Logo>images\icon.png</uap:Logo>
            <uap:SupportedFileTypes>
              <uap:FileType>.alsdk</uap:FileType>
            </uap:SupportedFileTypes>
          </uap:FileTypeAssociation>
        </uap:Extension>
      </Extensions>

2. Adım: Uygun simgeleri ekleme

Bir dosya türü için varsayılan olan uygulamaların simgeleri sistem genelinde çeşitli yerlerde görüntülenir. Örneğin, bu simgeler şu şekilde gösterilir:

  • Windows Gezgini Öğeleri Görünümü, bağlam menüleri ve Şerit
  • Varsayılan programlar Denetim Masası
  • Dosya seçici
  • Başlangıç ekranında arama sonuçları

Logonuzun bu konumlarda görünmesi için projenize 44x44 simgesi ekleyin. Uygulama kutucuğu logosunun görünümünü eşleştirin ve simgeyi saydam hale getirmek yerine uygulamanızın arka plan rengini kullanın. Logonun dolgu olmadan kenara kadar uzanmasını sağlayın. Simgelerinizi beyaz arka planlarda test edin. Daha fazla bilgi için bkz Kutucuk ve simge varlıkları için yönergeler.

3. Adım: Etkinleştirilmiş olayı işleme

OnFileActivated olay işleyicisi tüm dosya etkinleştirme olaylarını alır.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation
       // The number of files received is args.Files.Count
       // The name of the first file is args.Files[0].Name
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& args)
{
    // TODO: Handle file activation.
    auto numberOfFilesReceived{ args.Files().Size() };
    auto nameOfTheFirstFile{ args.Files().GetAt(0).Name() };
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
    // TODO: Handle file activation
    // The number of files received is args->Files->Size
    // The name of the first file is args->Files->GetAt(0)->Name
}

Uyarı

Dosya Sözleşmesi aracılığıyla başlatıldığında, Geri düğmesinin kullanıcıyı uygulamanın önceki içeriğine değil, uygulamayı başlatan ekrana geri aldığından emin olun.

Uyarı

WinUI uygulamasında, App.OnLaunched'da (veya aslında herhangi bir zamanda) etkinleştirilmiş olay args'lerini almak için (AppInstance.GetActivatedEventArgs) çağrısı yapabilir ve uygulamanın nasıl etkinleştirildiğini belirlemek için bunları kontrol edebilirsiniz. UWP ve WinUI uygulamaları arasındaki yaşam döngüsü farklılıkları hakkında daha fazla bilgi için bkz. Uygulama yaşam döngüsü işlevselliği geçişi .

Yeni bir sayfa açan her etkinleştirme olayı için yeni bir XAML Çerçevesi oluşturmanızı öneririz. Bu şekilde, yeni XAML Çerçevesi için gezinti arka yığını, uygulamanın askıya alındığında geçerli pencerede içerebileceği önceki içeriği içermez. Başlatma ve Dosya Sözleşmeleri için tek bir XAML Çerçevesi kullanmaya karar verirseniz, yeni bir sayfaya geçmeden önce Çerçeve'nin gezinti günlüğündeki sayfaları temizlemeniz gerekir.

Uygulamanız Dosya etkinleştirme yoluyla başlatıldığında, kullanıcının uygulamanın en üst sayfasına geri dönmesine izin veren kullanıcı arabirimini dahil etmeyi göz önünde bulundurmalısınız.

Açıklamalar

Aldığınız dosyalar güvenilmeyen bir kaynaktan gelebilir. Üzerinde işlem gerçekleştirmeden önce dosyanın içeriğini doğrulamanızı öneririz.

İlgili içerik

  • Last updated on