CMFCToolBar::ReplaceButton

Artikel
02/26/2013

Ersetzt eine Symbolleisten-Schaltfläche durch eine andere Symbolleistenschaltfläche.

int ReplaceButton(
   UINT uiCmd,
   const CMFCToolBarButton& button,
   BOOL bAll=FALSE 
);

Parameter

[in] uiCmd
Die Befehls-ID der Schaltfläche zu ersetzen.
[in] button
Ein Verweis auf CMFCToolBarButton Einfüge-.
[in] bAll
Ein boolescher Wert, der angibt, ob alle Schaltflächen ersetzt, die die Befehls-ID haben, wurden durch uiCmd an.Wenn dieser Parameter TRUE ist, werden alle Schaltflächen, die die angegebene Befehls-ID haben, ersetzt.Andernfalls wird die erste Schaltfläche ersetzt.

Rückgabewert

Die Anzahl der Schaltflächen, die ersetzt werden.Diese Methode gibt 0 zurück, wenn eine Schaltfläche mit der angegebenen Befehls-ID nicht von der Symbolleiste vorhanden ist.

Hinweise

Rufen Sie diese Methode auf, wenn Sie Symbolleisten-Schaltflächen hinzufügen möchten, die nicht von den Ressourcen geladen werden können.Sie können eine Platzhalterschaltfläche zur Entwurfszeit erstellen und diese Schaltfläche durch eine benutzerdefinierte Schaltfläche ersetzen, wenn Sie die Symbolleiste initialisieren.Siehe das VisualStudioDemo-Beispiel als ein Beispiel, das diese Methode verwendet wird.

Beispiel

Das folgende Beispiel zeigt, wie die ReplaceButton-Methode in der Klasse CMFCToolBar verwendet.Dieser Codeausschnitt ist Teil IE-Demobeispiel.

    CMFCToolBar     m_wndToolBar;


...


        // CMenu menuHistory
        // CString str
        m_wndToolBar.ReplaceButton (ID_GO_BACK, 
            CMFCToolBarMenuButton (ID_GO_BACK, menuHistory, 
                        GetCmdMgr ()->GetCmdImage (ID_GO_BACK), str));