update-lamp

Arguments: lamp

Causes the specified lamp widget to be redisplayed, including in any grid-widget cells that display it. The return value is undefined.

Updating is usually not needed since replacing lamp properties will update the lamp automatically. But if a lamp's value is an array and an application modifies the array's values directly, the lamp widget does not realize this (or so does not redispaly automatically). In that case a call to update-lamp is needed to ensure that the lamp is redisplayed to reflect the new values in the array.

It also works to set the value property of the lamp widget to be the array that is already the value of that property. This was the required technique before update-lamp was added.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.