Estrutura MSAAMENUINFO (oleacc.h)
Usado por desenvolvedores de servidores para expor os nomes dos itens de menu desenhados pelo proprietário.
Sintaxe
typedef struct tagMSAAMENUINFO {
DWORD dwMSAASignature;
DWORD cchWText;
LPWSTR pszWText;
} MSAAMENUINFO, *LPMSAAMENUINFO;
Membros
dwMSAASignature
Tipo: DWORD
Deve ser MSAA_MENU_SIG, que é definido em oleacc.h.
cchWText
Tipo: DWORD
Comprimento, em caracteres, do texto do item de menu, não incluindo o caractere terminado em nulo Unicode.
pszWText
Tipo: LPWSTR
O texto do item de menu, em Unicode, incluindo o caractere terminado em nulo Unicode.
Comentários
Ao associar a estrutura MSAAMENUINFO aos dados de item de menu desenhados pelo proprietário, os desenvolvedores de servidores podem expor os itens de menu sem precisar implementar o IAccessible.
A estrutura MSAAMENUINFO é o primeiro membro da estrutura específica do aplicativo (ou classe) que contém os dados de um item de menu desenhado pelo proprietário, que é apontado pelo membro dwItemData da estrutura MENUITEMINFO .
A estrutura MSAAMENUINFO não pode ser um membro em uma classe que contém funções virtuais porque o primeiro membro da classe é sempre um ponteiro gerado pelo compilador para uma tabela das funções virtuais. Para contornar esse problema, você pode implementar uma estrutura que contém o MSAAMENUINFO como o primeiro membro e um ponteiro para a classe com as funções virtuais como um segundo membro, que contém os dados de item desenhados pelo proprietário.
Exemplos
O fragmento de código a seguir mostra a declaração de uma estrutura de informações de menu desenhadas pelo proprietário específica do aplicativo que inclui MSAAMENUINFO:
// Application-specific owner-drawn menu info struct. Owner-drawn data
// is a pointer to one of these. MSAAMENUINFO must be the first
// member.
struct MenuEntry
{
MSAAMENUINFO m_MSAA; // MSAA info - must be first element.
LPTSTR m_pName; // Menu text, for display. NULL for
// separator item.
int m_CmdID; // Menu command ID.
int m_IconIndex; // Index of icon in bitmap.
};
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | oleacc.h |
| Redistribuível | Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95 |