Aracılığıyla paylaş


RibbonBase.LoadImage Olay

Tanım

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ü

Ö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