Outlook form bölgeleri oluşturma

Şunlar için geçerlidir:yes Mac noiçin Visual Studio noVisual Studio Visual Studio Code

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 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, var olan form bölgenizi yeniden kullanabilirsiniz.

Sihirbazı kullanarak yeni form bölgesi oluşturma

Form bölgesi oluşturmak için, Outlook VSTO Eklenti projesine 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ü Description
Ayrı 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üleme 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 veyaAyrı'yı seçerseniz, Açıklayıcı metin sağlayın sayfasındaBaşlık ve Açıklama alanları kullanılamaz ve görüntüleme tercihlerinizi seçin. Bunun nedeni, Outlook'un bir bitişik veya ayrı 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 projeye yalnızca Outlook'ta tasarlanmış bir form bölgesini içeri aktardığınızda 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ı 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.

Mevcut form bölgesinin bir kod dosyası (.vb veya .cs) olmalıdır; Varolan Öğe Ekle iletişim kutusunu kullanarak Outlook Form Depolama (.ofs) dosyalarını 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 Outlook'ta , Özellikler penceresinde bildirim düğümünü altında görüntülenme biçimini etkileyen özellikleri bulabilirsiniz.

Form bölgesi tasarımcısının kullanılabilmesi için , 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 gerekir.

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

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

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

  • Çözüm Gezgini'nde form bölgesi kod dosyasını seçin ve görünüm menüsündeTasarımcı'ya 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. Ardından form bölgesi kod dosyasında denetim olaylarını 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 FormRegionShowing denetim olaylarına 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 projedeki 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örevlerin örnekleri 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 Description
FormRegionInitializing Form bölgesi başlatılmadan önce gerçekleşir. Outlook'un form bölgesini görüntüleyip görüntülemeyeceğ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üntülenmeden ö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

Form bölgesi içeren bir Outlook VSTO Eklentisinde, diğer Visual Studio projelerinde olduğu gibi 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, posta öğesini 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.

Başlık 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ğinin nasıl belirtileceğini 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 Eklenti 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ölgesi 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üntülendiği Outlook öğesine nasıl erişebileceğinizi gösterir.
Outlook form bölgelerindeki özel eylemler Kullanıcıların bir Outlook öğesine yanıt vermesinin nasıl etkinleştirileceği açıklanır.