Compartir a través de


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 Clase de CMFCToolBarButton) 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

Vea también

Referencia

Clase de CMFCToolBarsCustomizeDialog

Gráfico de jerarquía