RibbonSplitButton.OfficeImageId A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define a imagem a ser exibida sobre o RibbonSplitButton controle, 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 RibbonSplitButton
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.

Exemplos

O exemplo a seguir atribui um ícone do Microsoft Office a um botão de divisã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 de divisão ao agrupar.

PrivateSub SetSplitButtonImage()
    SplitButton1.OfficeImageId = "HighImportance"EndSub

privatevoid SetSplitButtonImage()
{
    splitButton1.OfficeImageId = "HighImportance";
}

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.