CStatusBar

Um objeto de CStatusBar é uma barra de Controlarar com uma linha de painéis de saída de texto, ou "indicadores". Os painéis de saída são usados como linhas de mensagem e como indicadores de status. Exemplos incluem as linhas de mensagem de ajuda do menu que explique rapidamente o comando de menu selecionado e os indicadores que mostram o status de SCROLL Bloquear, NUM Bloquear e outras chaves.

CStatusBar:: GetStatusBarCtrl, uma função de membro nova no MFC 4.0, permite que você tire vantagem do suporte do Controlarar comum do Windows para personalização de barra de status e funcionalidade adicional. Funções de membro CStatusBar lhe dar a maioria das funcionalidades dos controles ComComumComum do Windows; no entanto, quando você chamar GetStatusBarCtrl, você pode dar as barras de status ainda mais as características de uma barra de status do Windows 95. Quando você chamar GetStatusBarCtrl, ela retornará uma referência a um objeto CStatusBarCtrl . Consulte CStatusBarCtrl para obter mais informações sobre como criar barras de ferramentas usando controles ComComumComum do Windows. Para mais informações sobre controles ComComumComum, consulte Controles comuns na Referência do programador do Windows 95 SDK.

A estrutura armazena informações de indicador em uma matriz com o indicador mais à esquerda na posição 0. Quando você cria uma barra de status, você usar uma matriz de Cadeia de Caracteres identificações que a estrutura associa os indicadores correspondentes. Você pode usar um ID de Cadeia de caracteres ou um índice para acessar um indicador.

Por padrão, o primeiro indicador é "elástico": leva até o comprimento de barra de status não usado por outros painéis de indicador, para que os outros painéis são alinhados à direita.

Para criar uma barra de status, execute as seguintes etapas:

  1. Construir o objeto CStatusBar.

  2. Chame o criar (ou CreateEx) função para criar a janela de barra de status e anexá-lo para o objeto CStatusBar.

  3. Chamada SetIndicators para associar um ID de Cadeia de caracteres com cada indicador.

Há três maneiras de atualizar o texto no painel de barra de status:

  1. Chamada CWnd:: SetWindowText para atualizar o texto no painel 0 somente.

  2. Chamar CCmdUI::SetText no manipulador de ON_UPDATE_COMMAND_UI a barra de status.

  3. Chamada SetPaneText para atualizar o texto de qualquer painel.

Chamada SetPaneStyle para atualizar o estilo de um painel de barra de status.

Para obter mais informações sobre o uso de CStatusBar, consulte o artigo Barras de Status no Guia do programador do Visual C++ e técnico 31 anotação, barras de Controlarar.

# include lt;afxext.h>

Membros da classe |  Classe base | Gráfico de hierarquia

&Nbsp amostras; MFC exemplo CTRLBARS | MFC exemplo DLGCBR32

Co&nsulte tambémnbsp;CStatusBarCtrl, CControlBar, CWnd:: SetWindowText, CStatusBar::SetIndicators

Index