IRibbonControl Interface
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.
Representa o objeto passado para cada procedimento de retorno de chamada da interface do usuário (interface do usuário) do Ribbon.
public interface class IRibbonControl[System.Runtime.InteropServices.Guid("000C0395-0000-0000-C000-000000000046")]
public interface IRibbonControl[<System.Runtime.InteropServices.Guid("000C0395-0000-0000-C000-000000000046")>]
type IRibbonControl = interfacePublic Interface IRibbonControl- Atributos
Exemplos
O exemplo a seguir, criado em c#, mostra dois procedimentos chamados a partir do procedimento do evento onAction de um controle de botão e um controle ToggleButton. No primeiro procedimento, o objeto IRibbonControl que representa o controle é passado para o procedimento e uma caixa de mensagem é exibida indicando que o botão foi pressionado, juntamente com a ID do botão. O segundo procedimento é semelhante ao primeiro com a adição de um parâmetro booleano, indicando que o botão foi pressionado.
<span class="label">public void ButtonOnAction(IRibbonControl control)
MessageBox.Show("Button clicked: " + control.Id);
}
public void ToggleButtonOnAction(IRibbonControl control, bool pressed)
{
...if (pressed)
MessageBox.Show("ToggleButton was switched on.");
else
MessageBox.Show("ToggleButton was switched off.");
}</span>
Comentários
Objeto IRibbonControl contém o nome (ID) do controle e do objeto Window atual do controle da IU Ribbon.
Propriedades
| Context |
Representa a janela ativa contendo a interface do usuário Ribbon que dispara um procedimento de retorno de chamada. Somente leitura. |
| Id |
Obtém a ID do controle especificado no arquivo de personalização de marcação Ribbon XML. Somente leitura. |
| Tag |
Usado para armazenar sequências de caracteres arbitrárias e buscá-las no tempo de execução. Somente leitura |