Platforms to show: All Mac Windows Linux Cross-Platform
WindowsTaskbarListMBS class
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| class | Windows | MBS Win Plugin | 10.2 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
It allows you to dynamically add, remove, and activate items on the taskbar.
- 5 properties
- 16 methods
- method ActivateTab(WindowHandle as Integer)
- method AddTab(WindowHandle as Integer)
- method DeleteTab(WindowHandle as Integer)
- method MarkFullscreenWindow(WindowHandle as Integer, Fullscreen as Boolean)
- method RegisterTab(TabWindowHandle as Integer, MDIWindowHandle as Integer)
- method SetActiveAlt(WindowHandle as Integer)
- method SetOverlayIcon(TabWindowHandle as Integer, IconHandle as Integer, Description as string)
- method SetProgressState(WindowHandle as Integer, Flags as Integer)
- method SetProgressValue(WindowHandle as Integer, Completed as UInt64, Total as UInt64)
- method SetTabActive(TabWindowHandle as Integer, MDIWindowHandle as Integer)
- method SetTabOrder(TabWindowHandle as Integer, InsertBeforeWindowHandle as Integer)
- method SetTabProperties(TabWindowHandle as Integer, flags as Integer)
- method SetThumbnailClip(TabWindowHandle as Integer)
- method SetThumbnailClip(TabWindowHandle as Integer, x as Integer, y as Integer, w as Integer, h as Integer)
- method SetThumbnailTooltip(TabWindowHandle as Integer, tip as string)
- method UnregisterTab(TabWindowHandle as Integer)
- 10 constants
Constants
| Constant | Value | Description |
|---|---|---|
| ProgressStateFlagError | 4 |
One of the progress state flag constants.
The progress indicator turns red to show that an error has occurred in one of the windows that is broadcasting progress. This is a determinate state. If the progress indicator is in the indeterminate state, it switches to a red determinate display of a generic percentage not indicative of actual progress. |
| ProgressStateFlagIndeterminate | 1 |
One of the progress state flag constants.
The progress indicator does not grow in size, but cycles repeatedly along the length of the taskbar button. This indicates activity without specifying what proportion of the progress is complete. Progress is taking place, but there is no prediction as to how long the operation will take. |
| ProgressStateFlagNoProgress | 0 |
One of the progress state flag constants.
Stops displaying progress and returns the button to its normal state. Call this method with this flag to dismiss the progress bar when the operation is complete or cancelled. |
| ProgressStateFlagNormal | 2 |
One of the progress state flag constants.
The progress indicator grows in size from left to right in proportion to the estimated amount of the operation completed. This is a determinate progress indicator; a prediction is being made as to the duration of the operation. |
| ProgressStateFlagPaused | 8 |
One of the progress state flag constants.
he progress indicator turns yellow to show that progress is currently stopped in one of the windows but can be resumed by the user. No error condition exists and nothing is preventing the progress from continuing. This is a determinate state. If the progress indicator is in the indeterminate state, it switches to a yellow determinate display of a generic percentage not indicative of actual progress. |
| TabPropertyFlagNone | 0 |
One of the flag values you can use with SetTabProperties.
No specific property values are specified. The default behavior is used: the tab window provides a thumbnail and peek image, either live or static as appropriate. |
| TabPropertyFlagUseAppPeekAlways | 4 |
One of the flag values you can use with SetTabProperties.
Always use the peek image provided by the main application frame window rather than a peek image provided by the individual tab window. Do not combine this value with TabPropertyFlagUseAppPeekWhenActive; doing so will result in an error. |
| TabPropertyFlagUseAppPeekWhenActive | 8 |
One of the flag values you can use with SetTabProperties.
When the application tab is active and a live representation of its window is available, show the main application frame in the peek feature. At other times, use the tab window. Do not combine this value with TabPropertyFlagUseAppPeekAlways; doing so will result in an error. |
| TabPropertyFlagUseAppThumbnailAlways | 1 |
One of the flag values you can use with SetTabProperties.
Always use the thumbnail provided by the main application frame window rather than a thumbnail provided by the individual tab window. Do not combine this value with TabPropertyFlagUseAppThumbnailWhenActive; doing so will result in an error. |
| TabPropertyFlagUseAppThumbnailWhenActive | 2 |
One of the flag values you can use with SetTabProperties.
When the application tab is active and a live representation of its window is available, use the main application frame window thumbnail. At other times, use the tab window thumbnail. Do not combine this value with TabPropertyFlagUseAppThumbnailAlways; doing so will result in an error. |
This class has no sub classes.
Some examples using this class:
Blog Entries
- Show progress in task bar on Windows
- SetProgressState on Windows
- MBS REALbasic plug-ins version 10.2
The items on this page are in the following plugins: MBS Win Plugin.
WindowsSystemTrayMBS - WindowsTaskbarStateMBS
