Office belgelerindeki Windows Forms denetimlerine genel bakış

Windows Forms denetimleri, kullanıcıların verileri girmek veya işlemek için etkileşim kurabileceği nesnelerdir. Microsoft Office Excel ve Microsoft Office Word için belge düzeyindeki projelerde, tasarım zamanında projenizdeki belgeye veya çalışma kitabına Windows Forms denetimleri ekleyebilir veya bu denetimleri çalışma zamanında program aracılığıyla ekleyebilirsiniz. Excel veya Word için VSTO Eklentisi'nde bu denetimleri çalışma zamanında açık olan herhangi bir belgeye veya çalışma sayfasına program aracılığıyla ekleyebilirsiniz.

Daha fazla bilgi için bkz . Nasıl yapılır: Office belgelerine Windows Forms denetimleri ekleme.

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

Windows Forms denetimlerini kullanma

Eylemler bölmeleri, özel görev bölmeleri ve Windows Forms gibi belgelere ve özelleştirilebilir kullanıcı arabirimi (UI) öğelerine Windows Forms denetimleri ekleyebilirsiniz. Windows Forms denetimleri genellikle belgelerde bu diğer kullanıcı arabirimi öğeleriyle aynı davranışa sahiptir, ancak bazı farklılıklar vardır. Bilgi için bkz . Office belgelerindeki Windows Forms denetimlerinin sınırlamaları.

Bir belgeye veya başka bir kullanıcı arabirimi öğesine Windows Forms denetimleri eklenip eklenmeyeceğine karar vermek çeşitli faktörlere bağlıdır. Çözümünüzün kullanıcı arabirimini tasarlarken, aşağıdaki tabloda açıklandığı gibi Windows Forms denetimlerinin kullanımlarını göz önünde bulundurun.

Bir belgede.

  • Denetimleri %100 görüntülemek istediğinizde.

  • Kullanıcıların verileri doğrudan belgeye, örneğin düzenleme yüzeyinin kilitli olduğu form tabanlı belgelere girmesini istediğinizde.

  • Denetimlerin belgedeki verilerle aynı hizada görüntülenmesini istediğinizde. Örneğin, liste nesnesinin her satırına düğme ekliyorsanız, bunların her liste öğesiyle aynı hizada olmasını istersiniz.

Eylemler bölmesinde veya özel görev bölmesinde.

  • Kullanıcıya bağlamsal bilgiler sağlamak istediğinizde.

  • Sorgu denetimlerinin ve verilerin değil, yalnızca sonuçların belgede görünmesini istediğinizde.

  • Denetimlerin belgeyle birlikte yazdırılmadığından emin olmak istediğinizde.

  • Denetimlerin belgenin görünümüne müdahale etmediğinden emin olmak istediğinizde.

Bir Windows Formunda.

  • Kullanıcı arabiriminin boyutunu denetlemek istediğinizde.

  • Kullanıcıların denetimleri gizlemesini veya silmesini engellemek istediğinizde.

  • Kullanıcıdan giriş almak ve giriş alınana kadar kullanıcının belgede herhangi bir şey yapmasını engellemek istediğinizde.

Windows Forms denetimlerini program aracılığıyla ekleme

Çalışma zamanında Word belgelerine ve Excel çalışma sayfalarına Windows Forms denetimleri ekleyebilirsiniz. Office çalışma zamanı için Visual Studio Araçları, en yaygın Windows Forms denetimlerini eklemek için yardımcı yöntemler sağlar. Bu yardımcı yöntemler, Office belgenize hızla denetim eklemenizi ve bu denetimlerin birleşik Windows Forms denetim işlevselliğine ve Office ile ilgili işlevlerine erişmenizi sağlar.

Daha fazla bilgi için bkz . Çalışma zamanında Office belgelerine denetim ekleme.

Belge düzeyi projelerinde Windows Forms denetimlerini kullanma

Belgelerde Windows Forms denetimlerini kullanmanın bazı yönleri, belge düzeyi projelere özeldir ve bu da Visual Studio tasarımcısını kullanarak belgenizin kullanıcı arabirimini tasarlamanızı sağlar.

Özel kullanıcı denetimleri oluşturma

Projenize bir kullanıcı denetimi ekleyebilir ve ardından Araç Kutusu'na ekleyebilirsiniz. Daha sonra, belgenize Windows Forms denetimi eklemek gibi kullanıcı denetimini doğrudan belgenize sürükleyebilirsiniz. Kullanıcı denetimleri oluştururken aklınızda bulundurmanız gereken bazı şeyler vardır:

  • Korumalı bir kullanıcı denetimi oluşturmayın . Denetimi belgenize sürüklediğinizde, Visual Studio bunu genişletmek ve belgedeki kullanımını desteklemek için kullanıcı denetiminden türetilen bir sarmalayıcı sınıfı oluşturur. Kullanıcı denetimi korumalıysa, Visual Studio sarmalayıcı sınıfını oluşturamaz.

  • Kullanıcı denetimlerinin özniteliği true olarak ayarlanmalıdırComVisibleAttribute. Bir Office projesinde oluşturulan kullanıcı denetimlerinin varsayılan olarak bu özniteliği true olarak ayarlanmıştır, ancak dış projelerin parçası olan kullanıcı denetimlerinin bu özniteliği true olarak ayarlanmayabilir.

  • Belgeye bir kullanıcı denetimi ekledikten sonra, sınıfı projeden yeniden adlandırmayın veya silmeyin UserControl . Bir kullanıcı denetiminin adını değiştirmeniz gerekiyorsa, önce belgeden silmeniz ve ardından ad değiştirildikten sonra yeniden eklemeniz gerekir.

Denetimleri tasarım zamanında düzenleme

Word ve Excel belgelerinize tasarım zamanında birden çok denetim eklerseniz, Visual Studio'daki Microsoft Office Word ve Microsoft Office Excel araç çubuklarını kullanarak seçili tüm denetimlerin hizalamasını hızla ayarlayabilirsiniz. Bu araç çubukları yalnızca tasarımcıda bir belge veya çalışma sayfası açık olduğunda kullanılabilir.

Tasarımcıda birden çok denetim seçtiğinizde, denetimleri düzenlemek için bu araç çubuklarında aşağıdaki düğmeleri kullanabilirsiniz:

  • Sola Hizala

  • Merkezleri Hizala

  • Hakları Hizala

  • Üstleri Hizala

  • Ortaları Hizala

  • Altları Hizala

  • Yatay Aralığı Eşit Yap

  • Dikey Aralığı Eşit Yap

Not

Word projelerinde, bu düğmeler yalnızca seçili denetimler metinle aynı hizada değilse etkinleştirilir. Varsayılan olarak, tasarım zamanında belgeye eklediğiniz denetimler metinle uyumludur.

Yükleme sırasında Excel çalışma kitaplarında eski verilerin görünmesini engelleme

Tasarım zamanında belgelere veya çalışma sayfalarına Windows Forms denetimleri eklediğinizde, kullanıcı belgeyi kapattığında denetimler belgede kalır. Tasarım zamanında eklenen denetimlere statik denetimler de denir.

Statik denetimler içeren bir Excel çalışma kitabı açıldığında, özelleştirme kodu çalıştırılıp gerçek denetimi yükleyene kadar çalışma kitabı bir ActiveX denetiminde denetimin bit eşlemini görüntüler. Excel bu bit eşlemi oluşturur ve çalışma kitabı her kaydedildiğinde çalışma kitabında depolar. Bit eşlem, denetimin görüntülediği veriler de dahil olmak üzere çalışma kitabının son kaydedilişinde göründüğü şekilde gösterir. Windows Forms denetimleri ve bit eşlemleri içeren ActiveX denetimi hakkında daha fazla bilgi için bkz . Office belgelerinde Windows Forms denetimlerinin sınırlamaları.

Belirli koşullarda kod yüklenmez ve kullanıcının çalışma kitabını tasarım modunda açması gibi yalnızca bit eşlem görüntülenir. Ayrıca, kullanıcı çalışma kitabını Office çalışma zamanı için Visual Studio Araçları yüklü olmayan bir bilgisayarda açarsa, denetimleri yüklemek için özelleştirme çalıştırılamaz ve bu nedenle denetimin yalnızca bit eşlemi görünür. Kişisel bilgilerinizin yanlışlıkla açıklanmadığından emin olmak için çalışma kitabını kaydetmeden ve başka bir kullanıcıya göndermeden önce, çalışma kitaplarının denetimlerinden her zaman kişisel bilgileri kaldırmalısınız.

Excel çalışma sayfasında denetim boyutunu hücre boyutuyla eşleştirme

Üst hücrenin boyutu değiştirildiğinde denetimi otomatik olarak yeniden boyutlandırılacak şekilde ayarlayabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Çalışma sayfası hücrelerindeki denetimleri yeniden boyutlandırma.

Tüm çalışma sayfaları tarafından paylaşılan bileşenleri ekleme

Gibi tüm çalışma sayfaları arasında paylaşmak istediğiniz bileşenleri çalışma sayfaları DataSetyerine Çalışma Kitabı Tasarım Aracı ekleyebilirsiniz. Bileşen, bileşen tepsisinde görünür.

Excel çalışma sayfasına denetim ekleme formülü

Excel'de bir denetim seçtiğinizde Formül Çubuğu'nda =EMBED("WinForms.Control.Host","") ifadesini görürsünüz. Bu metin gereklidir ve silinmemelidir.

Word belgesinde denetimlerin düzen stili

Visual Studio tasarımcısını kullanarak belge düzeyindeki bir projede Word belgesine denetim eklediğinizde, denetim metinle aynı hizaya eklenir. Denetimin düzen stilini değiştirmek için, denetime sağ tıklayın ve ardından Denetimi Biçimlendir'e tıklayın. Nesneyi Biçimlendir iletişim kutusunun Düzen sayfasında bir kaydırma stili seçin.

Çalışma zamanında bir Word belgesine denetim eklediğinizde, sınıfın farklı Add<denetim sınıfı> yöntemi aşırı yüklemelerini kullanarak yeni denetimin ControlCollection düzen stilini belirtebilirsiniz:

  • Denetimi metinle aynı hizaya eklemek için, denetimin konumunu belirten bir Range kabul eden aşırı yükleme kullanın.

  • Denetimi kayan şekil olarak eklemek için denetimin sol ve üst koordinatlarını kabul eden bir aşırı yükleme kullanın.

    Daha fazla bilgi için bkz . Çalışma zamanında Office belgelerine denetim ekleme.

    Visual Studio tasarımcısında bir Word şablonu açarsanız, Visual Studio şablonu Normal görünümde açtığından, şablondaki satır içi olmayan denetimler görünmeyebilir. Denetimleri görüntülemek için görünümü Yazdırma Düzeni olarak değiştirin.

Ana belge gövdesi dışındaki denetimler

Windows Forms denetimleri üst bilgi veya alt bilgi içinde veya alt belge içinde desteklenmez.

Tasarım zamanında bileşen ekleme

Bazı denetimler veya bileşenler belgede görünmez ve bunun yerine bir bileşen tepsisinde görüntülenir. Visual Studio, her belge penceresi için bir bileşen tepsisi sağlar. Bileşen tepsisi yalnızca belgede bileşenler varsa ekranda görünür.