Documentation Center

Highlighting a control

You can customize the appearance of a highlighted UI control object by editing an attribute of its corresponding control element in the controls.xml file.

About this task

A control is highlighted when a user places the mouse over it. Its appearance when highlighted is controlled by the highlight attribute in the controls.xml file. You can use this functionality to specify an image to be used for the control when it is highlighted. To do so, specify the desired image in the <highlight> tag within the control's definition in the controls.xml file.

Procedure

  1. Open the controls.xml file in a text editor.
  2. In the controls.xml file, locate the control element corresponding to the desired UI object.
    For example, to specify the image displayed for a highlighted Print icon, locate the <control id="CVCtrl_print" type="icon"> tag.
  3. To specify the image to be used for the highlighted Print icon, assign it a class such as the following.
    <highlight className="toolbar_button tbar_print highlightIcon"/>

    In this example, the specified class will be applied to the icon when it is highlighted.

  4. Save and close the controls.xml file.