nsITaskbarPreview
Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Creating an nsITaskbarTabPreview for a window will automatically hide that window's nsITaskbarWindowPreview; this is done by Windows and cannot be prevented. When there are no more tab previews left for a window, the window preview is automatically made visible again.
An application may have as many tab previews as memory allows.
You can't directly instantiate this interface; instead, call the nsIWinTaskbar.createTaskbarTabPreview().
Method overview
void EnsureRegistration(); Violates the XPCOM interface guidelines |
nativeWindow GetHWND(); Violates the XPCOM interface guidelines |
void move(in nsITaskbarTabPreview aNext); |
Attributes
| Attribute | Type | Description |
icon |
imgIContainer |
The icon displayed next to the title in the preview. This is null by default. |
title |
DOMString |
The title displayed above the thumbnail. By default, this is an empty string. |
Methods
EnsureRegistration()
Used internally to ensure that the taskbar knows about this preview. If a preview is not registered, the API call to set its sibling (via the move() method) will fail silently.
void EnsureRegistration();
Parameters
None.
GetHWND()
Used internally to obtain the handle to the proxy window for the preview.
nativeWindow GetHWND();
Parameters
None.
Return value
The HWND for the preview's proxy window.
move()
Relocates the preview relative to another tab preview from the same window.
void move( in nsITaskbarTabPreview aNext );
Parameters
-
aNext -
The preview that this preview should be placed to the left of. A value of
nullindicates that this preview should be the rightmost one.