set-label in check-box%

Sets a window's label. The window's natural minimum size might be different after the label is changed, but the window's minimum size is not recomputed.

See get-label for more information.

• (send a-check-box set-label label) -> void
     label : bitmap% object

  Since label is a bitmap, the bitmap must be valid (see ok? in bitmap%) and not installed in a bitmap-dc% object; otherwise, an exn:fail:contract exception is raised. If the bitmap has a mask (see get-loaded-mask in bitmap%) that is the same size as the bitmap, then the mask is used for the label; furthermore, in contrast to the limitations of draw-bitmap in dc<%>, non-monochrome label masks work consistently on all platforms. The bitmap label is installed only if the control was originally created with a bitmap label.

  
  

• (send a-check-box set-label l) -> void
     l : string (up to 200 characters)

  If the window was not created with a label, or if the window was created with a non-string label, l is ignored.