UserBar_Add¶
UserBar_Add fügt ein Kommando in die Benutzerschalterleiste ein. Das Kommando muss mit der Funktion RegisterCommand vorher registriert worden sein.
-
bool = UserBar_Add(ssFunctionName)
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war. und sonst FALSE (0).
Parameter
-
ssFunctionName
ssFunctionName ist der Name der Funktion, die aufgerufen werden soll, wenn der Benutzer den entsprechenden Schalter aus der Benutzerschalterleiste drückt. Der Name der Funktion wird an UserBar_Add ohne die runden Klammern übergeben (siehe Beispiel). Die zu registrierende Funktion darf keine Parameterliste enthalten. Die Groß- und Kleinschreibung des Funktionsnames muss beachtet werden.
Beispiel
Das folgende Beispiel zeigt, wie man eine einfache Funktion für die Benutzerschalterleiste definieren kann und die Funktion registriert.
RegisterCommand("2D-Datensatz", "MyScaleFunc", "2D-Meine Skalierung");
UserBar_Add("MyScaleFunc");
def MyScaleFunc()
{
hvHandle = GetActiveXYHandles(); // defined in ic_util.ic
if (hvHandle[1] == 0) {
return;
}
rmXY = XYGetData(hvHandle[4]);
rmXY[;2] = rmXY[;2] * 1.034 + 0.123;
XYSetData(hvHandle[4], rmXY[;1], rmXY[;2]);
}
id-1419623