Struttura MSAAMENUINFO (oleacc.h)

Usato dagli sviluppatori di server per esporre i nomi delle voci di menu disegnate dal proprietario.

Sintassi

typedef struct tagMSAAMENUINFO {
  DWORD  dwMSAASignature;
  DWORD  cchWText;
  LPWSTR pszWText;
} MSAAMENUINFO, *LPMSAAMENUINFO;

Members

dwMSAASignature

Tipo: DWORD

Deve essere MSAA_MENU_SIG, definito in oleacc.h.

cchWText

Tipo: DWORD

Lunghezza, in caratteri, del testo per la voce di menu, non incluso il carattere con terminazione Null Unicode.

pszWText

Tipo: LPWSTR

Testo della voce di menu, in Unicode, incluso il carattere con terminazione Null Unicode.

Commenti

Associando la struttura MSAAMENUINFO ai dati delle voci di menu disegnate dal proprietario, gli sviluppatori di server possono esporre le voci di menu senza dover implementare IAccessible.

La struttura MSAAMENUINFO è il primo membro della struttura specifica dell'applicazione (o classe) che contiene i dati per una voce di menu disegnata dal proprietario, a cui punta il membro dwItemData della struttura MENUITEMINFO .

La struttura MSAAMENUINFO non può essere un membro di una classe che contiene funzioni virtuali perché il primo membro della classe è sempre un puntatore generato dal compilatore a una tabella delle funzioni virtuali. Per risolvere questo problema, è possibile implementare una struttura contenente MSAAMENUINFO come primo membro e un puntatore alla classe con le funzioni virtuali come secondo membro, che contiene i dati degli elementi disegnati dal proprietario.

Esempio

Il frammento di codice seguente mostra la dichiarazione di una struttura di informazioni sul menu disegnata dal proprietario specifica dell'applicazione che include 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.
};

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione oleacc.h
Componente ridistribuibile Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95

Vedi anche

Esposizione di voci di menu Owner-Drawn

Iaccessible