Função ShellAboutW (shellapi.h)

Artigo
11/20/2024

Exibe uma caixa de diálogo ShellAbout.

Sintaxe

INT ShellAboutW(
  [in, optional] HWND    hWnd,
  [in]           LPCWSTR szApp,
  [in, optional] LPCWSTR szOtherStuff,
  [in, optional] HICON   hIcon
);

Parâmetros

[in, optional] hWnd

Tipo: HWND

Um identificador de janela para uma janela pai. Esse parâmetro pode ser NULL.

[in] szApp

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto a ser exibido na barra de título da caixa de diálogo ShellAbout e na primeira linha da caixa de diálogo após o texto "Microsoft". Se o texto contiver um separador (#) que o divide em duas partes, a função exibirá a primeira parte na barra de título e a segunda parte na primeira linha após o texto "Microsoft".

Windows 2000, Windows XP, Windows Server 2003: se a cadeia de caracteres apontada por esse parâmetro contiver um separador (#), a cadeia de caracteres deverá ser gravável.

Windows Vista, Windows Server 2008: essa cadeia de caracteres não pode exceder 200 caracteres de comprimento. O conteúdo do szApp não será mais exibido após "Microsoft", a menos que haja um separador #, nesse caso, a parte após a # substituirá completamente a primeira linha.

[in, optional] szOtherStuff

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém texto a ser exibido na caixa de diálogo após a versão e as informações de direitos autorais. Esse parâmetro pode ser NULL.

[in, optional] hIcon

Tipo: HICON

O identificador de um ícone que a função exibe na caixa de diálogo. Esse parâmetro pode ser NULL, caso em que a função exibe o ícone do Windows.

Valor de retorno

Tipo: int

verdadeiro se bem-sucedido; caso contrário, FALSE .

Observações

Observe que a caixa de diálogo de função ShellAbout usa texto e um ícone padrão específicos do Windows.

Para ver um exemplo de uma caixa de diálogo ShellAbout, escolha Sobre o Windows na lista suspensa do menu da Ajuda no Windows Explorer.

Nota

O cabeçalho shellapi.h define ShellAbout 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 XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shellapi.h
biblioteca	Shell32.lib
de DLL	Shell32.dll (versão 3.51 ou posterior)
conjunto de API	ext-ms-win-shell-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)

Compartilhar via