Face Renderers

Face renderers are responsible for applying the properties of a face to buttons and menu items. They allow GUI Commands to apply global styles to the buttons and menus created by the library. Generally you won't need to use renderers unless you want to change the default settings.

Toolbars Options

Since it's very common to generate toolbars buttons that only display icons, the default face renderer does this automatically. This means you generally don't need to define a separate face for the toolbar context.

The other option is that you can configure toolbar buttons to always display the text below the icon. In this case you would need to enable toolbar button text prior to doing so.

The following example shows configuring the renderer to show toolbar text below the icon:

   FaceRenderer renderer = GuiCommands.defaults().getFaceRender();
   renderer.setPositionToolbarTextBelowIcon(true);
   renderer.setHideToobarText(false);

Mac Face Renderer

GUI Commands provides a special renderer when running on the Mac. This is covered in the next section.