Eylemler bölmesine genel bakış

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

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 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 denetimleri veya WPF denetimlerini kullanabilirsiniz.

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

Eylemler bölmesini yalnızca Word veya Excel için belge düzeyinde özelleştirmede oluşturabilirsiniz. VSTO Eklentisinde eylemler bölmesi oluşturamazsınız. Daha fazla bilgi için bkz. Office uygulama 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 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 sınıfı tarafından ActionsPane temsil edilir. Belge düzeyinde bir proje oluşturduğunuzda, bu sınıfın bir örneği projenizdeki (Excel için) veya ThisDocument (Word için) sınıfının alanını ThisWorkbook kullanarak ActionsPane 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 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 onların adı.

  2. tasarımcıyı kullanarak veya kod yazarak öğesine Windows Forms denetimleri UserControl ekleyin.

    Not

    Windows Forms bir WPF ekleyerek eylemler bölmesine UserControlWPF 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 bulunan 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 Hide yöntemi ve özelliği olsa da, sınıfın herhangi bir Visible üyesini ActionsPane kullanarak kullanıcı arabiriminden eylemler bölmesini kaldıramazsınız. Hide yöntemini çağırmak 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 çeşitli seçenekleriniz 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ği, projenizdeki sınıftan ThisDocument çalıştırılmak üzere tasarlanmıştır.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;
    
  • Excel için nesnesinin DisplayDocumentActionTaskPaneApplication özelliğini false olarak ayarlayın. Aşağıdaki kod örneği, projenizdeki sınıftan ThisWorkbook çalıştırılmak üzere tasarlanmış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ği, projenizdeki veya ThisWorkbook sınıfından ThisDocument çalıştırılmak üzere tasarlanmıştır.

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

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

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 daActionsPane, 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, uygulamanın kullanıcı arabiriminde (UI) aşağıdaki yordamlardan birini gerçekleştirerek bu bölmeyi yeniden görüntüleyebilir.

Eylemler bölmesini Word veya Excel kullanıcı arabirimini kullanarak 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 belgenize 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 Studio içindeki çalışma sayfalarıyla eşleme.

Ayrıca konak denetimi, uygulama veya belge olayları da dahil olmak üzere herhangi bir nesnenin olaylarını yanıtlamak için kod 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 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 eylemler bölmesindeki denetimlere veri bağlama.

Eylemler bölmesi denetimlerindeki 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 denetim kullanarak ErrorProvider doğrulama hata iletilerini görüntüleyin.

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 olun eylemler bölmesinde düzgün bir şekilde yığmak için kod yazabilirsiniz. Özelliğinin 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 Tanım
FromBottom Eylemler bölmesinin alt kısmından yığın yapın.
FromLeft Eylemler bölmesinin solundan yığın.
FromRight Eylemler bölmesinin sağından yığın yapın.
FromTop Eylemler bölmesinin üst kısmından yığın yapın.
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 sabitlemek için bir 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 denetimleri bağlama.

Eylemler bölmesini yeniden boyutlandırma

görev bölmesine eklendiğinden 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ölmesinin yatay olarak sabitlenmişse veya kayansa, 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ı, ekranda gereksinimlerine en uygun görev bölmesi konumunu seçebileceğ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 gerçekleştirmek 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.

nesnesinin TopActionsPane ve Left özellikleri ayarlandığında, nesne görev bölmesine eklendiğinden ActionsPane konumu değişmez.

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

Ayrıca bkz.