ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Sidebar control
  • Overview
  • Configuring the Sidebar control tabs
  • Managing tabs
  • Managing the background image of tabs
  • States of tabs
  • Special case: image of 3-image tabs
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Characteristics of a Sidebar control
Overview
The main characteristics of a Sidebar control can be configured:
  • in the "General" tab of the control description: you can configure each tab of the Sidebar control.
  • in the "UI" tab of the control description: you can configure the behavior of the tabs.
  • in the "Details" tab of control description: you can choose the background image of the tabs.
Configuring the Sidebar control tabs
The "General" tab in the description window of the Sidebar control allows you to:
  • add, delete, insert new tabs.
  • configure (for the tab selected in the preview):
    • the initial state of the tab.
    • its caption.
    • the image associated with the text of the tab.
      Caution: This image is not displayed in the background of the tab but to the left of the text.
Remark: There are no automatic scrollbars in the tabs of Sidebar controls. If some controls cannot be displayed, the controls are truncated.
Managing tabs
The "UI" tab of the Sidebar control description window allows you to manage the display of tabs.
You can set:
  • the animation used when changing tabs.
  • the option to remember the active tab. If this option is selected, the state of the tab will be saved when the window is closed. This tab will be automatically selected the next time the window is opened.
Managing the background image of tabs
The "Details" tab of the Sidebar control description window allows you to manage the background image of the tabs. This image is used by all the tabs. This image can contain the different states of the tab.
Tip: To get outstanding images, check the image catalog of WINDEV/WINDEV Mobile and select a button image with 5 states.

States of tabs

You can manage the different states of the tab via the associated image.
Each state corresponds to a specific drawing. All the drawings are saved in a single image. This image is associated with the tab: all you have to do is specify the number of states (or drawings) found in the image file.
Example: BlueTab.gif image file
Idle, pressed, grayed out, selected, hovered tab
Idle, pressed, grayed out, selected, hovered tab
The following image formats are supported in Windows:
  • Bitmap (*.BMP)
  • Graphics Interchange Format (*.gif)
  • Joint Picture Experts Group (*.jpg ; *.jpeg)
  • Kodak Photo CD (*.pcd)
  • PaintBrush (*.pcx)
  • Adobe Photoshop Format (*.psd)
  • TrueVision TARGA (*.tga)
  • Tagged Image File Format (*.tif ; *.tiff)
    Remark: the "tiled tiff" option of tiff 6.0 standard is not supported. In this case, we advise you to save the image in tiff 5.0 standard.
  • Portable Network Graphics (*.png)
  • Windows MetaFiles (*.emf ; *.wmf)
  • Icons (*.ico ; *.icw)
    Remarks:
    • HQ display (High Quality) available.
    • Management of sheets in transparent BMP format (32 bits).
  • Cursors (*.cur)
  • Portable Document Format (*.pdf)
  • Scalable Vector Graphics (*.svg)
  • WINDEV images (generated by the image editor, *.WDPIC).

Special case: image of 3-image tabs

WINDEV will automatically split the tab image into three separate images.
The following criteria are used:
  • the image is divided into three sections
  • section 1 corresponds to the left area
  • section 3 corresponds to the right area
  • section 2 corresponds to the middle area. The size of this section is equal to 16 pixels. If the tab is proportional to the text, this part will be repeated as many times as necessary to fit the text.
Remark: If section 2 is smaller than 16 pixels, it is not recommended to use a tab proportional to the text. If necessary, integrate the additional images and the text into the image.
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 04/05/2023

Send a report | Local help