ITaskbarList3::ThumbBarUpdateButtons-Methode (shobjidl_core.h)

Zeigt Schaltflächen in einer Miniaturansichtssymbolleiste an, aktiviert, deaktiviert oder blendet sie aus, je nach dem aktuellen Zustand des Fensters. Eine Miniaturansichtssymbolleiste ist eine Symbolleiste, die in eine Miniaturansicht eines Fensters in einem Flyout der Taskleiste eingebettet ist.

Syntax

HRESULT ThumbBarUpdateButtons(
  [in] HWND          hwnd,
  [in] UINT          cButtons,
  [in] LPTHUMBBUTTON pButton
);

Die Parameter

[in] hwnd

Typ: HWND-

Das Handle des Fensters, dessen Miniaturansicht die Symbolleiste enthält.

[in] cButtons

Typ: UINT

Die Anzahl der im Array definierten Schaltflächen, auf die von pButton verwiesen wird. Die maximale Anzahl zulässiger Schaltflächen beträgt 7. Dieses Array enthält nur Strukturen, die vorhandene Schaltflächen darstellen, die aktualisiert werden.

[in] pButton

Typ: LPTHUMBBUTTON

Ein Zeiger auf ein Array von THUMBBUTTON-Strukturen . Jedes THUMBBUTTON definiert eine einzelne Schaltfläche. Wenn die Schaltfläche bereits vorhanden ist (der iId-Wert ist bereits definiert), wird diese vorhandene Schaltfläche mit den informationen in der Struktur aktualisiert.

Rückgabewert

Typ: HRESULT-

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Da es einen begrenzten Platz gibt, in dem Miniaturansichten angezeigt werden sollen, sowie eine ständig ändernde Anzahl von Miniaturansichten, die angezeigt werden sollen, werden Anwendungen nicht garantiert eine bestimmte Symbolleistengröße. Wenn der Anzeigebereich niedrig ist, werden die Schaltflächen in der Symbolleiste nach Bedarf von rechts nach links abgeschnitten. Daher sollte eine Anwendung die Befehle priorisieren, die ihren Schaltflächen zugeordnet sind, um sicherzustellen, dass die Befehle mit der höchsten Priorität links liegen und daher am wenigsten abgeschnitten werden.

Miniaturansichtssymbolleisten werden nur angezeigt, wenn Miniaturansichten auf der Taskleiste angezeigt werden. Wenn beispielsweise eine Taskleistenschaltfläche eine Gruppe mit mehr geöffneten Fenstern darstellt, als Platz zum Anzeigen von Miniaturansichten vorhanden ist, wird die Benutzeroberfläche auf ein Legacymenü und nicht auf Miniaturansichten zurückgesetzt.

Accessibility

Informationen zur Barrierefreiheit in Miniaturleisten-Schaltflächenbildern finden Sie im Abschnitt "Hinweise" von ThumbBarSetImageList.

Examples

Das folgende Beispiel zeigt, wie Sie thumbBarUpdateButtons verwenden, um den Text und das Bild auf einer vorhandenen Schaltfläche in einer Miniaturansichtssymbolleiste auf der erweiterten Taskleiste zu ändern.

HRESULT UpdateThumbBarButton(HWND hwnd)
{
    // Define a single structure for the button to update. The ID is that
    // of an existing button, so the other information (bitmap index and 
    // tooltip) overwrites the existing values, updating the button.
    THUMBBUTTON thbButton;
    thbButton.dwMask = THB_BITMAP | THB_TOOLTIP;
    thbButtons[0].iId = 1;
    thbButton.iBitmap = 3;
    thbButton.pszTip = TEXT("Different Text");
    
    // Create an instance of ITaskbarList3
    ITaskBarList3 *ptbl;
    HRESULT hr = CoCreateInstance(CLSID_TaskbarList, 
                                  NULL, 
                                  CLSCTX_INPROC_SERVER, 
                                  IID_PPV_ARGS(&ptbl);

    if (SUCCEEDED(hr))
    {
        // Update the toolbar. In this case, only the single button is updated.
        hr = ptbl->ThumbBarUpdateButtons(hwnd, 1, &thbButton);
        ptbl->Release();
    }
    return hr;
}

Anforderungen

Siehe auch

ITaskbarList

ITaskbarList2

ITaskbarList3

ITaskbarList3::ThumbBarSetImageList

ITaskbarList3::ThumbBarAddButtons

Taskleistenerweiterungen