RibbonButton.OfficeImageId A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define a imagem a ser exibida no botão, se você quiser usar um ícone do Microsoft Office interno.

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

Sintaxe

Public Property OfficeImageId As String

Dim instance As RibbonButton
Dim value As String

value = instance.OfficeImageId

instance.OfficeImageId = value

public string OfficeImageId { get; set; }

Valor de propriedade

Tipo: System.String
A ID de um ícone do Microsoft Office interna que serve sistema autônomo um ícone para esse controle.

Comentários

The OfficeImageId propriedade identifica um ícone do Office que é exibido pelo controle. O valor da propriedade é uma seqüência de caracteres que identifica o imageMso valor do ícone selecionado. Esta propriedade pode ser conjunto em time de design ou em time de execução.Se você atualizar essa propriedade em time de execução, a aparência do controle é atualizada para refletir a alterar.

Para obter uma lista de imageMso valores, consulte a página do centralizar de baixar da Microsoft Suplemento do 2007 office sistema: Http://go.microsoft.com/fwlink/?LinkId=93525 ícones galeria.

Esta propriedade é ignorada se a Image propriedade é definida. Imagens identificadas pelo OfficeImageId propriedade pode ser carregada ligeiramente mais rápido do que imagens identificadas pela Image propriedade, porque as imagens são armazenadas em cache no aplicativo do Office.

The ShowImage propriedade deve ser true para o controle exibir a imagem. Ao conjunto o OfficeImageId propriedade pelo time de design, Visual Studio Tools for Office define automaticamente a ShowImage propriedade para true. Se você conjunto o OfficeImageId propriedade em time de execução, você deve conjunto o ShowImage propriedade para true em seu código.

Exemplos

O exemplo a seguir atribui um ícone do Microsoft Office a um botão.

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um Faixa de opções (Visual Designer) item to a Visual Studio Tools for Office projeto.
Adicione um agrupar à guia personalizada.
Adicione um botão ao agrupar.
conjunto o (Nome) propriedade do botão para mySaveButton.

PrivateSub SetButtonImage()
    mySaveButton.OfficeImageId = "FileSave"
    mySaveButton.ShowImage = TrueEndSub

privatevoid SetButtonImage()
{
    mySaveButton.OfficeImageId = "FileSave";
    mySaveButton.ShowImage = true;
}

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.