Eylemler bölmesine genel bakış

  • Makale

Eylemler bölmesi, belirli bir Microsoft Office Word belgesine veya Microsoft Office Excel çalışma kitabına eklenmiş, özelleştirilebilir bir Belge Eylemleri görev bölmesidir. Eylemler bölmesi, Excel'deki XML Kaynağı görev bölmesi veya Word'deki Stiller 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 kullanılabilen ö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 kullanılabilen özellikler.

Not

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 uygulaması'ler 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 sınıfı tarafından ActionsPane temsil edilir. Belge düzeyinde bir proje oluşturduğunuzda, projenizdeki (Excel için) veya ThisDocument (Word için) sınıfının alanını kullanarak ActionsPane bu sınıfın ThisWorkbook bir örneği kodunuz için kullanılabilir. Eylemler bölmesini görüntülemek için alanın özelliğine ControlsActionsPane bir Windows Forms denetimi ekleyin. Aşağıdaki kod örneği, eylemler bölmesine adlı actions bir denetim ekler.

this.ActionsPane.Controls.Add(actions);

Eylemler bölmesi, siz açıkça denetim eklediğinizde çalışma zamanında 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 kez açtığında eylemler bölmesinin görünür olması için veya olay işleyicisinde StartupThisDocumentThisWorkbook 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 Click bir denetimin 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 özelliğine Controls 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'a UserControl Windows Forms denetimleri ekleyin.

    Not

    Windows Forms'a UserControlWPF ekleyerek eylemler bölmesine WPF UserControl denetimleri de ekleyebilirsiniz. Daha fazla bilgi için bkz . Office çözümlerinde WPF denetimlerini kullanma.

  3. Projenizdeki (Excel için) veya ThisDocument (Word için) sınıfının alanında yer alan ActionsPane denetimlere özel kullanıcı denetiminin ThisWorkbook 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

Sınıfın ActionsPane bir yöntemi ve özelliği olsa da, sınıfın herhangi bir HideVisible üyesini ActionsPane kullanarak kullanıcı arabiriminden eylemler bölmesini kaldıramazsınız. yöntemini çağırmak Hide veya özelliğini false olarak ayarlamak Visible 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 nesnenin TaskPane özelliğini false olarak ayarlayınVisible. Aşağıdaki kod örneğinin projenizdeki sınıfından ThisDocument çalıştırılması amaçlanmıştır.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • Excel için nesnenin DisplayDocumentActionTaskPaneApplication özelliğini false olarak ayarlayın. Aşağıdaki kod örneğinin projenizdeki sınıfından ThisWorkbook ç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 özelliğini false olarak ayarlayabilirsinizVisible. Aşağıdaki kod örneğinin projenizdeki veya ThisWorkbook sınıfından ThisDocument ç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 ActionsPane görünür olmadığından emin olmak için veya ThisWorkbook olay işleyicisindeki StartupThisDocument alanın yöntemini çağırınClear.

Eylemler bölmesinin ne zaman kapatileceğini belirleme

Eylemler bölmesi kapatıldığında tetiklenen bir olay yoktur. Sınıfında bir VisibleChanged olay olsa ActionsPane da, son kullanıcı eylemler bölmesini kapattığında bu olay tetiklenmez. Bunun yerine, eylemler bölmesindeki denetimler yöntemi çağrılarak Hide veya özelliği false olarak ayarlanarak gizlendiğinde Visible 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 bölmesi olayları

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'da Word belgeleriyle eşleme ve Nasıl yapılır: Şemaları Visual Studio'da çalışma sayfalarına 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 denetiminin olaylarına karşı program.

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, doğrulama hata iletilerini görüntülemek için bir ErrorProvider denetim kullanın.

Kullanıcı denetimi yığınlama sırası

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. Özelliğin numaralandırmasını kullanarak StackStyle eylemler bölmesindeki kullanıcı denetimlerinin StackOrder yığma 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 Açıklama
FromBottom Eylemler bölmesinin alt kısmından yığın yapın.
FromLeft Eylemler bölmesinin sol tarafından yığınla.
FromRight Eylemler bölmesinin sağından yığınla.
FromTop Eylemler bölmesinin en üstünden yığınla.
Hiçbiri 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 özelliğini ayarlar StackOrder .

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

Tutturucu 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 Anchor tutturmak için Windows Forms denetiminin ö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 bağlama.

Eylemler bölmesini yeniden boyutlandırma

görev bölmesine eklendiğinden, öğesinin ActionsPaneActionsPane boyutunu doğrudan değiştiremezsiniz. Ancak, görev bölmesini temsil eden özelliğini ayarlayarak Width görev bölmesinin CommandBar 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

görev bölmesine eklendiğinden ActionsPane öğesini doğrudan yeniden konumlandıramazsınız. Ancak, görev bölmesini temsil eden özelliğini CommandBar ayarlayarak Position görev bölmesini program aracılığıyla 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;

Not

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.

öğesinin Top ve Left özelliklerinin ActionsPane ayarlanması, nesne görev bölmesine eklendiğinden ActionsPane konumunu değiştirmez.

Görev bölmesi yerleşik değilse, görev bölmesini temsil eden öğesinin ve Left özelliklerini CommandBar ayarlayabilirsinizTop. 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;
}

İlgili içerik