Özel Görev Bölmelerine Genel Bakış

Makale
08/01/2011

Görev bölmeleri, Microsoft Office uygulamasında genellikle pencerenin bir tarafına yerleştirilmiş kullanıcı arayüzü panelleridir. Özel görev bölmeleri, kendi görev bölmenizi oluşturmak ve kendi çözümünüzün özelliklerine erişmek için kullanıcılara bilinen bir arayüz sağlamak amacıyla bir yol sağlar. Örneğin arayüz, belgeyi değiştirmek veya veri kaynağından veri görüntülemek amacıyla kod çalıştırmak için denetimler içerebilir.

Uygulama alanı: Bu konudaki bilgiler şu uygulamaların uygulama düzeyi projelerine yöneliktir: Excel 2007 ve Excel 2010; InfoPath 2007 ve InfoPath 2010; Outlook 2007 ve Outlook 2010; PowerPoint 2007 ve PowerPoint 2010; Word 2007 ve Word 2010. Daha fazla bilgi için bkz. Office Uygulamalarında Kullanılabilir Özellikler ve Proje Türü.

Not

Özel görev bölmesi eylemler bölmesinden farklılık gösterir. Eylemler bölmesi, Microsoft Office Word ve Microsoft Office Excel için belge düzeyi özelleştirmelerinin bir parçasıdır. Daha fazla bilgi için bkz. Eylemler Bölmesine Genel Bakış.

Özel Görev Bölmelerinin Yararları

Özel görev bölmeleri, özelliklerinizi bilinen bir arayüzle tümleştirmenizi sağlar. Visual Studio araçlarını kullanarak hızlıca özel görev bölmesi oluşturabilirsiniz.

Bilinen Kullanıcı Arayüzü

Microsoft Office sistemindeki uygulamaların kullanıcılarına, görev bölmeleri zaten tanıdıktır, örn. Word'deki Stiller ve Biçimlendirme görev bölmesi. Özel görev bölmeleri, Microsoft Office sistemindeki diğer görev bölmeleri gibi davranır. Kullanıcılar özel görev bölmelerini uygulama penceresinin farklı taraflarına yerleştirebilirler veya bu bölmeleri pencerede herhangi bir konuma sürükleyebilirler. Çoklu özel görev bölmelerini aynı anda görüntüleyen bir eklenti oluşturabilirsiniz ve kullanıcılar her görev bölmesini ayrı ayrı denetleyebilir.

Windows Formu Desteği

Visual Studio'daki Office geliştirme araçlarını kullanarak oluşturduğunuz özel görev bölmesinin kullanıcı arayüzü, Windows Forms denetimlerine bağlıdır. Özel görev bölmesine kullanıcı arayüzü tasarlamak için, bilinen Windows Forms Tasarımcısını kullanabilirsiniz. Ayrıca görev bölmesindeki denetimlere veri kaynağı bağlamak için Windows Forms'taki veri bağlama desteğini kullanabilirsiniz.

Özel Görev Bölmesi Oluşturma

Basit özel görev bölmesini iki adımda oluşturabilirsiniz:

UserControl nesnesine Windows Forms denetimleri ekleyerek, özel görev bölmenizde bir arayüz oluşturun.
Kullanıcı denetimini eklentinizdeki CustomTaskPaneCollection nesnesine geçirerek özel görev bölmesini oluşturun. Bu koleksiyon, görev bölmesinin görüntüsünü değiştirmek ve kullanıcı olaylarına yanıt vermek için kullanabileceğiniz yeni bir CustomTaskPane nesnesini döndürür.

Adım adım yordamlar için bkz. Nasıl Yapılır: Uygulamaya Özel Görev Bölmesi Ekleme.

Kullanıcı Arayüzü Oluşturma

Visual Studio'daki Office geliştirme araçlarını kullanarak oluşturulan tüm özel görev bölmeleri, UserControl nesnesi içerir. Bu kullanıcı denetimi, özel görev bölmeniz için kullanıcı arayüzü sağlar. Kullanıcı denetimini tasarım veya çalışma zamanında oluşturabilirsiniz. Eğer kullanıcı denetimini tasarım zamanında oluşturursanız, Windows Forms Tasarımcısını görev bölmenizin kullanıcı arayüzünü yapılandırmak için kullanabilirsiniz.

Özel Görev Bölmesi Oluşturma

Özel görev bölmesinin kullanıcı arayüzünü içeren bir kullanıcı denetimi oluşturduktan sonra, CustomTaskPane oluşturmalısınız. Bunu yapmak için, Add yöntemlerinden birini çağırarak, eklentinizdeki CustomTaskPaneCollection'a kullanıcı denetimini geçirin. Bu koleksiyon, ThisAddIn sınıfının CustomTaskPanes alanı olarak oluşturulur. Aşağıdaki kod örneği, ThisAddIn sınıfından çalıştırılmak üzere tasarlanmıştır.

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;

Add yöntemleri, yeni bir CustomTaskPane nesnesi döndürür. Görev bölmesinin görüntüsünü değiştirmek ve kullanıcı olaylarına yanıt vermek için bu nesneyi kullanabilirsiniz.

Çoklu Pencerelerde Görev Bölmesini Denetleme

Özel görev bölmeleri, belgenin veya bir öğenin görüntüsünü kullanıcıya sunan bir belge çerçeve penceresiyle ilişkilidir. Görev bölmesi, sadece ilgili pencere görünür olduğunda görünürdür.

Hangi pencerenin özel görev bölmesini görüntüleyeceğini belirlemek için, görev bölmesini oluşturduğunuzda uygun Add yöntem yüklemesini kullanın:

Görev bölmesini etkin pencere ile ilişkilendirmek için, CustomTaskPaneCollection.Add(UserControl, String) yöntemini kullanın.
Belirli bir pencere tarafından barındırılan belgeyle özel görev bölmesini ilişkilendirmek için, CustomTaskPaneCollection.Add(UserControl, String, Object) yöntemini kullanın.

Bazı Office uygulamalar oluşturmak veya birden fazla pencere açık olduğunda, görev bölmesini görüntülemek ne zaman açıkça talimatlara gerektirir. Bu, görev bölmesinin uygulamadaki uygun belgelerler veya öğelerle göründüğüne emin olmak amacıyla, kodunuzdaki özel görev bölmesini nerede oluşturmanız gerektiğini göze almayı önemli kılar. Daha fazla bilgi için bkz. Özel Görev Bölmelerini Birden Çok Uygulama Penceresinden Yönetme.

Görev Bölmesinden Uygulamaya Erişme

Eğer uygulamayı kullanıcı denetiminden otomatikleştirmek istiyorsanız, kodunuzda Globals.ThisAddIn.Application'ı kullanarak nesne modeline doğrudan erişebilirsiniz. Statik Globals sınıfı, ThisAddIn nesnesine erişim sağlar. Bu nesnenin Application alanı, uygulamanın nesne modeline giriş noktasıdır.

ThisAddIn nesnesinin Application alanı hakkında daha fazla bilgi için, bkz. Uygulama Düzeyi Eklentileri Programlama. Özel görev bölmesinden bir uygulamanın nasıl otomatikleştirildiğini gösteren bir anlatım için, bkz. İzlenecek Yol: Uygulamayı Özel Görev Bölmesinden Otomatikleştirme. Globals sınıfı hakkında daha fazla bilgi için, bkz. Office Projeleri Nesnelerine Genel Erişim.

Görev Bölmesinin Kullanıcı Ara Birimini Yönetme

Görev bölmesini oluşturduktan sonra, görev bölmesinin kullanıcı arayüzünü denetlemek ve kullanıcı görev bölmesini değiştirdiğinde yanıt vermek için CustomTaskPane nesnesinin özelliklerini ve olaylarını kullanabilirsiniz.

Özel Görev Bölmesini Görünür Yapma

Varsayılan olarak, görev bölmeleri görünmezdir. Görev bölmelerini görünür yapmak için, Visible özelliğini true olarak ayarlamalısınız.

Kullanıcılar, görev bölmesinin köşesindeki Kapat düğmesine (X) basarak herhangi bir zamanda görev bölmesini kapatabilirler. Fakat, kullanıcıların özel görev bölmesini yeniden açması için varsayılan bir yol yoktur. Eğer kullanıcı özel görev bölmesini kapatırsa, kullanıcı özel görev bölmesini, siz onu görüntülemek için bir yol sağlamadıkça yeniden göremez.

Eğer eklentinizde özel görev bölmesi oluşturursanız, UI öğesi de oluşturmalısınız, örn. kullanıcının özel görev bölmesini görüntüleyip sakmalası için tıklayabileceği bir düğme. Eğer Şerit'i özelleştirmeyi destekleyen Microsoft Office uygulamasında özel görev bölmesi oluşturursanız, özel görev bölmesini gösteren ve saklayan bir düğme ile Şerit'e denetim grubunu ekleyebilirsiniz. Bunun nasıl yapılacağını gösteren yol için bkz. İzlenecek Yol: Özel Görev Bölmesini Şerit Düğmesi ile Eşitleme.

Eğer Şerit'i özelleştirmeyi desteklemeyen Microsoft Office uygulamasında özel görev bölmesi oluşturursanız, özel görev bölmesini gösteren ve saklayan CommandBarButton ekleyebilirsiniz.

Görev Bölmesinin Görüntüsünü Değiştirme

CustomTaskPane nesnesinin özelliklerini kullanarak özel görev bölmesinin boyutunu ve konumunu denetleyebilirsiniz. Özel görev bölmesindeki UserControl nesnesinin özelliklerini kullanarak özel görev bölmesinin görüntüsünde diğer birçok değişikliği de yapabilirsiniz. Örneğin, kullanıcı denetiminin BackgroundImage özelliğini kullanarak özel görev bölmesi için arka plan resmi belirleyebilirsiniz.

Aşağıdaki tabloda, CustomTaskPane özelliklerini kullanarak özel görev bölmesinde yapabileceğiniz değişiklikler listelenmiştir.

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 saklamak veya görünür yapmak için	Visible
Kullanıcının görev bölmesinin konumunu değiştirmesini engellemek için	DockPositionRestrict

Özel Görev Bölmesi Olaylarını Programlama

Eklentinizin, kullanıcı özel görev bölmesini değiştirdiğinde ona yanıt vermesini isteyebilirsiniz. Örneğin, eğer kullanıcı bölmenin hizalamasını dikeyden yataya değiştirirse, denetimleri yeniden konumlandırmak isteyebilirsiniz.

Aşağıdaki tabloda, kullanıcının özel görev bölmesinde yaptığı değişiklikleri yanıtlamanız için işlediğiniz olaylar listelenmiştir.

Görev	Olay
Kullanıcı görev bölmesinin konumunu değiştirdiğinde ona yanıt vermek için	DockPositionChanged
Kullanıcı görev bölmesinin sakladığında veya görünür kıldığında ona yanıt vermek için	VisibleChanged

Görev Bölmesi Tarafından Kullanılan Kaynakları Temizleme

Özel görev bölmesi oluşturduktan sonra, CustomTaskPane nesnesi, eklentiniz çalıştığı sürece bellekte kalır. Nesne, kullanıcı görev bölmesinin köşesindeki Kapat düğmesini (X) tıkladıktan sonra bile bellekte kalır.

Eklenti çalışırken görev bölmesi tarafından kullanılan kaynakları temizlemek için, Remove veya RemoveAt yöntemlerini kullanın. Bu yöntemler belirli CustomTaskPane nesnesini, CustomTaskPanes koleksiyonundan kaldırır ve nesnenin Dispose() yöntemini çağırır.

Eklenti kaldırıldığında, Visual Studio Tools for Office çalışma zamanı modülü özel görev bölmesinin kullandığı kaynakları otomatik olarak siler. Projenizde ThisAddIn_Shutdown olay işleyicisindeki Remove veya RemoveAt yöntemlerini çağırmayın. Bu yöntemler ObjectDisposedException oluşturur çünkü Visual Studio Tools for Office çalışma zamanı modülü, ThisAddIn_Shutdown çağrılmadan önce CustomTaskPane nesnesi tarafından kullanılan kaynakları temizler. ThisAddIn_Shutdown hakkında daha fazla bilgi için, bkz. Office Projelerindeki Olaylar.