Habe den Befehl selbst nie benutzt, aber du kannst zusätzlich abfragen ob die Maus sich über dem Button befindet und nur dann beim gedrückt halten den runter gedrückten Button drawen lassen, ansonsten den normalen. Ist tatsächlich etwas suboptimal das Beispiel in der Help.

Was ist eigentlich die beste Lösung.

Objekte als Buttons oder draw_button und dann mouse_x,mouse_y abfragen.

Das wird ja meistens unübersichtlich, wenn man views und ein Menue GUI usw benutzt.

Oder gibt es eine bessere Lösung?

Je nachdem wo. Oft genug benutze ich einfach draw_rectangle mit verschiedenen Farben und frage dann x und y ab.
Kommt auf die Situation an. Mache ich meistens daran fest, wie viele Buttons in welcher Anordnung gebraucht werden.