RibbonBase.LoadImage Olay

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Ribbon

Bütünleştirilmiş Kod:: Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

ImageName özelliği bir veya daha fazla denetim için ayarlandıysa yüklenirken RibbonBase gerçekleşir.

public:
 event Microsoft::Office::Tools::Ribbon::RibbonLoadImageEventHandler ^ LoadImage;

public event Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler LoadImage;

member this.LoadImage : Microsoft.Office.Tools.Ribbon.RibbonLoadImageEventHandler

Public Custom Event LoadImage As RibbonLoadImageEventHandler

Olay Türü

RibbonLoadImageEventHandler

Örnekler

Aşağıdaki örnek, görüntüleri iki RibbonButton denetim için önbelleğe alır.

Bu kod örneğini çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:

Office projesine Şerit (Visual Tasarım Aracı) ekleyin.
Visual Basic projesi kullanıyorsanız Şerit kod dosyasının en üstüne aşağıdaki deyimi ekleyin: Imports Microsoft.Office.Tools.Ribbon

Daha sonra bu kodu, oluşturulan Şerit sınıfında çalıştırabilirsiniz.

Private Sub Ribbon1_LoadImage(sender As Object, e As RibbonLoadImageEventArgs)  
   Select Case e.ImageName  
      Case "Button1Image"  
         e.Image = My.Resources.Image1  
      Case "Button2Image"  
         e.Image = My.Resources.Image2  
   End Select  
End Sub

private void Ribbon1_LoadImage(object sender, RibbonLoadImageEventArgs e)  
{  
    switch (e.ImageName)  
    {  
        case "Button1Image":  
            e.Image = Properties.Resources.Image1;  
            break;  
        case "Button2Image":  
            e.Image = Properties.Resources.Image2;  
            break;  
    }  
}

Açıklamalar

Olay LoadImage , Şerit özelleştirmesinde görüntüleri önbelleğe almanızı sağlar ve bu da performansı artırabilir.

Varsayılan olarak, kullanıcı görüntüyü içeren bir sekmeyi her görüntüleyişinde Şerit'e bir görüntü yüklenir. Görüntünün görüntülendiği denetimin özelliklerini program aracılığıyla değiştirdiğiniz her zaman bir görüntü yeniden yüklenir.

Denetime LoadImage görüntü atamak için olayını kullanın. Kullanıcı Şeritte bir sekme seçtiğinde, Microsoft Office uygulaması önbelleğe alınmış görüntüyü kullanır. Çalışma zamanında bir denetim özelliğini değiştirirseniz, Microsoft Office uygulaması denetimin üzerindeki görüntüyü yeniden yüklemez. Bu size küçük bir performans kazancı sağlayabilir.

Denetimin görüntüsünü önbelleğe almak istiyorsanız, denetimin ImageName özelliğini ayarlayın. En LoadImage az bir denetimin ImageName özelliğini ayarlamadığınız sürece olay tetiklenmez.

Şunlara uygulanır

Aracılığıyla paylaş