mozilla
Your Search Results

    nsITaskbarTabPreview

    This interface is used on Microsoft Windows to control tab preview specific behavior.
    1.0
    28
    Introduced
    Gecko 1.9.2
    Inherits from: nsITaskbarPreview Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)

    Note: 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.

    Note: 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

    Document Tags and Contributors

    Contributors to this page: Sheppy, ch.ey, trevorh
    Last updated by: Sheppy,