Compartilhar via

função Shell_MergeMenus (shlobj_core.h)

  • Artigo

[Shell_MergeMenus está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Mescla dois menus.

Sintaxe

UINT Shell_MergeMenus(
  [in] HMENU hmDst,
  [in] HMENU hmSrc,
       UINT  uInsert,
       UINT  uIDAdjust,
       UINT  uIDAdjustMax,
       ULONG uFlags
);

Parâmetros

[in] hmDst

Tipo: HMENU

O menu de destino ao qual hmSrc é adicionado.

[in] hmSrc

Tipo: HMENU

O menu de origem que é adicionado ao hmDst.

uInsert

Tipo: UINT

O ponto no hmDst após o qual as entradas no hmSrc são inseridas.

uIDAdjust

Tipo: UINT

Esse número é adicionado à ID de cada menu para fornecer uma ID ajustada. Defina como 0 para nenhum ajuste. O valor de uIDAdjust normalmente seria o número de itens em hmDst. Esse número pode ser obtido usando GetMenuItemCount.

uIDAdjustMax

Tipo: UINT

A ID máxima ajustada a ser adicionada ao menu. Qualquer ID ajustada maior que esse valor não é adicionada. Para permitir todas as IDs, defina esse parâmetro como 0xFFFF.

uFlags

Tipo: ULONG

Um ou mais dos sinalizadores a seguir.

MM_ADDSEPARATOR

Adicione um separador entre os itens dos dois menus se um ainda não existir. Se você estiver inserindo as entradas de hmSrc no meio do hmDst, um separador será adicionado acima e abaixo do material hmSrc .

MM_DONTREMOVESEPS

Não remova nenhum separador existente nos dois menus. Observe que isso pode resultar em dois separadores em uma linha.

MM_SUBMENUSHAVEIDS

Defina esse sinalizador se o submenu tiver IDs que devem ser ajustadas.

Retornar valor

Tipo: UINT

Retorna a próxima ID aberta no final do menu (a ID máxima ajustada + 1).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.0 ou posterior)
Conjunto de APIs ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)