IMessageFormEx::GetMenuCapabilities

9/8/2008

The GetMenuCapabilities método é chamado pelo Messaging Application para consulta o add-in e determinar qual menu comandos ele pode processo (ou seja, qual menu forma Mensagem comandos para habilitar e quais para desativar).

Syntax

HRESULT GetMenuCapabilities (
  DWORD dwFlags,
  DWORD * pdwEnable
);

Parameters

• dwFlags
  [no] Máscara de bits especificando o conjunto completo de recursos comando possíveis.

  Para informações em todas as constantes possíveis que podem ser combinadas para criar dwFlags e MapVirtualKey. pdwEnable (Cada constante representa um item de menu que podem ser exibidas sobre o barra de menus) consulte Message Form Host Command Bar Capability Flags.

• pdwEnable
  [out] Referência a outro máscara de bits que especifica o conjunto de recursos menu que oferece suporte a add-in.

  Para informações em todas as constantes possíveis que podem ser combinadas para criar dwFlags e MapVirtualKey. pdwEnable (Cada constante representa um item de menu que podem ser exibidas sobre o barra de menus) consulte Message Form Host Command Bar Capability Flags.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

Novo Comportamento para GetMenuCapabilities

Ao consultar mensagens formulários baseados em IMessageFormEx2 com IMessageFormEx::GetMenuCapabilities, o comportamento das dwFlags parâmetro difere do que usou para formulários de mensagens criados usando IMessageFormEx. As alterações são da seguinte maneira:

• Os bits de quatro parte superior de dwFlags se tornam "Region" bits e os 28 bits restantes são tratados como o "Recurso de menu" bits.
• Essa abordagem fornece 16 x 28 = 448 diferente (do menu RecursosIMessageFormEx Oferece suporte a um máximo de 32).
• Definir o estendido de barra de comandos são recursos introduzidos em Windows Mobile 6 associado com Region 1. Para uma listagem do estendido recursos, consulte O conjunto estendido de constantes recurso Barra de comando seção em Message Form Host Command Bar Capability Flags.
• Os recursos na região 1 são nomeado como MESSAGEFORMHOST2_CMDBARCAP2_xxxe em 2 Região como MESSAGEFORMHOST2_CMDBARCAP3_xxx, etc..

Para compatibilidade com versões anteriores, a maneira de determinar se um Message Form oferece suporte ao estendido menu recursos é da seguinte maneira:

• Quando dwFlags tem qualquer bits de região definida, mas não tem qualquer bits item menu Definir —IMessageFormEx::GetMenuCapabilities é executado em um alternativo modo conhecido como Detection Mode.
• No modo de detecção, IMessageFormEx::GetMenuCapabilities Retorna (in a *pdwEnable Sem parâmetro) um máscara de bits com todos os bits Menu Capability definido como um se estendido funcionalidade é com suporte, todos os bits definidos como zero se não for.

De exemplo, a chamar GetMenuCapabilites(0x10000000, &dwEnable) Retorna 0x1fffffff Se o formulário de mensagem oferecer suporte o estendido menu Recursos, e 0x10000000 Se ele não.

Remarks

O aplicativo de mensagens chama o formulário de mensagem com GetMenuCapabilities Passando em uma lista de todos os itens de menu que, possivelmente, podem aparecer no menu. Essa lista é passada a dwFlags parâmetro e é um máscara de bits criada combinando zero ou mais Message Form Host Command Bar Capability Flags usando a bit a bit Ou. Para exemplo, use MESSAGEFORMHOST2_CMDBARCAP_CUT | MESSAGEFORMHOST2_CMDBARCAP_PASTE Para incluir ambos o Recortar e MapVirtualKey. Colar Comandos menu. GetMenuCapabilities Retorna uma segunda lista que contém apenas os itens menu que oferece suporte a add-in. Itens de menu que aparecem na entrada lista, mas que são ausente na lista de saída, aparecem cinza - saída no Add - In do menu.

Requirements

Header	cemapi.h
Library	cemapi.lib
Windows Embedded CE	Windows CE .NET 4.2 and later
Windows Mobile	Pocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later

See Also

Reference

IMessageFormEx
IMessageFormEx2
IMessageFormEx2::GetMenuCapability

Other Resources

Messaging