RibbonEditBox.ImageName Propriedade

Definição

Obtém ou define o nome que você pode usar para identificar a imagem no manipulador de eventos LoadImage.

public string ImageName { get; set; }

Valor da propriedade

String

Uma cadeia de caracteres que você pode usar no manipulador de eventos LoadImage para identificar a imagem.

Comentários

Esta propriedade pode ser definida em tempo de execução somente em determinadas condições. Para obter mais informações, consulte visão geral do modelo de objeto da faixa de faixas.

A ImageName propriedade identifica uma imagem que é exibida pelo controle. O aplicativo do Office recupera essa imagem da solução apenas uma vez para melhorar o desempenho. Esta propriedade só pode ser definida em tempo de design, porque a imagem que ela identifica é carregada durante o evento LoadImage. LoadImage só é acionado uma vez por nome da imagem, quando a Faixa de Opções é exibida. Depois disso, a imagem de controle não pode ser modificada usando-se essa propriedade.

Para carregar a imagem, adicione o código ao manipulador de eventos LoadImage. Verifique a propriedade ImageName do RibbonLoadImageEventArgs e defina a propriedade Image do objeto RibbonLoadImageEventArgs como a imagem que você deseja carregar.

Essa propriedade será ignorada se a Image propriedade ou a OfficeImageId propriedade for definida. As imagens identificadas pela ImageName propriedade podem ser carregadas ligeiramente mais rápido que as imagens identificadas pela Image propriedade, porque o aplicativo do Office recupera a imagem da sua solução somente na primeira vez em que a faixa de imagens é exibida.

A ShowImage propriedade deve ser true para o controle exibir a imagem. Quando você define a ImageName propriedade em tempo de design, o Visual Studio define automaticamente a ShowImage propriedade como true . Se você definir a ImageName propriedade em tempo de execução, deverá definir a ShowImage propriedade como true em seu código.

Aplica-se a