Help-acties schrijven

De interface ILiveHelpAction wordt gebruikt om een actieve Help-actie te bouwen.

Het is gemakkelijk om een ILiveHelpAction te implementeren. U moet twee methoden implementeren.

Hieronder ziet u een eenvoudige implementatie van een live Help-actie waarmee een berichtvenster wordt geopend. Er is geen JavaScript-informatie nodig, dus de initialisatiegegevens worden genegeerd.

package org.eclipse.platform.doc.isv.activeHelp;

import org.eclipse.help.ILiveHelpAction;
import org.eclipse.jface.dialogs.MessageDialog;
import org.eclipse.swt.widgets.*;
import org.eclipse.ui.*;
/**
 * Voorbeeld van actieve-hulpactie.
 */
public class ActiveHelpOpenDialogAction implements ILiveHelpAction {

     public void setInitializationString(String data) {
          // De gegevens worden genegeerd. Er worden geen Javascript-parameters gebruikt.
     }

      public void run() {
          // Actieve hulp kan niet worden uitgevoerd op de gebruikersinterfacethread, dus u moet syncExec gebruiken.
          Display.getDefault().syncExec(new Runnable() {
      public void run() {
                    IWorkbenchWindow window =
                         PlatformUI.getWorkbench().getActiveWorkbenchWindow();
   if (window != null) {
                         // Hiermee geeft u het Workbench-venster op de voorgrond (vóór andere vensters) weer.
                         // In sommige Windows-systemen zal alleen het pictogram van de Workbench
                         // op de taakbalk knipperend worden weergegeven.
                         Shell shell = window.getShell();
                         shell.setMinimized(false);
                         shell.forceActive();
                         // Berichtvenster openen
      MessageDialog.openInformation(
                              window.getShell(),
                              "Hallo wereld.",
                              "Hallo wereld.");
                    }
               }
          });
     }
}