Compartir a través de

Clase CMFCOutlookBarPane

  • Artículo

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Un control derivado de la clase CMFCToolBar Class que se puede insertar en una barra de Outlook (clase CMFCOutlookBar). El panel de barra de Outlook contiene una columna de botones grandes. El usuario puede subir y bajar la lista de botones si es mayor que el panel. Cuando el usuario desasocia un panel de barra de Outlook de la barra de Outlook, puede flotar o acoplarse en la ventana de marco principal.

Sintaxis

class CMFCOutlookBarPane : public CMFCToolBar

Miembros

Constructores públicos

Nombre Descripción
CMFCOutlookBarPane::CMFCOutlookBarPane Constructor predeterminado.
CMFCOutlookBarPane::~CMFCOutlookBarPane Destructor.

Métodos públicos

Nombre Descripción
CMFCOutlookBarPane::AddButton Agrega un botón al panel de la barra de Outlook.
CMFCOutlookBarPane::CanBeAttached Determina si se puede acoplar el panel actual a otro panel o ventana de marco. (Invalida CBasePane::CanBeAttached.)
CMFCOutlookBarPane::CanBeRestored Determina si el sistema puede restaurar una barra de herramientas a su estado original después de la personalización. (Invalida CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll Libera los recursos usados por las imágenes en el panel de la barra de Outlook.
CMFCOutlookBarPane::Create Crea el panel de la barra de Outlook.
CMFCOutlookBarPane::CreateObject Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CMFCOutlookBarPane::Dock Lo llama el marco para acoplar el panel de la barra de Outlook. (Invalida CPane::Dock).
CMFCOutlookBarPane::EnablePageScrollMode Especifica si las flechas de desplazamiento del panel de la barra de Outlook avanzan en la lista de botones por página o por botón.
CMFCOutlookBarPane::GetRegularColor Devuelve el color de texto normal (no seleccionado) del panel de la barra de Outlook.
CMFCOutlookBarPane::GetThisClass Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMFCOutlookBarPane::IsBackgroundTexture Determina si hay una imagen de fondo cargada para el panel de la barra de Outlook.
CMFCOutlookBarPane::IsChangeState Determina si se puede acoplar un panel flotante. (Invalida CPane::IsChangeState).
CMFCOutlookBarPane::IsDrawShadedHighlight Determina si el borde del botón está sombreado cuando se resalta un botón y se muestra una imagen de fondo.
CMFCOutlookBarPane::OnBeforeFloat Llamado por el marco cuando un panel está a punto de flotar. (Invalida CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton Quita el botón que tiene un id. de comando especificado.
CMFCOutlookBarPane::RestoreOriginalstate Restaura el estado original de una barra de herramientas. (Invalida CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor Establece el color de fondo.
CMFCOutlookBarPane::SetBackImage Establece la imagen de fondo.
CMFCOutlookBarPane::SetDefaultState Restablece el panel de la barra de Outlook al conjunto original de botones.
CMFCOutlookBarPane::SetExtraSpace Establece el número de píxeles de relleno que se usan alrededor de los botones en el panel de la barra de Outlook.
CMFCOutlookBarPane::SetTextColor Establece los colores del texto normal y resaltado en el panel de la barra de Outlook.
CMFCOutlookBarPane::SetTransparentColor Establece el color transparente del panel de la barra de Outlook.
CMFCOutlookBarPane::SmartUpdate Se usa internamente para actualizar la barra de Outlook. (Invalida CMFCToolBar::SmartUpdate).

Métodos protegidos

Nombre Descripción
CMFCOutlookBarPane::EnableContextMenuItems Especifica qué elementos del menú contextual se muestran en el modo de personalización.
CMFCOutlookBarPane::RemoveAllButtons Quita todos los botones del panel de la barra de Outlook. (Invalida CMFCToolBar::RemoveAllButtons.)

Comentarios

Para obtener información sobre cómo implementar una barra de Outlook, consulte Clase CMFCOutlookBar.

Para obtener un ejemplo de una barra de Outlook, consulte el proyecto de muestra OutlookDemo.

Ejemplo

En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCOutlookBarPane. En el ejemplo se muestra cómo crear un panel de la barra de Outlook, habilitar el modo de desplazamiento de página, habilitar acoplamiento y establecer el color de fondo de la barra de Outlook. Este fragmento de código forma parte del ejemplo de varias vistas de Outlook.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCOutlookBarPane

Requisitos

Encabezado: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Agrega un botón al panel de la barra de Outlook.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parámetros

uiImage
[in] Especifica el identificador de recurso de un mapa de bits.

lpszLabel
[in] Especifica el texto del botón.

iIdCommand
[in] Especifica el id. del control de botón.

iInsertAt
[in] Especifica el índice de base cero en la página de la barra de outlook en la que se va a insertar el botón.

uiLabel
[in] Un id. de recurso de cadena.

szBmpFileName
[in] Especifica el nombre del archivo de imagen de disco que se va a cargar.

szLabel
[in] Especifica el texto del botón.

hBmp
[in] Un manipulador del mapa de bits de un botón.

hIcon
[in] Un manipulador de un icono de botón.

Valor devuelto

Es TRUE si se agregó correctamente un botón; de lo contrario, es FALSE.

Comentarios

Use este método para insertar un nuevo botón en la página de una barra de Outlook. La imagen del botón se puede cargar desde los recursos de la aplicación o desde un archivo de disco.

Si el id. de página especificado por uiPageID es -1, el botón se inserta en la primera página.

Si el índice especificado por iInsertAt es -1, el botón se agrega al final de la página.

CMFCOutlookBarPane::CanBeAttached

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

virtual BOOL CanBeAttached() const;

Valor devuelto

Comentarios

CMFCOutlookBarPane::ClearAll

Libera los recursos usados por las imágenes en el panel de la barra de Outlook.

void ClearAll();

Comentarios

Este método llama directamente a CMFCToolBarImages::Clear, al que se llama en las imágenes que usa el panel de la barra de Outlook.

CMFCOutlookBarPane::Create

Crea el panel de la barra de Outlook.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parámetros

pParentWnd
[in] Especifica la ventana primaria del control del panel de la barra de Outlook. No debe ser NULL.

dwStyle
[in] El estilo de la ventana. Para obtener una lista de estilos de ventana, consulte Estilos de ventana.

uiID
[in] La id. del control. Debe ser único para habilitar el guardado del estado del control.

dwControlBarStyle
[in] Especifica estilos especiales que definen el comportamiento del control del panel de la barra de Outlook cuando se desasocia de la barra de Outlook.

Valor devuelto

TRUE si el método se aplicó correctamente; de lo contrario, FALSE.

Comentarios

Para construir un objeto CMFCOutlookBarPane, llame primero al constructor y, a continuación, llame a Create, que crea el control del panel de la barra de Outlook y lo adjunta al objeto CMFCOutlookBarPane.

Para obtener más información sobre dwControlBarStyle, consulte CBasePane::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Especifica qué elementos del menú contextual se muestran en el modo de personalización.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parámetros

pButton
[in] Un puntero a un botón de la barra de herramientas en el que un usuario ha hecho clic.

pPopup
[in] Un puntero al menú contextual.

Valor devuelto

Devuelve TRUE si se debe mostrar el menú contextual; en caso contrario, FALSE.

Comentarios

Invalide este método para modificar el menú contextual estándar del marco que el marco muestra en modo de personalización.

La implementación predeterminada comprueba el modo de personalización (CMFCToolBar::IsCustomizeMode) y, si está establecido en TRUE, deshabilita todos los elementos del menú contextual excepto Eliminar. A continuación, simplemente pasa los parámetros de entrada a CMFCToolBar::EnableContextMenuItems.

Nota:

Menú de contexto es un sinónimo de menú contextual.

CMFCOutlookBarPane::EnablePageScrollMode

Especifica si las flechas de desplazamiento del panel de la barra de Outlook avanzan en la lista de botones por página o botón por botón.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parámetros

bPageScroll
[in] Si es TRUE, habilite el modo de desplazamiento de página. Si es FALSE, deshabilite el modo de desplazamiento de página.

CMFCOutlookBarPane::GetRegularColor

Devuelve el color de texto normal (es decir, no seleccionado) del panel de la barra de Outlook.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Valor devuelto

El color del texto actual como un valor de color RGB.

Comentarios

Use CMFCOutlookBarPane::SetTextColor para establecer el color de texto actual (normal y seleccionado) de la barra de Outlook. Puede obtener el color de texto predeterminado llamando a la función GetSysColor con el índice COLOR_WINDOW.

CMFCOutlookBarPane::IsBackgroundTexture

Determina si hay una imagen de fondo cargada para el panel de la barra de Outlook.

BOOL IsBackgroundTexture() const;

Valor devuelto

TRUE si hay una imagen de fondo que se va a mostrar; en caso contrario, FALSE.

Comentarios

Puede agregar una imagen de fondo llamando a la función CMFCOutlookBarPane::SetBackImage.

Si no hay ninguna imagen de fondo, el fondo se pinta con un color especificado mediante CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Determina si el borde del botón está sombreado cuando se resalta un botón y se muestra una imagen de fondo.

BOOL IsDrawShadedHighlight() const;

Valor devuelto

TRUE si los bordes del botón están sombreados; en caso contrario, FALSE.

CMFCOutlookBarPane::RemoveAllButtons

Quita todos los botones del panel de la barra de Outlook.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Quita el botón que tiene un id. de comando especificado.

BOOL RemoveButton(UINT iIdCommand);

Parámetros

iIdCommand
[in] Especifica el id. de comando de un botón que se va a quitar.

Valor devuelto

TRUE si el botón se quitó correctamente; FALSE si el id. de comando especificado no es válido.

CMFCOutlookBarPane::SetBackColor

Establece el color de fondo de la barra de Outlook.

void SetBackColor(COLORREF color);

Parámetros

color
[in] Especifica el nuevo color de fondo.

Comentarios

Llame a esta función para establecer el color de fondo actual de la barra de Outlook. El color de fondo solo se usa si no hay ninguna imagen de fondo.

CMFCOutlookBarPane::SetBackImage

Establece la imagen de fondo.

void SetBackImage(UINT uiImageID);

Parámetros

uiImageID
[in] Especifica el id. de recurso de imagen.

Comentarios

Llame a este método para establecer la imagen de fondo de la barra de Outlook. La lista de imágenes de fondo se administra mediante el objeto CMFCToolBarImages Class insertado.

CMFCOutlookBarPane::SetDefaultState

Restablece el panel de la barra de Outlook al conjunto original de botones.

void SetDefaultState();

Comentarios

Este método restaura los botones de la barra de Outlook al conjunto original. Este método es similar CMFCOutlookBarPane::RestoreOriginalstate, salvo que no desencadena un nuevo dibujo del panel de la barra de Outlook.

CMFCOutlookBarPane::SetExtraSpace

Establece el número de píxeles de relleno que se usan alrededor de los botones en el panel de la barra de Outlook.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Establece los colores del texto normal y resaltado en el panel de la barra de Outlook.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parámetros

clrRegText
[in] Especifica el nuevo color para el texto no seleccionado.

clrSelText
[in] Especifica el nuevo color para el texto seleccionado.

CMFCOutlookBarPane::SetTransparentColor

Establece el color transparente del panel de la barra de Outlook.

void SetTransparentColor(COLORREF color);

Parámetros

color
[in] Especifica el nuevo color transparente.

Comentarios

El color transparente es necesario para mostrar imágenes transparentes. Cualquier aparición de este color en una imagen se pinta con el color de fondo en su lugar. No hay ninguna combinación de imágenes en primer plano y de fondo.

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBar (clase)
CMFCOutlookBar (clase)
CMFCOutlookBarTabCtrl (clase)