RibbonDialogLauncher.ImageName A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define um identificador usado para atribuir uma imagem para este RibbonDialogLauncher Quando ele é adicionado à barra de ferramentas de acesso rápido.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

Public Property ImageName As String

Dim instance As RibbonDialogLauncher
Dim value As String

value = instance.ImageName

instance.ImageName = value

public string ImageName { get; set; }

Valor de propriedade

Tipo: System.String
Um identificador usado para atribuir uma imagem para este RibbonDialogLauncher Quando ele é adicionado à barra de ferramentas de acesso rápido.

Comentários

Essa propriedade pode ser definida em time de execução somente sob certas condições.Para obter mais informações, consulte Visão geral do modelo de objeto da Faixa de Opções.

The ImageName propriedade não tem efeito visível quando o RibbonDialogLauncher é exibida em um agrupar de faixa de opções. No entanto, quando um usuário adiciona um RibbonDialogLauncher da barra de ferramentas de acesso rápido, essa propriedade controla o comportamento da imagem que está sendo exibida, a menos que o Image ou OfficeImageId propriedade também é conjunto.

The ImageName propriedade identifica uma imagem que é exibida pelo controle. O aplicativo recupera a essa imagem de sua solução apenas uma vez, para melhorar o desempenho.Esta propriedade pode ser conjunto somente em time de design, como a imagem identifica é carregado durante o LoadImage evento. LoadImage é disparado somente uma vez por nome de imagem quando a faixa de opções é exibida. Depois disso, a imagem do controle não pode ser alterada usando essa propriedade.

Para carregar a imagem, adicione código para o LoadImage manipulador de eventos. Verifique o ImageName propriedade das RibbonLoadImageEventArgs e conjunto o Image propriedade das RibbonLoadImageEventArgs objeto para a imagem que você deseja carregar.

Esta propriedade é ignorada se a Image propriedade ou o OfficeImageId propriedade é conjunto. Imagens identificadas pelo ImageName propriedade pode ser carregada ligeiramente mais rápido do que imagens identificadas pela Image propriedade, porque o aplicativo recupera a imagem do seu time de solução somente o primeiro a faixa de opções é exibida.

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.