GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Nine — Dialog Functions (continued)

9.25 Tab Control

9.25.1 Introduction

The tab control allows for tabs to be defined as folder tabs or buttons depending on the specified style. The control can be accessed as the Windows class “SysTabControl32” and alias “TabControl”.

The control can be placed anywhere but for tabs, it is usually on the top of the dialog page. Unlike a property sheet, the tab control does not control the remaining controls on the dialog page. It is up to the programmer to change, hide or show tabs based on the selected tab.

The tab control sends its notifications via the notify procedure. Primary notifications, as prefixed by TCN_, can be passed through to the action procedure if a notify procedure is not defined.

9.25.2 Tab Control Types and Styles

An example tab control:

CONTROL "", 101, "SysTabControl32", TCS_TOOLTIPS | WS_CHILD | WS_VISIBLE, 8, 4, 184, 13, 0

9.25.3 Tab Control Notifications

Tab messages are sent via the notify procedure. If that procedure is not defined, no NM_ type message notifications are passed to the action procedure.

	Notification code		Value		Description
	NM_CLICK (tab)				The user clicked the left mouse button within the control.
	NM_DBLCLK (tab)				The user double-clicked the left mouse button within the control.
	NM_RCLICK (tab)				The user clicked the right mouse button within the control.
	NM_RDBLCLK (tab)				The user double-clicked the right mouse button within the control.
	NM_RELEASEDCAPTURE (tab)				Control is releasing mouse capture.
	TCN_FOCUSCHANGE				Tab button focus has changed.
	TCN_GETOBJECT				Sent when it has the TCS_EX_REGISTERDROP extended style and an object is dragged over a tab item in the control.
	TCN_KEYDOWN				A key has been pressed.
	TCN_SELCHANGE				The currently selected tab has changed.
	TCN_SELCHANGING				The currently selected tab is about to change.

In response to a message, the action procedure should calculate and set the new scroll position. Note that the notifications only express what the user requested, but the control must be updated by the scroll to reflect the new position.

9.25.4 Tab Control Functions

ControlDisable — Disables specified control.

ControlEnable — Enables specified control.

ControlHide — Hides a specified control.

ControlShow — Shows a specified control (if hidden).

TabControlAdd — Creates a new tab at the end of the tab list.

TabControlDelete — Deletes a tab at the specified index position.

TabControlDeleteAll — Deletes all tabs.

TabControlGetCount — Returns the total number of tabs in the control.

TabControlGetSelection — Returns the currently selected tab index in the tab control.

TabControlInsert — Inserts a new tab at the specified index position.

TabControlSelect — Selects the specified tab.

Page revised 2024-12-13

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.