Classe CStatusBar

Artigo
06/10/2015

Uma barra de controle com uma linha de painéis de saída de texto, ou indexadores de “”.

class CStatusBar : public CControlBar

Membros

Construtores public

Nome	Descrição
CStatusBar::CStatusBar	Constrói um objeto de CStatusBar .

Métodos públicos

Nome	Descrição
CStatusBar::CommandToIndex	Obtém o índice para uma determinada identificação do indexador
CStatusBar::Create	Cria a barra de status, anexá-la ao objeto de CStatusBar , defina a altura inicial da fonte e da barra.
CStatusBar::CreateEx	Cria um objeto de CStatusBar com os estilos adicionais para o objeto inserido de CStatusBarCtrl .
CStatusBar::DrawItem	Chamado quando uma aparência visual de alterações de controle de barra de status do proprietário.
CStatusBar::GetItemID	Obtém a identificação do indexador para um índice especificado.
CStatusBar::GetItemRect	Obtém o retângulo de exibição para um índice especificado.
CStatusBar::GetPaneInfo	Obtém a identificação, o estilo, e a largura do indexador para um índice especificado.
CStatusBar::GetPaneStyle	Obtém o estilo do indexador para um índice especificado.
CStatusBar::GetPaneText	Obtém o texto do indexador para um índice especificado.
CStatusBar::GetStatusBarCtrl	Permite acesso direto ao controle comum subjacente.
CStatusBar::SetIndicators	Define IDs do indexador.
CStatusBar::SetPaneInfo	Define a identificação, o estilo, e a largura do indexador para um índice especificado.
CStatusBar::SetPaneStyle	Defina o estilo do indexador para um índice especificado.
CStatusBar::SetPaneText	Define o texto do indicador para um índice especificado.

Comentários

Os painéis de saída são geralmente usados como linhas de mensagem e como indicadores de status. Os exemplos incluem as linhas de ajuda mensagem de menu que explicam rapidamente o comando de menu selecionado e marcadores que mostram o status da CAPS de SCROLL LOCK, de EM UM LOCK, e outras teclas.

CStatusBar::GetStatusBarCtrl, uma função de membro novo a MFC 4,0, permite que você aproveite de suporte comuns de controle do windows para personalização e funcionalidade adicional de barra de status. As funções de membro deCStatusBar dão-no mais da funcionalidade dos controles comuns do windows; no entanto, quando você chama GetStatusBarCtrl, você pode dar às barras de status ainda mais das características Windows 95 /98 de barra de status. Quando você chama GetStatusBarCtrl, retornará uma referência a um objeto de CStatusBarCtrl . Consulte CStatusBarCtrl para obter mais informações sobre como criar barras de ferramentas usando controles comuns. Para obter informações mais gerais sobre controles comuns, consulte Controles comuns em Windows SDK.

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

Por padrão, o primeiro indexador é extensível”: “ pega o comprimento da barra de status não usado pelos outros painéis do indexador, para que os outros painéis são alinhados à direita.

Para criar uma barra de status, siga estas etapas:

Construir o objeto de CStatusBar .
Chame a função de Criar (ou CreateEx) para criar a janela de barra de status para e anexá-la ao objeto de CStatusBar .
Chame SetIndicators para associar uma identificação de cadeia de caracteres com cada indexador.

Existem três maneiras para atualizar o texto em um painel de barra de status: