RibbonEditBox.ImageName Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.