WinGanttBoxAdd
Dieser Befehl fügt einem GanttGraph-Objekt (obj) ein Box-Objekt hinzu. In (rect1) wird die linke obere und rechte untere Ecke des Rechtecks übergeben. Die Angabe erfolgt in Zellkoordinaten. Fehlt (int2), wird _WinColHighLight als Füllfarbe verwendet.
Über die Parameter (alpha3) und (alpha4) kann der Name und die Caption des Box-Objekts angegeben werden. Werden die Parameter nicht übergeben, bleiben die Eigenschaften leer.
Damit die Caption (alpha4) angezeigt wird, muss beim GanttGraph in der Eigenschaft GanttFlags der Wert _WinGanttIvlBoxShowText gesetzt sein.
Im erfolgreichen Fall ist das Resultat ein Deskriptor auf das Box-Objekt. Im Fehlerfall ist das Ergebnis 0.
Die Hintergrundfarbe der Box-Objekte kann Transparenzen enthalten. Ein Farbwert mit Transparenzen wird mit dem Befehl ``WinColorOpacitySet() erzeugt.
Beispiel:
// Box in erste Zeile und erster Spalte mit drei Zellen Breite
// und 2 Zellen Höhe und schwarzer Füllfarbe und 50 Prozent Deckkraft erzeugen
$GanttGraph->WinGanttBoxAdd(RectMake(0, 0, 3, 2), WinColorOpacitySet(_WinColBlack, 50));
Mögliche Laufzeitfehler:
_ErrHdlInvalid: GanttGraph (obj) ungültig