Função CreateStatusWindowW (commctrl.h)

Artigo
11/18/2024

Cria uma janela de status, que normalmente é usada para exibir o status de um aplicativo. A janela geralmente aparece na parte inferior da janela pai e contém o texto especificado.

Observação Essa função é obsoleta. Use CreateWindow.

Sintaxe

HWND CreateStatusWindowW(
  LONG    style,
  LPCWSTR lpszText,
  HWND    hwndParent,
  UINT    wID
);

Parâmetros

style

Tipo: LONG

Estilos de janela para a janela de status. Esse parâmetro deve incluir o estilo WS_CHILD e também deve incluir o estilo WS_VISIBLE.

lpszText

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o texto de status da primeira parte.

hwndParent

Tipo: HWND

manipule para a janela pai.

wID

Tipo: UINT

Identificador de controle para a janela de status. O procedimento de janela usa esse valor para identificar as mensagens enviadas para a janela pai.

Valor de retorno

Tipo: HWND

Retorna o identificador para a janela de status se tiver êxito ou NULL caso contrário. Para recuperar informações de erro estendidas, chame GetLastError.

Observações

A função CreateStatusWindow chama a função CreateWindow para criar a janela. Ele passa os parâmetros sem modificação e define os parâmetros de posição, largura e altura para CreateWindow valores padrão.

Nota

O cabeçalho commctrl.h define CreateStatusWindow como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h
biblioteca	Comctl32.lib
de DLL	Comctl32.dll

Compartilhar via