Aracılığıyla paylaş


Eylemler bölmesine genel bakış

Önemli

Eylemler özelliği, Office 2024'ten itibaren Microsoft Word'den kullanımdan kaldırıldı. Bu özellik yalnızca aşağıdaki Office sürümleriyle birlikte Microsoft Word'de kullanılabilir:

  • Microsoft 365
  • Ofis LTSC Profesyonel Artı 2021
  • Ofis LTSC Standardı 2021
  • Ofis Profesyonel Artı 2016, 2019
  • Ofis Standardı 2016, 2019

Eylemler bölmesi, belirli bir Microsoft Office Word belgesine veya Microsoft Office Excel çalışma kitabına eklenmiş özelleştirilebilir Belge Eylemleri görev bölmesidir. Eylemler bölmesi, Excel'deki XML Kaynağı görev bölmesi veya Word'deki Stilleri ve Biçimlendirme görev bölmesi gibi diğer yerleşik görev bölmeleriyle birlikte Office görev bölmesinin içinde barındırılır. Eylemler bölmesi kullanıcı arabirimini tasarlamak için Windows Forms denetimlerini veya WPF denetimlerini kullanabilirsiniz.

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

Eylemler bölmesini yalnızca Word veya Excel için belge düzeyi özelleştirmesinde oluşturabilirsiniz. VSTO Eklentisinde eylemler bölmesi oluşturamazsınız. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre mevcut özellikler.

Uyarı

Eylemler bölmesi özel görev bölmelerinden farklıdır. Özel görev bölmeleri belirli bir belgeyle değil uygulamayla ilişkilendirilir. Bazı Microsoft Office uygulamaları için VSTO Eklentileri'nde özel görev bölmeleri oluşturabilirsiniz. Daha fazla bilgi için bkz. Özel görev bölmeleri.

Eylemler bölmesini görüntüleme

Eylemler bölmesi ActionsPane sınıfı tarafından temsil edilir. Belge düzeyinde proje oluşturduğunuzda, projenizdeki ActionsPane (Excel için) veya ThisWorkbook (Word için) sınıfının ThisDocument alanı kullanılarak bu sınıfın bir örneği kodunuz için kullanılabilir. Eylemler bölmesini görüntülemek için, Controls alanının ActionsPane özelliğine bir Windows Forms denetimi ekleyin. Aşağıdaki kod örneği eylemler bölmesine actions adlı bir denetim ekler.

this.ActionsPane.Controls.Add(actions);

Çalışma zamanında, uygulamaya açıkça bir denetim eklediğinizde eylemler bölmesi görünür hale gelir. Eylemler bölmesi görüntülendikten sonra, kullanıcının eylemlerine yanıt olarak denetimleri dinamik olarak ekleyebilir veya kaldırabilirsiniz. Genellikle, kullanıcı belgeyi ilk açtığında eylemler bölmesinin görünür olması için Startup veya ThisDocumentThisWorkbook olay işleyicisinde eylemler bölmesini görüntülemek için kodu eklersiniz. Ancak, eylemler bölmesini yalnızca belgedeki bir kullanıcının eylemine yanıt olarak görüntülemek isteyebilirsiniz. Örneğin, kodu belgedeki bir denetimin Click olayına ekleyebilirsiniz.

Eylemler bölmesine birden çok denetim ekleme

Eylemler bölmesine birden çok denetim eklediğinizde, denetimleri bir kullanıcı denetiminde gruplandırmalı ve ardından kullanıcı denetimini Controls özelliğine eklemelisiniz. Bu işlem aşağıdaki adımları içerir:

  1. Projenize bir Eylemler Bölmesi Denetimi veya Kullanıcı Denetimi öğesi ekleyerek eylemler bölmesinin kullanıcı arabirimini (UI) oluşturun. Bu öğelerin her ikisi de özel bir Windows Forms UserControl sınıfı içerir. Eylemler Bölmesi Denetimi ve Kullanıcı Denetimi öğeleri eşdeğerdir; Tek fark adlarıdır.

  2. Tasarımcıyı kullanarak veya kod yazarak Windows Forms denetimlerini UserControl'a ekleyin.

    Uyarı

    WPF denetimlerini eylemler bölmesine eklemek için ayrıca Windows Forms UserControl'e bir WPF UserControl ekleyebilirsiniz. Daha fazla bilgi için bkz. Office çözümlerindeWPF denetimlerini kullanma.

  3. Projenizdeki ActionsPane (Excel için) veya ThisWorkbook (Word için) sınıfının ThisDocument alanında yer alan denetimlere özel kullanıcı denetiminin bir örneğini ekleyin.

    Bu işlemi daha ayrıntılı olarak gösteren örnekler için bkz. nasıl yapılır: Word belgelerine veya Excel çalışma kitaplarına eylemler bölmesi ekleme .

Eylemler bölmesini gizleme

ActionsPane sınıfının bir Hide yöntemi ve Visible özelliği olsa da, ActionsPane sınıfının herhangi bir üyesini kullanarak eylemler bölmesini kullanıcı arabiriminden kaldıramazsınız. Hide yöntemini çağırmak veya Visible özelliğini false olarak ayarlamak yalnızca eylemler bölmesindeki denetimleri gizler; görev bölmesini gizlemez.

Çözümünüzdeki görev bölmesini gizlemek için birkaç seçeneğiniz vardır:

  • Word için, Belge Eylemleri görev bölmesini temsil eden Visible nesnesinin TaskPane özelliğini false olarak ayarlayın. Aşağıdaki kod örneğinin projenizdeki ThisDocument sınıfından çalıştırılması amaçlanmıştır.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
    
  • Excel için, DisplayDocumentActionTaskPane nesnesinin Application özelliğini false olarak ayarlayın. Aşağıdaki kod örneğinin projenizdeki ThisWorkbook sınıfından çalıştırılması amaçlanmıştır.

    this.Application.DisplayDocumentActionTaskPane = false;
    
  • Word veya Excel için alternatif olarak, görev bölmesini temsil eden komut çubuğunun Visible özelliğini false olarak ayarlayabilirsiniz. Aşağıdaki kod örneğinin projenizdeki ThisDocument veya ThisWorkbook sınıfından çalıştırılması amaçlanmıştır.

    this.Application.CommandBars["Task Pane"].Visible = false;
    

Belge açıldığında eylemler bölmesini temizleyin

Eylemler bölmesi görünür durumdayken bir kullanıcı belgeyi kaydettiğinde, eylemler bölmesinde denetim bulunsa da olmasa da, belge her açıldığında eylemler bölmesi görünür. Ne zaman görüneceğini denetlemek istiyorsanız, belge açıldığında eylemler bölmesinin görünür olmadığından emin olmak için Clear veya ActionsPaneStartup olay işleyicisindeki ThisDocument alanının ThisWorkbook yöntemini çağırın.

Eylemler bölmesinin ne zaman kapatileceğini belirleme

Eylemler bölmesi kapatıldığında tetiklenen bir olay yoktur. ActionsPane sınıfının VisibleChanged bir olayı olsa da, son kullanıcı eylemler bölmesini kapattığında bu olay tetiklenmez. Bunun yerine, eylemler bölmesindeki denetimler Hide yöntemini çağırarak veya Visible özelliğini false olarak ayarlayarak gizlendiğinde bu olay tetiklenir.

Kullanıcı eylemler bölmesini kapattığında, kullanıcı uygulamanın kullanıcı arabiriminde (UI) aşağıdaki yordamlardan birini gerçekleştirerek bu bölmeyi yeniden görüntüleyebilir.

Word veya Excel kullanıcı arabirimini kullanarak eylemler bölmesini görüntülemek için
  1. Şeritte, Görünüm sekmesine tıklayın.

  2. Göster/Gizle grubunda Belge Eylemleri iki durumlu düğmesini tıklatın.

Program eylemleri paneli etkinlikleri

Eylemler bölmesine birden çok kullanıcı denetimi ekleyebilir ve ardından kullanıcı denetimlerini göstererek ve gizleyerek belgedeki olaylara yanıt vermek için kod yazabilirsiniz. XML şema öğelerini belgenizle eşlerseniz, ekleme noktası XML öğelerinden birinin içinde olduğunda eylemler bölmesinde belirli kullanıcı denetimlerini gösterebilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: Şemaları Visual Studio içindeki Word belgeleriyle eşleme ve Nasıl yapılır: Şemaları Visual Studioiçindeki çalışma sayfalarıyla eşleme.

Konak denetimi, uygulama veya belge olayları da dahil olmak üzere herhangi bir nesnenin olaylarını yanıtlamak için kod da yazabilirsiniz. Daha fazla bilgi için bkz. İzlenecek Yol:NamedRange denetimi olaylarına karşı programlama.

Eylemler bölmesindeki denetimlere veri bağlama

Eylemler bölmesindeki denetimler, Windows Forms'da denetimlerle aynı veri bağlama özelliklerine sahiptir. Denetimleri veri kümeleri, yazılan veri kümeleri ve XML gibi veri kaynaklarına bağlayabilirsiniz. Daha fazla bilgi için bkz. Veri bağlama ve Windows Forms.

Eylemler bölmesindeki denetimleri ve belgedeki denetimleri aynı veri kümesine bağlayabilirsiniz. Örneğin, eylemler bölmesindeki denetimlerle çalışma sayfasındaki denetimler arasında bir ana/ayrıntı ilişkisi oluşturabilirsiniz. Daha fazla bilgi için bkz. İzlenecek Yol:Excel eylemleri bölmesindeki denetimlere veri bağlama.

Eylemler bölmesindeki denetimlerdeki verileri doğrulama

Eylemler bölmesindeki bir denetimin Validating olay işleyicisinde bir ileti kutusu görüntülerseniz, odak denetimden ileti kutusuna geçtiğinde olay ikinci kez tetiklenebilir. Bu sorunu önlemek için bir ErrorProvider denetimi kullanarak doğrulama hata iletilerini görüntüleyin.

Kullanıcı kontrolü sıralama düzeni

Birden çok kullanıcı denetimi kullanıyorsanız, kullanıcı denetimlerini dikey veya yatay olarak yerleştirildiğinden emin olmak üzere eylemler bölmesinde düzgün bir şekilde yığmak için kod yazabilirsiniz. StackStyle özelliğinin StackOrder numaralandırmasını kullanarak eylemler bölmesindeki kullanıcı denetimlerinin yığınlama sırasını ayarlayabilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır:eylemler bölmelerinde denetim düzenini yönetme.

StackOrder özelliği aşağıdaki StackStyle numaralandırma değerlerini alabilir.

Yığma stili Tanım
Alttan Eylemler bölmesinin altından başlayarak yığın oluşturun.
Soldan Eylemler bölmesinin sol tarafından yığınla.
Sağdan Eylemler bölmesinin sağından istifle.
Yukarıdan Eylemler panelinin üst kısmından istifle.
Hiç kimse Yığınlama sırası tanımlanmadı; sipariş geliştirici tarafından denetlendi.

Aşağıdaki kod, kullanıcı denetimlerini eylemler bölmesinin en üstünden yığmak için StackOrder özelliğini ayarlar.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Bağlantı denetimleri

Kullanıcı çalışma zamanında eylemler bölmesini yeniden boyutlandırırsa, denetimler eylemler bölmesiyle yeniden boyutlandırılabilir. Denetimleri eylemler bölmesine sabitlemek için Windows Forms denetiminin Anchor özelliğini kullanabilirsiniz. Ayrıca Windows Forms denetimlerini kullanıcı denetimine aynı şekilde sabitleyebilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır: Windows Forms'da denetimleri sabitleme.

Eylemler bölmesini yeniden boyutlandırma

ActionsPane görev bölmesine eklendiğinden, ActionsPane boyutunu doğrudan değiştiremezsiniz. Ancak, görev bölmesini temsil eden WidthCommandBar özelliğini ayarlayarak görev bölmesinin genişliğini program aracılığıyla değiştirebilirsiniz. Görev bölmesi yatay olarak yerleştirilmişse veya kayansa, görev bölmesinin yüksekliğini değiştirebilirsiniz.

Kullanıcının ihtiyaçlarına en uygun görev bölmesi boyutunu seçebilmesi gerektiğinden, görev bölmesini program aracılığıyla yeniden boyutlandırmak önerilmez. Ancak, görev bölmesinin genişliğini yeniden boyutlandırmanız gerekiyorsa, bu görevi gerçekleştirmek için aşağıdaki kodu kullanabilirsiniz.

this.CommandBars["Task Pane"].Width = 200;

Eylemler bölmesini yeniden konumlandırma

ActionsPane görev bölmesine gömülü olduğundan onu doğrudan yeniden konumlandıramazsınız. Görev bölmesini, görev bölmesini temsil eden Position'in CommandBar özelliğini program aracılığıyla ayarlayarak taşıyabilirsiniz.

Kullanıcının ekranda kendi gereksinimlerine en uygun görev bölmesi konumunu seçebilmesi gerektiğinden, görev bölmesini program aracılığıyla yeniden konumlandırmak önerilmez. Ancak, görev bölmesini belirli bir konuma taşımanız gerekiyorsa, bu görevi başarmak için aşağıdaki kodu kullanabilirsiniz.

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Uyarı

Son kullanıcılar istedikleri zaman görev bölmesini el ile yeniden konumlandırabilir. Görev bölmesinin program aracılığıyla belirttiğiniz konumda yerleşik kalmasını sağlamanın hiçbir yolu yoktur. Ancak, yönlendirme değişikliklerini denetleyebilirsiniz ve eylemler bölmesindeki denetimlerin doğru yönde yığıldığından emin olabilirsiniz. Daha fazla bilgi için bkz. Nasıl yapılır:eylemler bölmelerinde denetim düzenini yönetme.

Top nesnesi görev bölmesine eklendiğinden, LeftActionsPane ve ActionsPane özelliklerini ayarlamak konumunu değiştirmez.

Görev bölmesi yerleşik değilse, onu temsil eden Top'nin Left ve CommandBar özelliklerini ayarlayabilirsiniz. Aşağıdaki kod, çıkarılmış bir görev bölmesini belgenin sol üst köşesine taşır.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}