Outlook form bölgeleri oluşturma

  • Makale

Microsoft Office Outlook formlarını özelleştirmek için form bölgelerini kullanabilirsiniz. Visual Studio, form bölgelerini tasarlamanızı, geliştirmenizi ve hatalarını ayıklamanızı kolaylaştıran gelişmiş araçlar sağlar.

Şunlar için geçerlidir: Bu konudaki bilgiler Outlook için 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.

Bu konuda, aşağıdaki bilgiler sağlanmaktadır:

Form bölgelerini kullanmanın avantajları

Form bölgeleri, geleneksel Outlook form geliştirmelerine göre birçok geliştirme sunar:

  • Herhangi bir standart formun varsayılan sayfasını özelleştirin.

  • Herhangi bir standart forma en fazla 12 ek sayfa ekleyin.

  • Herhangi bir standart formu değiştirin veya geliştirin.

  • Okuma Bölmesi'nde ve Denetçiler'de özel kullanıcı arabirimini görüntüleme.

    Daha fazla bilgi için bkz . Form sayfalarını ve form bölgelerini özelleştirme.

Projenize Outlook form bölgesi ekleme

Yeni bir form bölgesi tasarlamak veya Outlook'ta tasarlanmış bir form bölgesini içeri aktarmak için Yeni Outlook Form Bölgesi sihirbazını kullanabilirsiniz. Ayrıca, başka bir Outlook VSTO Eklentisi projesinde kullandığınız bir form bölgeniz varsa, mevcut form bölgenizi yeniden kullanabilirsiniz.

Sihirbazı kullanarak yeni form bölgesi oluşturma

Form bölgesi oluşturmak için, Outlook VSTO Eklenti projesine Bir Outlook Form Bölgesi öğesi ekleyin. Bu, Yeni Outlook Form Bölgesi sihirbazını başlatır.

Yeni bir form bölgesi tasarlamak mı yoksa Outlook'ta tasarlanmış bir form bölgesini içeri aktarmak mı istediğinizi belirtmek için sihirbazı kullanın. Yeni form bölgesi tasarlama hakkında daha fazla bilgi için bkz . Form bölgesi tasarımcısını kullanma. Outlook'ta tasarlanmış bir form bölgesi kullanma hakkında daha fazla bilgi için bkz . Outlook'ta tasarlanmış bir form bölgesini içeri aktarma.

Oluşturmak istediğiniz form bölgesinin türünü belirtmek için sihirbazı kullanın. Aşağıdaki tabloda her form bölgesi türü açıklanmaktadır.

Bölge türü Açıklama
Ayır Form bölgesini Outlook formunda yeni bir sayfa olarak ekler.
Bitişik Form bölgesini Outlook formunun varsayılan sayfasının en altına ekler.
Değiştirme Form bölgesini, Outlook formunun varsayılan sayfasının yerini alan yeni bir sayfa olarak ekler.
Tümünü değiştir Outlook formunun tamamını form bölgesiyle değiştirir.

Görüntü koşullarını belirtmek ve genişletecek form türünü seçmek için sihirbazı da kullanabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Outlook Eklenti projesine form bölgesi ekleme.

Sihirbazda yaptığınız seçimler, diğer sihirbaz sayfalarında kullanılabilen seçenekleri etkiler. Örneğin, Yeni Outlook Form Bölgesi Oluştur sayfasında Bitişik veya Ayrı'yıseçerseniz, Açıklayıcı metin sağlayın sayfasında Başlık ve Açıklama alanları kullanılamaz ve görüntüleme tercihlerinizi seçin. Bunun nedeni, Outlook'un bitişik veya ayrı bir form bölgesi görüntülerken bu alanları kullanmamasıdır.

Form bölgesi dosyaları

Yeni Outlook Form Bölgesi sihirbazını tamamladığınızda, Visual Studio projenize otomatik olarak aşağıdaki dosyaları ekler:

  • Form bölgesi kod dosyası. Bu dosya, Yeni Öğe Ekle iletişim kutusunda Outlook Form Bölgesi öğesi için belirttiğiniz ada sahiptir. Bu dosyaya form bölgesi olaylarını işlemek için kod ekleyin.

  • Form bölgesi tasarımcısı kod dosyası. Bu dosya, form bölgesi tasarımcısı tarafından oluşturulan kodu içerir ve doğrudan düzenlenmemelidir.

  • Outlook Form Depolama (.ofs) dosyası.

    Not

    Bu dosya yalnızca Outlook'ta tasarlanmış bir form bölgesini içeri aktarırsanız projeye eklenir.

Form bölgesi fabrika sınıfı

Form bölgesi kod dosyası, arabirimini uygulayan IFormRegionFactory kısmi bir sınıf içerir. Bu, form bölgesi fabrika sınıfıdır. Form bölgesi fabrika sınıfı, form bölgesinin yeni örneklerini oluşturmakla sorumludur.

Form Region Factory bölgesini genişleterek bu sınıfı bulabilirsiniz.

Yeni Outlook Form Bölgesi sihirbazı, bu sınıfa form bölgesinin iç adını ve form bölgesini görüntüleyen ileti sınıflarını belirten öznitelikler ekler. Dosya projeye eklendikten sonra bu öznitelikleri el ile değiştirebilirsiniz.

Form bölgesi fabrika sınıfının çoğu, form bölgesi tasarımcısı dosyasında uygulanır. Ancak, FormRegionInitializing olay işleyicisi form bölgesi kod dosyasında kullanıma sunulur. Outlook'un form bölgesini görüntüleyip görüntülemeyeceğini belirtmek için bu olay işleyicisini kullanabilirsiniz. Daha fazla bilgi için bkz . Form bölgesi olaylarını işleme.

Projenize mevcut form bölgesini ekleme

Başka bir Outlook projesinde kullandığınız bir Outlook form bölgeniz varsa, Varolan Öğe Ekle iletişim kutusunu kullanarak bunu geçerli Outlook VSTO Eklenti projenizde yeniden kullanabilirsiniz.

Varolan form bölgesinde bir kod dosyası (.vb veya .cs) olmalıdır; Varolan Öğe Ekle iletişim kutusunu kullanarak Outlook Form Depolama (.ofs) dosyaları ekleyemezsiniz. Ancak, Outlook Form Depolama dosyasını içeri aktararak yeni bir form bölgesi oluşturabilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Outlook Eklenti projesine form bölgesi ekleme.

Form bölgesi tasarımcısını kullanma

Form bölgesi tasarımcısı, form bölgesinin düzenini ve görünümünü tasarlamanıza yardımcı olur. Yönetilen denetimleri tasarımcının yüzeyine sürükleyebilir, olay işleyicilerini açmak için denetimlere çift tıklayabilir ve Özellikler penceresinde özellikleri ayarlayabilirsiniz.

Not

Form bölgesinin Görünümünü etkileyen özellikleri, Özellikler penceresinde bildirim düğümünü altındaki Outlook'ta bulabilirsiniz.

Form bölgesi tasarımcısı, yalnızca Yeni Outlook Form Bölgesi sihirbazının Form bölgesini nasıl oluşturmak istediğinizi seçin sayfasında Yeni Form Bölgesi Tasarla'nın seçilmesi durumunda kullanılabilir.

Form bölgesi tasarımcısını açmanın üç yolu vardır:

  • Çözüm Gezgini'da form bölgesi kod dosyasına çift tıklayın.

  • Çözüm Gezgini'da, form bölgesi kod dosyasına sağ tıklayın ve ardından Tasarım Aracı Görüntüle'ye tıklayın.

  • Çözüm Gezgini form bölge kodu dosyasını seçin ve görünüm menüsünde Tasarım Aracı'e tıklayın.

    Form bölgesi tasarımcısı yalnızca yönetilen denetimleri destekler. Yerel Outlook denetimleri ekleyemezsiniz.

Outlook'ta tasarlanmış bir form bölgesini içeri aktarma

Outlook'ta tasarım yaparken, form bölgesine yerel Outlook denetimleri ekleyebilirsiniz. Yerel Outlook denetimleri, tasarım zamanında Outlook verilerine bağlanmanızı sağlar. Ancak, yönetilen denetimler eklemek veya form bölgesinin tasarımını değiştirmek için form bölgesi tasarımcısını kullanamazsınız.

Yeni Outlook Form Bölgesi sihirbazını kullanarak form bölgelerini bir Outlook VSTO Eklenti projesine aktarabilirsiniz. Form bölgesini nasıl oluşturmak istediğinizi seçin sayfasında Outlook Form Depolama (.ofs) dosyasını içeri aktar'ı seçin. Daha sonra bir Outlook Form Depolama dosyası (.ofs) dosyasının konumuna göz atabilirsiniz. (Outlook form bölgelerini .ofs dosyaları olarak kaydeder.)

Yeni Outlook Form Bölgesi sihirbazı .ofs dosyasını proje dizinine kopyalar ve form bölgesi tasarımcısı dosyasına denetim başvuruları ekler. Daha sonra denetim olaylarını form bölgesi kod dosyasında işleyebilirsiniz.

Visual Basic projesindeki olayları işlemek için Kod Düzenleyicisi'nin üst kısmındaki yöntem adı listesinden bir olay seçin.

C# projesindeki olayları işlemek için yöntemindeki denetim olaylarına FormRegionShowing abone olun. Daha fazla bilgi için bkz . Nasıl yapılır: Olaylara abone olma ve abonelikten çıkma (C# programlama kılavuzu).

Form bölgesi fabrika sınıfının yönteminde InitializeManifest form bölgesi özelliklerini değiştirebilirsiniz.

Not

Form bölgesini içeri aktarmak için, geliştirme bilgisayarına yüklediğiniz Outlook'un aynı sürümünü hedefleyen bir projede çalışıyor olmanız gerekir. Örneğin, Outlook 2010 yüklüyse, form bölgesini içeri aktarmak yalnızca Outlook 2010 Eklenti proje şablonu kullanılarak oluşturulmuş bir projede çalışır.

İçeri aktarılan form bölgesinin tasarımını güncelleştirme

Form bölgesine denetim ekleyebilir, kaldırabilir veya değiştirebilirsiniz. Bunu yapmadan önce, form bölgesi kod dosyasına eklediğiniz tüm kodları yedekleyin. Ardından Outlook'ta .ofs dosyasını açın, form bölgesini değiştirin ve değişiklikleri kaydedin. Değiştirilen .ofs dosyasını içeri aktarmak için Yeni Outlook Form Bölgesi sihirbazını kullanın. Ardından kodunuzu yeni form bölgesi kod dosyasına yapıştırabilirsiniz.

Form bölgesine özel kod ekleme

Ad Microsoft.Office.Tools.Outlook alanı, form bölgesini temsil eden sınıflara, form bölgesini görüntüleyen Outlook öğesine ve diğer yararlı öğelere erişmenizi sağlar. Outlook Form Bölgesi öğesi, projede bu derlemeye otomatik olarak bir başvuru ekler ve form bölgesi kod dosyasının en üstüne uygun using veya Imports deyimini ekler.

Outlook programlama görevlerinizin çoğunu gerçekleştirmek için ad alanında Microsoft.Office.Interop.Outlook sınıfları, yöntemleri ve özellikleri kullanabilirsiniz. Outlook nesne modeli hakkında daha fazla bilgi için bkz . Outlook nesne modeline genel bakış. Outlook nesne modelini kullanan tipik görevlere örnekler için bkz . Outlook çözümleri.

Form bölgesi olaylarını işleme

Outlook Form Bölgesi öğesi, form bölgesi kod dosyasına otomatik olarak aşağıdaki üç olay işleyicisini ekler.

Olay Açıklama
FormRegionInitializing Form bölgesi başlatılmadan önce gerçekleşir. Outlook'un form bölgesini görüntülemesi gerekip gerekmediğini belirlemek için bu olay işleyicisindeki koşulları de kontrol edebilirsiniz. Daha fazla bilgi için bkz . Nasıl yapılır: Outlook'un form bölgesi görüntülemesini engelleme.
FormRegionShowing Form bölgesinin bir örneği oluşturulduktan sonra ancak form bölgesi görünmeden önce gerçekleşir.
FormRegionClosed Form bölgesi kapatılana kadar gerçekleşir.

Projeyi derleme

Form bölgesi içeren bir Outlook VSTO Eklenti projesi oluşturduğunuzda, Visual Studio kayıt defterine aşağıdaki bilgileri ekler:

  • Bir veya daha fazla form bölgesiyle ilişkili her ileti sınıfı için bir anahtar.

  • Her form bölgesi için bir girdi ve Outlook VSTO Eklentisinin adını temsil eden ilişkili bir değer.

    Outlook, form bölgelerini yüklemek için bu bilgileri kullanır.

Form bölgesinde hata ayıklama

Diğer Visual Studio projelerinde olduğu gibi form bölgesi içeren bir Outlook VSTO Eklentisinde de hata ayıklayabilirsiniz. Visual Studio hata ayıklayıcısını başlattığınızda, Visual Studio otomatik olarak Outlook'u başlatır.

Form bölgesini görüntülemek için uygun Outlook öğesini açmanız gerekir. Örneğin, bir posta öğesinin altına bitişik form bölgesi eklenirse, bir posta öğesi açın.

Form bölgesi dağıtma

Form bölgeleri, ilişkili Outlook VSTO Eklentisi ile otomatik olarak dağıtılır. Bu nedenle, form bölgesini dağıtmak için herhangi bir özel görev gerçekleştirmeniz gerekmez. VSTO Eklentilerini dağıtma hakkında daha fazla bilgi için bkz . Office çözümü dağıtma.

Ünvan Açıklama
Outlook form bölgeleri oluşturma yönergeleri Form bölgelerinizi iyileştirmenize ve olası sorunlardan kaçınmanıza yardımcı olabilecek bilgiler sağlar.
Nasıl yapılır: Outlook Eklenti projesine form bölgesi ekleme Yeni Outlook Form Bölgesi sihirbazını kullanarak standart veya özel bir Microsoft Office Outlook formunu genişletmek için form bölgesi oluşturmayı gösterir.
Form bölgesini Outlook ileti sınıfıyla ilişkilendirme Form bölgesini her öğenin ileti sınıfıyla ilişkilendirerek hangi Microsoft Office Outlook öğelerinin form bölgesi görüntüleyeceğini belirtmeyi açıklar.
İzlenecek yol: Outlook form bölgesi tasarlama Kişi öğesinin Denetçi penceresinde yeni bir sayfa olarak görünen özel form bölgesinin nasıl tasarlandığını gösterir.
İzlenecek yol: Outlook'ta tasarlanmış bir form bölgesini içeri aktarma Microsoft Office Outlook'ta form bölgesi tasarlamayı ve ardından Yeni Outlook Form Bölgesi sihirbazını kullanarak form bölgesini Outlook VSTO Eklentisi projesine aktarmayı gösterir.
Çalışma zamanında form bölgesine erişme Form bölgesindeki denetimleri göstermek, gizlemek veya değiştirmek için kod yazmayı ve kullanıcıların sınıfını kullanarak projenizdeki diğer alanlardan kodu çalıştırmasını sağlamayı Globals açıklar.
Nasıl yapılır: Outlook'un form bölgesini görüntülemesini engelleme Microsoft Office Outlook'un belirli bir öğe için form bölgesi görüntülemesini engellemeyi gösterir.
Form bölgesinin göründüğü Outlook öğesine nasıl erişebileceğinizi gösterir.
Outlook form bölgelerindeki özel eylemler Kullanıcıların bir Outlook öğesine nasıl yanıt vermesinin etkinleştirileceği açıklanır.