nsITaskbarPreview
Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Tab preview support is disabled by default in Gecko 1.9.2
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.
This method is only invoked when it's safe to make taskbar API calls.
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
null
indicates that this preview should be the rightmost one.