CTooltipManager (clase)

Mantiene información de tiempo de ejecución sobre información sobre herramientas. La clase CTooltipManager se crea una vez por cada aplicación.

Sintaxis

class CTooltipManager : public CObject

Miembros

Métodos públicos

Nombre	Descripción
CTooltipManager::CreateToolTip	Crea un control de información sobre herramientas para el tipo de control de Windows especificado.
CTooltipManager::D eleteToolTip	Elimina el control de información sobre herramientas.
CTooltipManager::SetTooltipParams	Personaliza la apariencia visual del control de información sobre herramientas para el tipo de control de Windows especificado.
CTooltipManager::SetTooltipText	Establece el texto y la descripción para un control de información sobre herramientas.
CTooltipManager::UpdateTooltips

Comentarios

Use la clase CMFCToolTipCtrl, CMFCToolTipInfo y CTooltipManager conjuntamente para implementar información sobre herramientas personalizada en su aplicación. Para ver un ejemplo de cómo usar estas clases de información sobre herramientas, vea el tema Clase CMFCToolTipCtrl.

Jerarquía de herencia

CObject

CTooltipManager

Requisitos

Encabezado: afxtooltipmanager.h

CTooltipManager::CreateToolTip

Crea un control de información sobre herramientas.

static BOOL CreateToolTip(
    CToolTipCtrl*& pToolTip,
    CWnd* pWndParent,
    UINT nType);

Parámetros

pToolTip
[out] Referencia a un puntero de información sobre herramientas. Se establece para que apunte a la información sobre herramientas recién creada cuando se devuelve la función.

pWndParent
[in] Elemento primario de la información sobre herramientas.

nType
[in] Tipo de la información sobre herramientas.

Valor devuelto

Distinto de cero si se ha creado correctamente una información sobre herramientas.

Comentarios

Debe llamar a CTooltipManager::DeleteToolTip para eliminar el control de información sobre herramientas que se devuelve en pToolTip.

CTooltipManager establece los parámetros de presentación visual de cada información sobre herramientas que crea en función del tipo de información sobre herramientas que nType especifica. Para cambiar los parámetros de uno o varios tipos de información sobre herramientas, llame a CTooltipManager::SetTooltipParams.

Los tipos válidos de información sobre herramientas se muestran en la tabla siguiente:

Tipo de información sobre herramientas	Categoría de control	Tipos de ejemplo
AFX_TOOLTIP_TYPE_BUTTON	Botón.	CMFCButton
AFX_TOOLTIP_TYPE_CAPTIONBAR	Barra de título.	CMFCCaptionBar
AFX_TOOLTIP_TYPE_DEFAULT	Cualquier control que no se ajuste a otra categoría.	Ninguno.
AFX_TOOLTIP_TYPE_DOCKBAR	Panel acoplable.	CDockablePane
AFX_TOOLTIP_TYPE_EDIT	Cuadro de texto.	Ninguno.
AFX_TOOLTIP_TYPE_MINIFRAME	Minimarco.	CPaneFrameWnd
AFX_TOOLTIP_TYPE_PLANNER	Planificador.	Ninguno.
AFX_TOOLTIP_TYPE_RIBBON	Barra de cinta de opciones.	CMFCRibbonBar, CMFCRibbonPanelMenuBar
AFX_TOOLTIP_TYPE_TAB	Control de ficha.	CMFCTabCtrl
AFX_TOOLTIP_TYPE_TOOLBAR	Barra de herramientas.	CMFCToolBar, CMFCPopupMenuBar
AFX_TOOLTIP_TYPE_TOOLBOX	Cuadro de herramientas.	Ninguno.

CTooltipManager::D eleteToolTip

Elimina el control de información sobre herramientas.

static void DeleteToolTip(CToolTipCtrl*& pToolTip);

Parámetros

pToolTip
[in, out] Referencia a un puntero a una información sobre herramientas que se va a destruir.

Comentarios

Llame a este método para cada clase CToolTipCtrl creada por CTooltipManager::CreateToolTip. El control primario debe llamar a este método desde su controlador OnDestroy. Esto es necesario para quitar correctamente la información sobre herramientas del marco. Este método establece pToolTip en NULL antes de que se devuelva.

CTooltipManager::SetTooltipParams

Personaliza la apariencia del control de información sobre herramientas para los tipos de control de Windows especificados.

void SetTooltipParams(
    UINT nTypes,
    CRuntimeClass* pRTC=RUNTIME_CLASS(CMFCToolTipCtrl),
    CMFCToolTipInfo* pParams=NULL);

Parámetros

nTypes
[in] Especifica los tipos de control.

pRTC
[in] Clase en tiempo de ejecución de la información sobre herramientas personalizada.

pParams
[in] Parámetros de información sobre herramientas.

Comentarios

Este método establece la clase en tiempo de ejecución y los parámetros iniciales que CToolTipManager usa cuando crea información sobre herramientas. Cuando un control llama a CTooltipManager::CreateToolTip y pasa un tipo de información sobre herramientas que es uno de los tipos indicados por nTypes, el administrador de información sobre herramientas crea un control de información sobre herramientas que es una instancia de la clase en tiempo de ejecución especificada por pRTC y pasa los parámetros especificados por pParams a la nueva información sobre herramientas.

Cuando se llama a este método, todos los propietarios de información sobre herramientas existentes reciben el mensaje de AFX_WM_UPDATETOOLTIPS y deben volver a crear sus informaciones sobre herramientas mediante CTooltipManager::CreateToolTip.

nTypes puede ser cualquier combinación de los tipos de información sobre herramientas válidos que CTooltipManager::CreateToolTip usa, o puede ser AFX_TOOLTIP_TYPE_ALL. Si pasa AFX_TOOLTIP_TYPE_ALL, todos los tipos de información sobre herramientas se ven afectados.

Ejemplo

En el siguiente ejemplo se muestra cómo se utiliza el método SetTooltipParams de la clase CTooltipManager. Este fragmento de código forma parte del Ejemplo de cliente de dibujo.

CMFCToolTipInfo params;
params.m_bVislManagerTheme = TRUE;

theApp.GetTooltipManager()->SetTooltipParams(AFX_TOOLTIP_TYPE_ALL, RUNTIME_CLASS(CMFCToolTipCtrl), &params);

CTooltipManager::SetTooltipText

Establece el texto y la descripción para una información sobre herramientas.

static void SetTooltipText(
    TOOLINFO* pTI,
    CToolTipCtrl* pToolTip,
    UINT nType,
    const CString strText,
    LPCTSTR lpszDescr=NULL);

Parámetros

pTI
[in] Puntero a un objeto TOOLINFO.

pToolTip
[in, out] Puntero al control de información sobre herramientas para el que se va a establecer el texto y la descripción.

nType
[in] Especifica el tipo de control con el que está asociada esta información sobre herramientas.

strText
[in] Texto que se va a establecer como texto de la información sobre herramientas.

lpszDescr
[in] Puntero a la descripción de la información sobre herramientas. Puede ser NULL.

Comentarios

El valor de nType debe ser el mismo valor que el parámetro nType de CTooltipManager::CreateToolTip al crear la información sobre herramientas.

CTooltipManager::UpdateTooltips

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.

void UpdateTooltips();

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CMFCToolTipCtrl (clase)
CMFCToolTipInfo (clase)