UserBar_Add fügt ein Kommando in die Benutzerschalterleiste ein. Das Kommando muss mit der Funktion RegisterCommand vorher registriert worden sein.
Returnwert
bool ist TRUE (1), wenn die Funktion erfolgreich war. und sonst FALSE (0). .. us.params
Parameter
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(rvHandle[4]);
rmXY[;2] = rmXY[;2] * 1.034 + 0.123;
XYSetData(rvHandle[4], rmXY[;1], rmXY[;2]);
}
id-1419623