nsITaskbarTabPreview 编辑

widget/public/nsITaskbarTabPreview.idlScriptable This interface is used on Microsoft Windows to control tab preview specific behavior. 1.0 66 Introduced Gecko 1.9.2 Inherits from: 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

Violates the XPCOM interface guidelines

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.

Violates the XPCOM interface guidelines

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.

See also

• nsITaskbarPreview
• nsITaskbarPreviewController
• nsITaskbarWindowPreview
• nsITaskbarPreviewButton
• nsIWinTaskbar