Estrutura AASHELLMENUITEM (shlobj.h)

  • Artigo

Contém informações sobre um item de menu.

Sintaxe

typedef struct tagAASHELLMENUITEM {
  void                  *lpReserved1;
  int                   iReserved;
  UINT                  uiReserved;
  LPAASHELLMENUFILENAME lpName;
  LPWSTR                psz;
} AASHELLMENUITEM, *LPAASHELLMENUITEM;

Membros

lpReserved1

Tipo: VOID

Reservado. Os aplicativos devem ignorar esse valor.

iReserved

Tipo: int

Reservado. Os aplicativos devem ignorar esse valor.

uiReserved

Tipo: UINT

Reservado. Os aplicativos devem ignorar esse valor.

lpName

Tipo: LPAASHELLMENUFILENAME

Se o item de menu selecionado representar um arquivo, esse membro será um ponteiro para uma estrutura AASHELLMENUFILENAME que contém o nome do arquivo. Caso contrário, esse membro será NULL.

psz

Tipo: LPTSTR

Um ponteiro para a cadeia de caracteres que contém o texto a ser usado se não houver nenhum arquivo.

Comentários

Importante Essa estrutura não pode ser usada com sistemas operacionais posteriores ao Windows 2000.
 
Se o menu pertencer ao processo de Explorer do Windows e o item de menu for MFT_OWNERDRAW e dwItemData não for NULL, o membro dwItemData poderá ser investigado para determinar se é um menu do Windows Explorer que mostra nomes de arquivo desenhados pelo proprietário.

A ferramenta de acessibilidade pode tratar o membro dwItemData como um ponteiro para uma estrutura AASHELLMENUITEM no processo que possui o menu. Nesse caso, os membros lpName e psz podem ser examinados para determinar a identidade do item de menu. Se lpName não for NULL, o item de menu representará um nome de arquivo, expresso como uma estrutura AASHELLMENUFILENAME . Se lpName for NULL , mas psz não for NULL, o item de menu representará uma cadeia de caracteres apontada pelo membro psz .

Os membros lpName e psz contêm ponteiros para o processo que possui o menu.

Nota Nem todos os menus de desenho do proprietário no processo de Explorer do Windows estão em conformidade com essa convenção.
 
Os aplicativos que investigam os dados do menu de desenho do proprietário devem validar todos os dados lidos do processo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho shlobj.h

Confira também

AASHELLMENUFILENAME