Classe de CStatusBar

Artigo
03/15/2013

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: