CMFCToolBarsCustomizeDialog::AddButton
Inserta un botón de la barra de herramientas de la lista de comandos en la página de Comandos .
void AddButton(
UINT uiCategoryId,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
void AddButton(
LPCTSTR lpszCategory,
const CMFCToolBarButton& button,
int iInsertBefore=-1
);
Parámetros
[in] uiCategoryId
Especifica el id. de la categoría en la que insertar el botón.[in] button
especifica el botón para insertar.[in] iInsertBefore
Especifica el índice cero- basado de un botón de la barra de herramientas antes de que se inserte el botón.[in] lpszCategory
Especifica la cadena de categoría para insertar el botón.
Comentarios
El método de AddButton omite los botones que tienen los id. de comando estándar (como ID_FILE_MRU_FILE1), los comandos que no se permiten (vea CMFCToolBar::IsCommandPermitted) y botones ficticios.
Este método crea un nuevo objeto del mismo tipo que button (normalmente CMFCToolBarButton Class) mediante la clase del runtime del botón. Llama CMFCToolBarButton::CopyFrom para copiar los miembros de datos del botón, y la copia en la categoría especificada.
Cuando se inserta el nuevo botón, recibe la notificación de OnAddToCustomizePage .
Si iInsertBefore es -1, el botón se anexa a la lista de categorías; si no se inserta antes del elemento con el índice especificado.
Ejemplo
El ejemplo siguiente muestra cómo utilizar el método de AddButton de la clase de CMFCToolBarsCustomizeDialog . Este fragmento de código es parte de Ejemplo de slider.
CMFCToolBarsCustomizeDialog* pDlgCust = new CMFCToolBarsCustomizeDialog (this,
TRUE /* Automatic menus scaning */);
CSliderButton btnSlider (ID_SLIDER);
btnSlider.SetRange (0, 100);
pDlgCust->AddButton (_T("Edit"), btnSlider);
Requisitos
encabezado: afxToolBarsCustomizeDialog.h