Unterstützung des Popupmenüs

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Der Microsoft-Agent enthält ein Popupmenü (auch als Kontextmenü bezeichnet) für jedes Zeichen. Der Server zeigt dieses Popupmenü automatisch an, wenn ein Benutzer mit der rechten Maustaste auf das Zeichen klickt. Sie können dem Menü Befehle für Ihre Clientanwendung hinzufügen, indem Sie eine Commands Collection definieren. Für jeden Befehl in der von Ihnen definierten Auflistung können Sie Caption- und Visible-Eigenschaften angeben. Die Caption- ist der Text, der im Menü angezeigt wird, wenn die eigenschaft Visible auf Truefestgelegt ist. Sie können auch die Eigenschaft Enabled verwenden, um den Befehl im Menü als deaktiviert anzuzeigen, und die HelpContextID-, um die Hilfeunterstützung für die Eigenschaft zu unterstützen. Definieren Sie die Zugriffstaste für den Menütext, indem Sie ein kaufmännisches Und-Zeichen (&) vor dem Textzeichen der Beschriftung Texteinstellung einfügen.

Der Server fügt den Menübefehlen automatisch hinzu, um das Sprachbefehlsfenster zu öffnen und das Zeichen sowie die Befehle Beschriftungen anderer Clients des Zeichens auszublenden, damit Benutzer zwischen Clients wechseln können. Der Server fügt dem Menü automatisch ein Trennzeichen zwischen den Menüeinträgen und den vom Client definierten Einträgen hinzu. Trennzeichen werden nur angezeigt, wenn im Menü Elemente zum Trennen vorhanden sind.

Verwenden Sie zum Entfernen von Befehlen aus einem Menü die Remove-Methode. Beachten Sie, dass menüeinträge während der Anzeige des Menüs nicht geändert werden. Wenn Sie Befehle hinzufügen oder entfernen oder deren Eigenschaften ändern, zeigt das Menü die Änderungen an, wenn der Benutzer das Menü erneut anzeigt.

Wenn Sie ihre eigenen Popupmenüdienste für ein Zeichen bereitstellen möchten, können Sie die AutoPopupMenu-eigenschaft verwenden, um die Serverbehandlung der Rechtsklickaktion zu deaktivieren. Anschließend können Sie die Click-Ereignisbenachrichtigung verwenden, um ein eigenes Menübehandlungsverhalten zu erstellen.

Wenn der Benutzer einen Befehl aus dem Popupmenü eines Zeichens oder aus dem Sprachbefehlsfenster auswählt, löst der Server das Command-Ereignis des zugeordneten Clients aus und übergibt die Parameter der Eingabe mithilfe des UserInput--Objekts zurück.

Der Server stellt außerdem ein Popupmenü für das Taskleistensymbol des Zeichens bereit. Wenn das Zeichen sichtbar ist, zeigt das Klicken mit der rechten Maustaste auf dieses Menü dieselben Befehle wie die Befehle an, die durch Klicken mit der rechten Maustaste auf das Zeichen angezeigt werden. Wenn das Zeichen jedoch ausgeblendet ist, sind nur die vom Server bereitgestellten Befehle enthalten.