Método IConsole2::SetStatusText (mmc.h)
O método IConsole2::SetStatusText permite que o snap-in altere o texto na barra de status. Lembre-se de que isso é usado apenas por instâncias do IComponent.
Sintaxe
HRESULT SetStatusText(
[in] LPOLESTR pszStatusText
);
Parâmetros
[in] pszStatusText
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto a ser exibido na barra de status.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
A barra de status tem três seções, que são delineadas pelo caractere de barra vertical (|). Por exemplo, definindo o texto na barra de status como "Esquerda| Meio| Right" coloca "Left" na seção mais à esquerda da barra de status, "Middle" na seção intermediária e " Right" na seção mais à direita.
Se mais de três campos forem delineados (ou seja, há mais de dois pipes), tudo o que seria colocado no quarto e mais campos será omitido.
Além disso, a seção intermediária foi projetada para funcionar como uma barra de progresso. Essa funcionalidade é invocada passando o caractere '%' como o primeiro caractere, seguido por um número entre 0 e 100, para a seção intermediária. Em vez de texto, esta seção exibe uma barra de progresso de zero a 100% concluída. Por exemplo, passar "Concluído|%75" coloca "Concluído" na seção esquerda e uma barra de progresso 75% concluída na seção intermediária.
Para exibir uma cadeia de caracteres que começa com '%' na seção intermediária da barra de status, inicie a cadeia de caracteres com '%%'. Isso faz com que a seção do meio exiba o texto e remova o primeiro '%'. Por exemplo: "Hoje é|%%quarta-feira%" resulta na seção à esquerda que contém "Hoje é" e na seção intermediária que contém "%wednesday%". Se um número inválido ou texto não numérico for inserido na seção intermediária após um '%', a seção intermediária estará vazia. Se um '%' for o único caractere na seção, ele será mostrado como texto.
Esse método deve ser chamado de um ponteiro de interface IConsole2 obtido por meio de IComponent.
Somente o snap-in que possui o item de escopo selecionado no momento pode alterar o texto da barra de status.
No MMC versão 1.1 e posterior, cada janela filho da MDI (interface MDI) tem uma barra de status.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |