Office çözümlerinde WPF denetimlerini kullanma

  • Makale

Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan çözümler doğrudan Windows Forms denetimleriyle çalışacak şekilde tasarlanmış olsa da, çözümlerinizde WPF denetimlerini de kullanabilirsiniz. Windows Presentation Foundation (WPF), kullanıcı arabirimleri tasarlamak için Windows Forms'a bir alternatiftir. WPF, kullanıcı arabirimini, medyayı ve belgeleri birleştirmeye yönelik yeni teknikler sağlamak için Genişletilebilir Uygulama İşaretleme Dili (XAML) adlı bir işaretleme dili kullanır. Daha fazla bilgi için bkz. WPF'ye genel bakış.

Şunlar için geçerlidir: Bu konudaki bilgiler belge düzeyi projeler ve VSTO Eklenti projeleri için geçerlidir. Bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Bir Office çözümünde Windows Forms denetimlerini barındırabilen tüm UI öğeleri WPF denetimlerini de barındırabilir. Bu öğeler arasında aşağıdaki öğeler olabilir:

  • Belge düzeyi özelleştirmelerindeki belgeler ve çalışma sayfaları.

  • Belge düzeyi özelleştirmelerindeki eylemler bölmeleri.

  • VSTO Eklentileri'ndeki özel görev bölmeleri.

  • Outlook için VSTO Eklentileri'nde form bölgeleri.

Tasarım zamanında Office projelerine WPF denetimleri ekleme

Office çözümlerinde WPF denetimlerini doğrudan kullanıcı arabirimi öğelerine ekleyemezsiniz. Bunun yerine, projenize bir Kullanıcı Denetimi (WPF) öğesi ekleyin ve bunu WPF denetimleri için tasarım yüzeyi olarak kullanın. Ardından WPF kullanıcı denetimini projenizdeki bir kullanıcı arabirimi öğesine ekleyin.

Eylemler bölmesine, özel görev bölmesine veya form bölgesine WPF denetimleri eklemek için

  1. Özel görev bölmesi, eylemler bölmesi veya form bölgesi eklemek istediğiniz projeyi açın.

  2. Projenize bir Kullanıcı Denetimi (WPF) öğesi ekleyin.

  3. Araç Kutusu'ndan WPF kullanıcı denetimi tasarım yüzeyine WPF denetimleri ekleyin.

    Varsayılan olarak, WPF kullanıcı denetimi tasarımcısı açık olduğunda Araç Kutusu yalnızca WPF denetimlerini içerir.

  4. Projeyi derleyin.

  5. Projenize eylemler bölmesi, form bölgesi veya özel görev bölmesi ekleyin:

  6. Araç Kutusu'nun ProjectNameWPF Kullanıcı Denetimleri sekmesinden WPF kullanıcı denetimini eylemler bölmesi, form bölgesi veya özel görev bölmesi için tasarımcıya sürükleyin.

    Visual Studio, UI öğesinde WPF kullanıcı denetimini barındıran bir ElementHost nesneyi otomatik olarak oluşturur.

  7. Projeyi yeniden oluşturun.

Belge düzeyinde bir projede belgeye veya çalışma sayfasına WPF denetimleri eklemek için

  1. Word veya Excel için belge düzeyinde bir proje açın.

  2. Projenize bir Kullanıcı Denetimi (WPF) öğesi ekleyin.

  3. Araç Kutusu'ndan WPF kullanıcı denetimi tasarım yüzeyine WPF denetimleri ekleyin.

  4. Projeyi derleyin.

  5. Projeye bir Kullanıcı Denetimi öğesi (windows forms kullanıcı denetimi) ekleyin.

  6. Windows Forms kullanıcı denetimi için tasarımcıyı açın.

  7. Araç Kutusu'nun ProjectNameWPF Kullanıcı Denetimleri sekmesinden WPF kullanıcı denetimini tasarımcıya sürükleyin.

    Visual Studio, Windows Forms kullanıcı denetiminde WPF kullanıcı denetimini barındıran bir ElementHost nesneyi otomatik olarak oluşturur.

  8. Windows Forms kullanıcı denetimini program aracılığıyla belgeye veya çalışma kitabına ekleyen kod yazın. Daha fazla bilgi için bkz . Çalışma zamanında Office belgelerine denetim ekleme.

    Not

    Windows Forms kullanıcı denetimini tasarımcıdaki belgeye veya çalışma sayfasına sürükleyemezsiniz.

  9. Projeyi yeniden oluşturun.

ElementHost sınıfını kullanarak WPF denetimlerini barındırma

Visual Studio, Office çözümlerinizde Windows Forms denetimlerini kullanmanıza yardımcı olan özellikler sağlar, ancak WPF denetimleri için benzer özellikler sağlamaz. Örneğin, denetimleri Araç Kutusu'ndan sürükleyerek veya yardımcı yöntemleri kullanarak tasarım zamanında belgelere ve çalışma sayfalarına Windows Forms denetimleri ekleyebilirsiniz. Ancak, bu araçlar WPF denetimleri için kullanılamaz.

WPF denetimleri, sınıfını ElementHost bir Windows Forms denetimi veya formu ile WPF denetimleri arasında tümleştirme katmanı olarak kullanır. Tasarım zamanında çözümünüzde WPF denetimleri eklediğinizde, Visual Studio sizin için otomatik olarak bir ElementHost nesne oluşturur.

WPF kaynakları

Windows Forms denetimleri ve formlarında WPF denetimlerini barındırmaya yönelik mimari ve tasarım sorunları hakkında daha fazla bilgi için aşağıdaki konulara bakın:

Tasarım zamanında Visual Studio'daki Windows Forms denetimlerine ve formlarına WPF denetimleri ekleme hakkında daha fazla bilgi için aşağıdaki konulara bakın:

İlgili içerik