Özel görev bölmeleri

Görev bölmeleri, genellikle bir uygulamanın bir penceresindeki bir tarafına yerleştirilen kullanıcı arabirimi Microsoft Office panelleridir. Özel görev bölmeleri size kendi görev bölmenizi oluşturmanın ve kullanıcılara çözüm özelliklerine erişmek için tanıdık bir arabirim sağlamanın bir yolunu sağlar. Örneğin, arabirim, belgeleri değiştirmek veya bir veri kaynağındaki verileri görüntülemek için kod çalıştıran denetimler içerebilir.

Uygulama hedefi: Bu konudaki bilgiler, - Outlook IÇIN VSTO eklentisi projelerine yöneliktir. Daha fazla bilgi için bkz. Office uygulaması ve proje türü tarafından kullanılabilen özellikler.

Not

Özel görev bölmesi, eylemler bölmesinden farklıdır. Eylemler bölmesi, Word ve Microsoft Office için belge düzeyinde özelleştirmelerin Microsoft Office Excel. Daha fazla bilgi için bkz. Eylemler bölmesine genel bakış.

Özel görev bölmelerinin avantajları

Özel görev bölmeleri, özelliklerinizi tanıdık bir kullanıcı arabirimiyle tümleştirebilirsiniz. Özel görev bölmesini hızlı bir şekilde oluşturmak için Visual Studio kullanabilirsiniz.

Tanıdık kullanıcı arabirimi

Microsoft Office sistemdeki uygulamaların kullanıcıları, Word'de Stiller ve Biçimlendirme görev bölmesi gibi görev bölmelerini kullanmayı zaten biliyor. Özel görev bölmeleri, özel sistemde diğer görev Microsoft Office davranır. Kullanıcılar özel görev bölmelerini uygulama penceresinin farklı tarafına yerleştirebilir veya özel görev bölmelerini pencere içinde herhangi bir konuma sürükleyebilir. Aynı anda birden VSTO özel görev bölmesi görüntüleyen bir eklenti oluşturabilirsiniz ve kullanıcılar her görev bölmesini tek tek kontrol eder.

Windows formları desteği

Visual Studio Forms denetimlerini temel alan Office kullanarak Visual Studio özel görev bölmesinin Windows kullanıcı arabirimi. Kullanıcı arabirimini özel bir Windows için tasarlamak üzere FormLar Tasarımcısı'nın tanıdık kullanıcı arabirimini kullanabilirsiniz. Veri kaynağını görev bölmesindeki denetimlere bağlamak Windows Formlar'daki veri bağlama desteğini de kullanabilirsiniz.

Özel görev bölmesi oluşturma

İki adımda temel bir özel görev bölmesi oluşturabilirsiniz:

  1. Bir nesneye Formlar denetimleri ekleyerek özel görev bölmeniz için Windows arabirimi UserControl oluşturun.

  2. Özel görev bölmesinin örneğini oluşturmak için kullanıcı denetimi eklentinizin VSTO CustomTaskPaneCollection ekleyin. Bu koleksiyon, görev CustomTaskPane bölmesinin görünümünü değiştirmek ve kullanıcı olaylarına yanıt vermek için kullanabileceğiniz yeni bir nesne döndürür.

    Daha fazla bilgi için, bkz. How to: Add a custom task pane to an application.

Kullanıcı arabirimini oluşturma

uygulama geliştirme araçları kullanılarak oluşturulan tüm özel Office bölmeleri Visual Studio UserControl içerir. Bu kullanıcı denetimi, özel görev bölmenizin kullanıcı arabirimini sağlar. Kullanıcı denetimi tasarım zamanında veya çalışma zamanında oluşturabilirsiniz. Tasarım zamanında kullanıcı denetimi oluşturursanız, görev bölmenizin kullanıcı arabirimini oluşturmak için Windows Forms Tasarımcısı'nda kullanabilirsiniz.

Özel görev bölmesinin örneğini oluşturma

Özel görev bölmesinin kullanıcı arabirimini içeren bir kullanıcı denetimi oluşturduk sonra, bir örneği oluşturmanız CustomTaskPane gerekir. Bunu yapmak için, yöntemlerinden birini çağırarak VSTO eklentinizin içinde kullanıcı CustomTaskPaneCollection Add denetimine geçiş. Bu koleksiyon, sınıfının CustomTaskPanes alanı olarak ortaya ThisAddIn çıkar. Aşağıdaki kod örneğinin sınıfından çalışması ThisAddIn amaçlanan bir örnektir.

myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True
myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;

Yöntemler Add yeni bir nesnesi geri CustomTaskPane döner. Görev bölmesinin görünümünü değiştirmek ve kullanıcı olaylarına yanıt vermek için bu nesneyi kullanabilirsiniz.

Görev bölmesini birden çok windows'da denetleme

Özel görev bölmeleri, kullanıcıya bir belgenin veya öğenin görünümünü sunan bir belge çerçevesi penceresiyle ilişkilendirildi. Görev bölmesi yalnızca ilişkili pencere görünür olduğunda görünür.

Özel görev bölmesini hangi pencerede görüntüleyeni belirlemek için, görev bölmesini Add ekleyebilirsiniz:

  • Görev bölmesini etkin pencereyle ilişkilendirmek için yöntemini Add kullanın.

  • Görev bölmesini belirtilen bir pencere tarafından barındırılan bir belgeyle ilişkilendirmek için yöntemini Add kullanın.

    Bazı Office uygulamaları, görev bölmenizi oluşturmak veya görüntülemek için birden fazla pencere açık olduğunda açık yönergeler gerektirir. Bu, görev bölmesinin uygulamadaki uygun belgeler veya öğelerle birlikte göründüğünden emin olmak için kodunda özel görev bölmesinin nerede örneğini oluşturmanın gerekli olduğunu göz önünde bulundurabilirsiniz. Daha fazla bilgi için bkz. Uygulama pencerelerde özel görev bölmelerini yönetme.

Uygulamaya Görev Bölmesinden erişme

Uygulamayı kullanıcı denetiminden otomatikleştirmek için kodunda kullanarak nesne modeline Globals.ThisAddIn.Application doğrudan erişebilirsiniz. Statik Globals sınıf nesnesine erişim ThisAddIn sağlar. Bu Application nesnenin alanı, uygulamanın nesne modeline giriş noktasıdır.

Nesnesinin alanı hakkında Application daha fazla bilgi için ThisAddIn bkz. Program VSTO Eklentileri. Bir uygulamayı özel görev bölmesinden otomatikleştirmeyi gösteren bir kılavuz için bkz. Adım adım kılavuz: Özel görev bölmesinden uygulama otomatikleştirme. sınıfı hakkında daha fazla Globals bilgi için bkz. Office projelerinde nesnelere genel erişim.

Görev Bölmesinin kullanıcı arabirimini yönetme

Görev bölmesini oluşturdukta, görev bölmesinin kullanıcı arabirimini kontrol etmek ve kullanıcı görev bölmesini değiştirirken yanıt vermek için nesnenin özelliklerini CustomTaskPane ve olaylarını kullanabilirsiniz.

Özel Görev Bölmesini görünür yapma

Görev bölmesi varsayılan olarak görünür değildir. Görev bölmesini görünür yapmak için özelliğini Visible true olarak ayarlayabilirsiniz.

Kullanıcılar, görev bölmesinin köşesindeki Kapat düğmesine (X) tıklayarak bir görev bölmesini istediğiniz zaman kapatabilirsiniz. Ancak, kullanıcıların özel görev bölmesini yeniden açması için varsayılan bir yol yoktur. Bir kullanıcı özel görev bölmesini kapatırsa, özel görev bölmesini görüntülemenin bir yolunu sağlamadıkça bu kullanıcı özel görev bölmesini yeniden görüntüleyebilirsiniz.

VSTO Eklentiniz içinde özel bir görev bölmesi ekleyebilirsiniz. Ayrıca, kullanıcıların özel görev bölmenizi görüntülemek veya gizlemek için tıklayabilirsiniz düğme gibi bir kullanıcı arabirimi öğesi de oluşturmanız gerekir. Şerit özelleştirmeyi destekleyen bir Microsoft Office uygulama içinde özel bir görev bölmesi ekleyebilirsiniz, özel görev bölmenizi görüntüleyen veya gizleyen bir düğmeyle Şerit'e bir denetim grubu ekleyebilirsiniz. Bunun nasıl olduğunu gösteren bir izlenecek yol için bkz. Kılavuz: Şerit düğmesiyle özel görev bölmesini eşitleme.

Şerit özelleştirmesini desteklemez bir Microsoft Office özel görev bölmesi ekleyebilirsiniz, özel görev bölmenizi görüntüler CommandBarButton veya gizler.

Görev bölmesinin görünümünü değiştirme

Nesnenin özelliklerini kullanarak özel görev bölmesinin boyutunu ve konumunu CustomTaskPane kontrolleyebilirsiniz. Özel görev bölmesinde bulunan nesnenin özelliklerini kullanarak özel görev bölmesinin UserControl görünümüne başka birçok değişiklik yapabilirsiniz. Örneğin, kullanıcı denetimi özelliğini kullanarak özel görev bölmesi için bir arka BackgroundImage plan görüntüsü belirtebilirsiniz.

Aşağıdaki tabloda, özellikleri kullanarak özel görev bölmesinde gerçekleştirebilirsiniz değişiklikler CustomTaskPane listeleyebilirsiniz.

Görev Özellik
Görev bölmesinin boyutunu değiştirmek için Height

Width
Görev bölmesinin konumunu değiştirmek için DockPosition
Görev bölmesini gizlemek veya görünür hale etmek için Visible
Kullanıcının görev bölmesinin konumunu değiştirmesini önlemek için DockPositionRestrict

Program özel görev bölmesi olayları

Kullanıcı özel görev bölmesini VSTO için eklentinizin yanıt vermelerini istemeniz gerekir. Örneğin, kullanıcı bölmenin yönünü dikeyden yataya değiştirirse denetimleri yeniden konumlandırmak iyi olabilir.

Aşağıdaki tabloda, kullanıcının özel görev bölmesine ekleyebilirsiniz değişikliklere yanıt vermek için işleyebilirsiniz olayları listeler.

Görev Olay
Kullanıcı görev bölmesinin konumunu değiştirirken yanıt vermek için. DockPositionChanged
Kullanıcı görev bölmesini gizler veya görünür hale geldiğinde yanıt vermek için. VisibleChanged

Görev bölmesi tarafından kullanılan kaynakları temizleme

Özel bir görev bölmesi oluşturdukta, eklentinizin çalışma VSTO CustomTaskPane nesne bellekte kalır. Kullanıcı görev bölmesinin köşesindeki Kapat düğmesine (X) tıkladığında bile nesne bellekte kalır.

Görev bölmesi tarafından kullanılan kaynakları, VSTO çalışırken temizlemek için veya Remove RemoveAt yöntemlerini kullanın. Bu yöntemler belirtilen nesneyi CustomTaskPane koleksiyondan CustomTaskPanes kaldırır ve Dispose nesnesinin yöntemini çağırarak.

, özel görev bölmesi tarafından kullanılan kaynakları, eklenti Office çalışma zamanı için Visual Studio Araçları VSTO otomatik olarak temizler. Projenizin olay Remove RemoveAt işleyicisinde veya yöntemlerini ThisAddIn_Shutdown çağırmayın. Bu yöntemler, nesnesi tarafından ObjectDisposedException kullanılan Office çalışma zamanı için Visual Studio Araçları kaynakları çağrılmadan önce temizleyene CustomTaskPane bir ThisAddIn_Shutdown oluşturur. hakkında daha fazla bilgi için ThisAddIn_Shutdown bkz. Office projelerinde olaylar.

Birden çok uygulama penceresinde özel görev bölmelerini yönetme

Belge ve diğer öğeleri görüntülemek için birden çok pencere kullanan bir uygulamada özel görev bölmesi ekleyebilirsiniz. Kullanıcı, görev bölmesinin görünür olmasını beklediğinizde görev bölmesinin görünür olduğundan emin olmak için ek adımlar atması gerekir.

Tüm uygulamalarda özel görev bölmeleri, bir belge veya öğenin kullanıcıya görünümünü sunan bir belge çerçevesi penceresiyle ilişkilendirilmektedir. Görev bölmesi yalnızca ilişkili pencere görünür olduğunda görünür. Ancak, tüm uygulamalar belge çerçevesi pencerelerini aynı şekilde kullanmaz.

Aşağıdaki uygulama gruplarının farklı geliştirme gereksinimleri vardır:

Outlook

Outlook için özel bir görev bölmesi oluşturduğunuzda, özel görev bölmesi belirli bir gezgin veya ınspector penceresiyle ilişkilendirilir. Araştırıcılar, bir klasörün içeriğini görüntüleyen ve Inspectors, bir e-posta iletisi veya bir görev gibi bir öğe görüntüleyen bir Windows.

Birden çok gezgin veya Inspector penceresi içeren özel bir görev bölmesi göstermek istiyorsanız, bir gezgin veya Denetçi penceresi açıldığında özel görev bölmesinin yeni bir örneğini oluşturmanız gerekir. Bunu yapmak için, bir gezgin veya Denetçi penceresi oluşturulduğunda oluşan bir olayı işleyin ve ardından olay işleyicisinde görev bölmesini oluşturun. Ayrıca, hangi pencerenin görünür olduğuna bağlı olarak görev bölmelerini gizlemek veya göstermek için Gezgin ve Inspector olaylarını da işleyebilirsiniz.

Görev bölmesini belirli bir gezgin veya Inspector ile ilişkilendirmek için, Add yöntemini kullanarak görev bölmesini oluşturun ve Explorer veya Inspector nesnesini pencere parametresine geçirin. Özel görev bölmeleri oluşturma hakkında daha fazla bilgi için bkz. özel görev bölmeleri genel bakış.

Outlook bir özel görev bölmesinin birden fazla örneğini engelle

Outlook windows 'un bir özel görev bölmesinin birden çok örneğini görüntülemesini engellemek için, CustomTaskPanes her pencere kapatıldığında özel görev bölmesini sınıfın koleksiyonundan açıkça kaldırın ThisAddIn . Yöntemi, Remove veya gibi bir pencere kapatıldığında oluşan bir olayda çağırın Close Close .

özel görev bölmesini açıkça kaldırmadıysanız Outlook windows, özel görev bölmesinin birden fazla örneğini görüntüleyebilir. Outlook bazen pencereleri geri dönüştürür ve geri dönüşümlü pencereler, bunlara eklenmiş olan özel görev bölmeleriyle ilgili başvuruları korur.

Word, InfoPath ve PowerPoint

Word, ınfopath ve PowerPoint her bir belgeyi farklı bir belge çerçevesi penceresinde görüntüler. Bu uygulamalar için özel bir görev bölmesi oluşturduğunuzda, özel görev bölmesi yalnızca belirli bir belgeyle ilişkilendirilir. Kullanıcı farklı bir belge açarsa, önceki belge yeniden görünene kadar özel görev bölmesi gizlenir.

Birden çok belgeyle özel bir görev bölmesi göstermek istiyorsanız, Kullanıcı yeni bir belge oluşturduğunda veya var olan bir belgeyi açtığında özel görev bölmesinin yeni bir örneğini oluşturun. Bunu yapmak için, bir belge oluşturulduğunda veya açıldığında oluşturulan olayları işleyin ve ardından olay işleyicilerinde görev bölmesini oluşturun. Ayrıca, hangi belgenin görünür olduğuna bağlı olarak görev bölmelerini gizlemek veya göstermek için belge olaylarını işleyebilirsiniz.

görev bölmesini belirli bir belge penceresiyle ilişkilendirmek için, Add görev bölmesini oluşturmak için yöntemini kullanın ve Window pencere parametresine (for Word), WindowObject (ınfopath için) veya documentwindow (PowerPoint için) geçirin.

Word olayları

Word 'deki Belge pencerelerinin durumunu izlemek için aşağıdaki olayları işleyebilirsiniz:

InfoPath olayları

InfoPath 'teki Belge pencerelerinin durumunu izlemek için aşağıdaki olayları işleyebilirsiniz:

PowerPoint olaylar

PowerPoint belge pencerelerinin durumunu izlemek için aşağıdaki olayları işleyebilirsiniz:

Ayrıca bkz.