Função ShellAboutW (shellapi.h)

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

Digite: HWND

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

[in] szApp

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém 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 o # 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 as informações de versão e direitos autorais. Este 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.

Retornar valor

Tipo: int

TRUE se tiver êxito; caso contrário, FALSE.

Comentários

Observe que a caixa de diálogo 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 menu Ajuda no Windows Explorer.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shellapi.h
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 3.51 ou posterior)
Conjunto de APIs	ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)