Função ShellAboutA (shellapi.h)

Exibe uma caixa de diálogo ShellAbout .

Sintaxe

INT ShellAboutA(
  [in, optional] HWND   hWnd,
  [in]           LPCSTR szApp,
  [in, optional] LPCSTR 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.

Requisitos