.toolhelp

2.379 .toolhelp

Wenn dieses Attribut gesetzt ist, erscheint ein kleines Popup mit dem spezifizierten Text, sobald sich der Mauszeiger für kurze Zeit bewegungslos innerhalb des jeweiligen Objekts befindet. Das Popup wird automatisch nach einer gewissen Zeitspanne oder bei Bewegung des Mauszeigers wieder ausgeblendet.

Die Popups lassen sich für die Anzeige einer kurzen Erklärung zu einem Objekt einsetzen.

Definition

Datentyp

object [ text ]
Zugriff

get, set
changed-Ereignis

ja

Unterstützung des Attributs durch Objekte

Beispiel

child pushbutton PbOK
{
  .text      "OK";
  .toolhelp  "accepts file";
}

Hinweise zum IDM für Motif

Unter Motif lassen sich Vorder- und Hintergrundfarbe mittels X-Ressourcen einstellen, z.B.:
```
IDM*ToolHelpLabel.Background: red
IDM*ToolHelpLabel.Foreground: blue
```
Als Standard verwendet der IDM LightYellow als Hintergrundfarbe und Black als Vordergrundfarbe.
Der X-Toolkit-Name des Toolhelp-Objekts ist ToolHelpLabel.

Hinweise zum IDM für Windows

WM_MOUSEMOVE-Ereignisse, die von anderen Anwendungen provoziert werden, können das Ein- und Ausblenden der Toolhelp stören. Zum Beispiel kann es vorkommen, dass sie sich nach dem Umsetzen von .toolhelp öffnet, obwohl die Maus nicht bewegt wurde. Es kann auch sein, dass eine sichtbare Toolhelp nicht wieder ausgeblendet wird oder eine Toolhelp gar nicht eingeblendet wird.

Ein anwendungsgesteuertes Öffnen von Toolhelps ist nicht vorgesehen. Wenn dies gewünscht wird, kann mit der Funktion DM_GetToolkitData() das Attribut AT_toolhelp des Setup-Objekts abgefragt werden, um das Windows-Handle des Tooltip Controls zu erhalten, das der ISA Dialog Manager für die Darstellung verwendet.

Mit dem folgenden Beispielcode kann die Toolhelp geöffnet werden:

#include <windows.h>
#include <commctrl.h>
#include IDMuser.h
 
void DML_default DM_ENTRY OpenToolhelp __0() {
  DM_ID idSetup = DM_ParsePath(
    (DM_ID) 0, (DM_ID) 0, "setup", 0, 0);
 
  if (idSetup != (DM_ID) 0) {
    HWND hwndToolhelp = (HWND) DM_GetToolkitData(
      idSetup, AT_toolhelp);
 
    if (hwndToolhelp != (HWND) 0) {
      SendMessage(hwndToolhelp, TTM_POPUP,
        (WPARAM) 0, (LPARAM) 0);
    }
  }
}

Die Funktion OpenToolhelp() muss im Dialog entsprechend definiert sein. Die Windows-Message TTM_POPUP ist erst ab Version 6 der Common Controls Library (comctl32.dll) verfügbar.