- ObjectCreate
- ObjectName
- ObjectDelete
- ObjectsDeleteAll
- ObjectFind
- ObjectGetTimeByValue
- ObjectGetValueByTime
- ObjectMove
- ObjectsTotal
- ObjectSetDouble
- ObjectSetInteger
- ObjectSetString
- ObjectGetDouble
- ObjectGetInteger
- ObjectGetString
- TextSetFont
- TextOut
- TextGetSize
ObjectDelete
Entfernt das Objekt mit dem angegebenen Namen des angegebenen Charts.
bool ObjectDelete(
|
Parameter
chart_id
[in] Identifikator des Charts. 0 bedeutet den laufenden Chart.
name
[in] Name des entfernten Objekts.
Rückgabewert
Gibt true zurück, wenn ein Befehl zur Warteschlange des angegebenen Charts erfolgreich hinzugefügt wurde, andernfalls false.
Hinweis
Beim Aufruf von ObjectDelete() wird immer ein asynchroner Aufruf verwendet, deswegen gibt die Funktion nur das Ergebnis des Hinzufügens eines Befehls zur Warteschlange des Charts zurück. In diesem Fall bedeutet true nur, dass der Befehl zur Warteschlange erfolgreich hinzugefügt wurde, das Ergebnis der Ausführung ist unbekannt.
Für die Überprüfung des Ergebnisses der Ausführung kann man die Funktion ObjectFind() oder andere Funktionen verwenden, die die Eigenschaften des Objektes abrufen, z.B. vom Typ ObjectGetXXX. Dabei muss man beachten, dass solche Funktionen am Ende der Warteschlange hinzugefügt werden und auf das Ergebnis der Ausführung warten (weil sie synchrone Aufrufe sind). D.h. sie können viel Zeit in Anspruch nehmen. Dies muss man beachten, wenn man mit vielen Objekten im Chart arbeitet.
Bei der Umbenennung des graphischen Objekts werden gleichzeitig zwei Ereignisse gebildet, die im Expert oder im Anzeiger durch die Funktion OnChartEvent() verarbeitet werden können:
- Ereigniss der Entfernung des Objekts mit dem alten Namen;
- Ereignis der Erzeugung des graphischen Objekts mit dem neuen Namen.