Compartir a través de

CMFCToolBarDateTimeCtrl (clase)

Un botón de la barra de herramientas que contiene un control selector de fecha y hora.

Sintaxis

class CMFCToolBarDateTimeCtrl : public CMFCToolBarButton

Miembros

Constructores públicos

Nombre Descripción
CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl Construye un objeto CMFCToolBarDateTimeCtrl.
CMFCToolBarDateTimeCtrl::~CMFCToolBarDateTimeCtrl Destructor.

Métodos públicos

Nombre Descripción
CMFCToolBarDateTimeCtrl::CanBeStretched Especifica si un usuario puede ajustar el botón durante la personalización. Invalida CMFCToolBarButton::CanBeStretched.
CMFCToolBarDateTimeCtrl::CopyFrom Copia las propiedades de otro botón de la barra de herramientas en el botón actual. (Invalida CMFCToolBarButton::CopyFrom).
CMFCToolBarDateTimeCtrl::DuplicateData Reservado para uso futuro.
CMFCToolBarButton::ExportToMenuButton Copia el texto del botón de la barra de herramientas en un menú.
CMFCToolBarDateTimeCtrl::CreateObject Usado por el marco de trabajo para crear una instancia dinámica de este tipo de clase.
CMFCToolBarDateTimeCtrl::GetByCmd Recupera el primer objeto CMFCToolBarDateTimeCtrl en la aplicación que tiene el id. de comando especificado.
CMFCToolBarDateTimeCtrl::GetDateTimeCtrl Devuelve un puntero al control selector de fecha y hora.
CMFCToolBarDateTimeCtrl::GetHwnd Recupera el manipulador de ventana asociado al botón de la barra de herramientas. Invalida CMFCToolBarButton::GetHwnd.
CMFCToolBarDateTimeCtrl::GetThisClass Lo usa el marco para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMFCToolBarDateTimeCtrl::GetTime Obtiene la hora seleccionada de un control selector de fecha y hora y la coloca en una estructura SYSTEMTIME especificada.
CMFCToolBarDateTimeCtrl::GetTimeAll Devuelve la hora seleccionada desde el botón de control selector de hora que tiene un id. de comando especificado.
CMFCToolBarDateTimeCtrl::HaveHotBorder Determina si se muestra un borde del botón cuando un usuario selecciona el botón. Invalida CMFCToolBarButton::HaveHotBorder.
CMFCToolBarDateTimeCtrl::NotifyCommand Especifica si el botón procesa el mensaje WM_COMMAND. (Invalida CMFCToolBarButton::NotifyCommand).
CMFCToolBarDateTimeCtrl::OnAddToCustomizePage Lo llama el marco cuando se agrega el botón a un cuadro de diálogo Personalizar. (Invalida CMFCToolBarButton::OnAddToCustomizePage).
CMFCToolBarDateTimeCtrl::OnCalculateSize Lo llama el marco para calcular el tamaño del botón para el contexto de dispositivo y el estado de acoplamiento especificados. (Invalida CMFCToolBarButton::OnCalculateSize.)
CMFCToolBarDateTimeCtrl::OnChangeParentWnd Lo llama el marco cuando el botón se inserta en una barra de herramientas nueva. (Invalida CMFCToolBarButton::OnChangeParentWnd).
CMFCToolBarDateTimeCtrl::OnClick Llamado por el marco de trabajo cuando el usuario hace clic en el control. Invalida CMFCToolBarButton::OnClick.
CMFCToolBarDateTimeCtrl::OnCtlColor Lo llama el marco cuando la barra de herramientas primaria maneja un mensaje de WM_CTLCOLOR. (Invalida CMFCToolBarButton::OnCtlColor).
CMFCToolBarDateTimeCtrl::OnDraw Lo llama el marco para dibujar el botón mediante las opciones y los estilos especificados. (Invalida CMFCToolBarButton::OnDraw.)
CMFCToolBarDateTimeCtrl::OnDrawOnCustomizeList Lo llama el marco para dibujar el botón en el panel Comandos del cuadro de diálogo Personalizar. Invalida CMFCToolBarButton::OnDrawOnCustomizeList.
CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged Lo llama el el marco cuando cambia la fuente general. Invalida CMFCToolBarButton::OnGlobalFontsChanged.
CMFCToolBarDateTimeCtrl::OnMove Lo llama el marco cuando se mueve la barra de herramientas primaria. (Invalida CMFCToolBarButton::OnMove).
CMFCToolBarDateTimeCtrl::OnShow Lo llama el marco cuando el botón se vuelve visible o invisible. (Invalida CMFCToolBarButton::OnShow).
CMFCToolBarDateTimeCtrl::OnSize Lo llama el marco cuando la barra de herramientas primaria cambia de tamaño o posición y este cambio hace que el botón cambie de tamaño. Invalida CMFCToolBarButton::OnSize.
CMFCToolBarDateTimeCtrl::OnUpdateToolTip Lo llama el marco cuando la barra de herramientas primaria actualiza su texto de información sobre herramientas. Invalida CMFCToolBarButton::OnUpdateToolTip.
CMFCToolBarDateTimeCtrl::Serialize Lee este objeto desde un archivo o lo escribe en un archivo. Invalida CMFCToolBarButton::Serialize.
CMFCToolBarDateTimeCtrl::SetStyle Establece el estilo del botón de barra de herramientas. (Invalida CMFCToolBarButton::SetStyle).
CMFCToolBarDateTimeCtrl::SetTime Establece la hora y la fecha en el control selector de hora.
CMFCToolBarDateTimeCtrl::SetTimeAll Establece la hora y la fecha en todas las instancias del control selector de hora que tienen un id. de comando especificado.

Comentarios

Para obtener un ejemplo de cómo usar un control selector de fecha y hora, consulte el proyecto de ejemplo ToolbarDateTimePicker. Para obtener información sobre cómo agregar botones de control a las barras de herramientas, consulte Tutorial: colocar controles en barras de herramientas.

Jerarquía de herencia

CObject

CMFCToolBarButton

CMFCToolBarDateTimeCtrl

Requisitos

Encabezado: afxtoolbardatetimectrl.h

CMFCToolBarDateTimeCtrl::CanBeStretched

Especifica si un usuario puede ajustar el botón durante la personalización.

virtual BOOL CanBeStretched() const;

Valor devuelto

Este método devuelve TRUE.

Comentarios

De forma predeterminada, el marco no permite al usuario ajustar un botón de la barra de herramientas durante la personalización. Este método extiende la implementación de la clase base (CMFCToolBarButton::CanBeStretched) al permitir al usuario ajustar un botón de la barra de herramientas de fecha y hora durante la personalización.

CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl

Crea e inicializa un objeto CMFCToolBarDateTimeCtrl.

CMFCToolBarDateTimeCtrl(
    UINT uiID,
    int iImage,
    DWORD dwStyle=0,
    int iWidth=0);

Parámetros

uiID
[in] La id. del control.

iImage
[in] El índice de la imagen en el objeto CMFCToolBarImages de la barra de herramientas.

dwStyle
[in] El estilo de la ventana CMFCToolBarDateTimeCtrlImpl que se crea cuando un usuario hace clic en el botón.

iWidth
[in] El ancho del control en píxeles.

Comentarios

Este objeto se inicializa en la fecha y hora del sistema. El estilo de ventana del objeto CMFCToolBarDateTimeCtrlImpl interno incluye el parámetro dwStyle y los estilos WS_CHILD y WS_VISIBLE. No se pueden cambiar estos estilos mediante CMFCToolBarDateTimeCtrl::SetStyle. Use SetStyle para cambiar el estilo del control CMFCToolBarDateTimeCtrl.

Ejemplo

En el ejemplo siguiente se muestra cómo construir un objeto de la clase CMFCToolBarDateTimeCtrl. Este fragmento de código forma parte del ejemplo de selector de fecha y hora de la barra de herramientas.

CMFCToolBarDateTimeCtrl dateButton(ID_DATE,
                                   GetCmdMgr()->GetCmdImage(ID_DATE, FALSE));

CMFCToolBarDateTimeCtrl::CopyFrom

Copia las propiedades de otro botón de la barra de herramientas en el botón actual.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parámetros

src
[in] Referencia al botón de origen desde el que se va a copiar.

Comentarios

Llame a este método para copiar otro botón de la barra de herramientas en este botón de la barra de herramientas. src debe ser del tipo CMFCToolBarDateTimeCtrl.

CMFCToolBarDateTimeCtrl::ExportToMenuButton

Copia el texto del botón de la barra de herramientas en un menú.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parámetros

menuButton
[in] Referencia al botón de menú de destino.

Valor devuelto

Este método devuelve TRUE.

Comentarios

Este método invalida la implementación de clase base (CMFCToolBarButton::ExportToMenuButton) cargando el recurso de cadena asociado al id. de comando del control. Para obtener más información sobre los recursos de cadena, consulte CStringT::LoadString.

CMFCToolBarDateTimeCtrl::GetByCmd

Recupera el primer objeto CMFCToolBarDateTimeCtrl en la aplicación que tiene el id. de comando especificado.

static CMFCToolBarDateTimeCtrl* __stdcall GetByCmd(UINT uiCmd);

Parámetros

uiCmd
[in] El id. de comando del botón que se va a recuperar.

Valor devuelto

El primer objeto CMFCToolBarDateTimeCtrl en la aplicación que tiene el id. de comando especificado, o NULL si ningún objeto CMFCToolBarDateTimeCtrl tiene el id. de comando especificado.

Comentarios

Métodos como CMFCToolBarDateTimeCtrl::SetTimeAll y CMFCToolBarDateTimeCtrl::GetTimeAll usan este método de utilidad compartida para establecer u obtener la hora y fecha de todas las instancias del control selector de hora que tienen un id. de comando especificado.

CMFCToolBarDateTimeCtrl::GetDateTimeCtrl

Devuelve un puntero al control selector de fecha y hora.

CDateTimeCtrl* GetDateTimeCtrl() const;

Valor devuelto

Un puntero al control selector de fecha y hora; o NULL si el control no existe.

Comentarios

La clase CMFCToolBarDateTimeCtrl inicializa el miembro de datos m_pWndDateTime al insertar un objeto CMFCToolBarDateTimeCtrl en una barra de herramientas.

CMFCToolBarDateTimeCtrl::GetHwnd

Recupera el manipulador de ventana asociado al botón de la barra de herramientas.

virtual HWND GetHwnd();

Valor devuelto

El manipulador de ventana asociado al botón de la barra de herramientas de fecha y hora.

Comentarios

Este método invalida el método CMFCToolBarButton::GetHwnd.

CMFCToolBarDateTimeCtrl::GetTime

Obtiene la hora seleccionada del control selector de fecha y hora asociado y la coloca en una estructura SYSTEMTIME especificada

BOOL GetTime(COleDateTime& timeDest) const;
DWORD GetTime(CTime& timeDest) const;
DWORD GetTime(LPSYSTEMTIME pTimeDest) const;

Parámetros

timeDest
[out] En la primera sobrecarga, un objeto Clase COleDateTime que recibirá la información de hora del sistema. En la segunda sobrecarga, un objeto CTime que recibirá la información de hora del sistema.

pTimeDest
[out] Un puntero a la estructura SYSTEMTIME para recibir la información de hora del sistema. No debe ser NULL.

Valor devuelto

En la primera sobrecarga, es distinto de cero si la hora se escribe correctamente en el objeto Clase COleDateTime; de lo contrario, 0. En la segunda y tercera sobrecargas, el valor devuelto es un DWORD que es igual al miembro dwFlag que se estableció en la estructura NMDATETIMECHANGE.

Comentarios

El método establece la estructura NMDATETIMECHANGE de miembro dwFlags para indicar si el selector de fecha y hora está establecido en una fecha y hora. Si el valor es igual a GDT_NONE, el control se establece en estado no date y usa el estilo DTS_SHOWNONE. Si el valor devuelto es igual a GDT_VALID, la hora del sistema se almacena correctamente en la ubicación de destino.

CMFCToolBarDateTimeCtrl::GetTimeAll

Devuelve la hora seleccionada por el usuario desde el botón de control selector de hora que tiene un id. de comando especificado.

static BOOL GetTimeAll(
    UINT uiCmd,
    COleDateTime& timeDest);

static DWORD GetTimeAll(
    UINT uiCmd,
    CTime& timeDest);

static DWORD GetTimeAll(
    UINT uiCmd,
    LPSYSTEMTIME pTimeDest);

Parámetros

uiCmd
[in] Especifica el id. de comando de un botón de la barra de herramientas.

timeDest
[out] En la primera sobrecarga, un objeto Clase COleDateTime que recibirá la información de hora del sistema. En la segunda sobrecarga, un objeto CTime que recibirá la información de hora del sistema.

pTimeDest
[out] Un puntero a la estructura SYSTEMTIME para recibir la información de hora del sistema. No debe ser NULL.

Valor devuelto

Si el marco no encuentra un botón de barra de herramientas que coincida con el id. de comando uiCmd, el valor devuelto es cero en la primera sobrecarga y GDT_NONE en las otras sobrecargas. Si se encuentra el botón de la barra de herramientas, el valor devuelto es el mismo que el valor devuelto de una llamada a CMFCToolBarDateTimeCtrl::GetTime en ese botón. Un valor devuelto de cero o GDT_NONE puede producirse cuando se encuentra el botón, lo que indica que la llamada a GetTime no devolvió una fecha válida por algún otro motivo.

Comentarios

Este método busca un botón de barra de herramientas que tenga el id. de comando especificado y llama al método CMFCToolBarDateTimeCtrl::GetTime en ese botón.

CMFCToolBarDateTimeCtrl::HaveHotBorder

Determina si se muestra un borde del botón cuando un usuario selecciona el botón.

virtual BOOL HaveHotBorder() const;

Valor devuelto

Distinto de cero si un botón muestra su borde cuando está seleccionado; de lo contrario, 0.

Comentarios

Este método devuelve un valor distinto de cero si el control está visible.

CMFCToolBarDateTimeCtrl::NotifyCommand

Especifica si el botón procesa el mensaje WM_COMMAND.

virtual BOOL NotifyCommand(int iNotifyCode);

Parámetros

iNotifyCode
[in] El mensaje de notificación asociado al comando.

Valor devuelto

TRUE si el botón procesa el mensaje WM_COMMAND o FALSE para indicar que el mensaje debería manejarse desde la barra de herramientas primaria.

Comentarios

El marco llama a este método cuando está a punto de enviar un mensaje WM_COMMAND a la ventana primaria.

Este método extiende la implementación de la clase base (CMFCToolBarButton::NotifyCommand) procesando la notificación DTN_DATETIMECHANGE. Actualiza el estado de hora interno y actualiza la propiedad de tiempo de todos los objetos CMFCToolBarDateTimeCtrl con el mismo id. de comando.

CMFCToolBarDateTimeCtrl::OnAddToCustomizePage

Lo llama el marco cuando se agrega el botón a un cuadro de diálogo Personalizar.

virtual void OnAddToCustomizePage();

Comentarios

Este método extiende la implementación de la clase base, CMFCToolBarButton::OnAddToCustomizePage, copiando las propiedades del primer control de fecha y hora en cualquier barra de herramientas que tenga el mismo id. de comando que este objeto. Este método no hace nada si ninguna barra de herramientas tiene un control de fecha y hora que tenga el mismo id. de comando que este objeto.

Para obtener más información sobre el cuadro de diálogo Personalizar, consulte CMFCToolBarsCustomizeDialog Clase.

CMFCToolBarDateTimeCtrl::OnChangeParentWnd

Lo llama el marco cuando el botón se inserta en una barra de herramientas nueva.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parámetros

pWndParent
[in] Ventana primaria nueva.

Comentarios

Este método invalida la implementación de la clase base (CMFCToolBarButton::OnChangeParentWnd) volviendo a crear el objeto interno CMFCToolBarDateTimeCtrlImpl.

CMFCToolBarDateTimeCtrl::OnClick

Llamado por el marco de trabajo cuando el usuario hace clic en el control.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parámetros

pWnd
[in] Sin utilizar.

bDelay
[in] Sin utilizar.

Valor devuelto

Distinto de cero si el botón procesa el mensaje de clic; de lo contrario, 0.

Comentarios

Este método invalida la implementación de la clase base (CMFCToolBarButton::OnClick) devolviendo un valor distinto de cero si el objeto CMFCToolBarDateTimeCtrlImpl interno está visible.

CMFCToolBarDateTimeCtrl::OnCtlColor

Lo llama el marco cuando la barra de herramientas primaria maneja un mensaje de WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parámetros

pDC
[in] Contexto de dispositivo que muestra el botón.

nCtlColor
[in] Sin utilizar.

Valor devuelto

Un manipulador del pincel global que el marco usa para pintar el fondo del botón.

Comentarios

Este método invalida la implementación de la clase base, CMFCToolBarButton::OnCtlColor, estableciendo los colores del texto y del fondo del contexto del dispositivo proporcionado en los colores generales del texto y del fondo, respectivamente.

Para obtener más información sobre las opciones generales que están disponibles para la aplicación, consulte la estructura AFX_GLOBAL_DATA.

CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged

Lo llama el el marco cuando cambia la fuente general.

virtual void OnGlobalFontsChanged();

Comentarios

Este método extiende la implementación de la clase base (CMFCToolBarButton::OnGlobalFontsChanged) cambiando la fuente del control a la de la fuente general.

Para obtener más información sobre las opciones generales que están disponibles para la aplicación, consulte la estructura AFX_GLOBAL_DATA.

CMFCToolBarDateTimeCtrl::OnMove

Lo llama el marco cuando se mueve la barra de herramientas primaria.

virtual void OnMove();

Comentarios

Este método invalida la implementación de clase predeterminada (CMFCToolBarButton::OnMove) actualizando la posición del objeto CMFCToolBarDateTimeCtrlImpl interno.

CMFCToolBarDateTimeCtrl::OnShow

Lo llama el marco cuando el botón se vuelve visible o invisible.

virtual void OnShow(BOOL bShow);

Parámetros

bShow
[in] Especifica si el botón está visible. Si este parámetro es TRUE, el botón está visible. De lo contrario, no lo está.

Comentarios

Este método extiende la implementación de la clase base (CMFCToolBarButton::OnShow) mostrando el botón si bShow es TRUE. De lo contrario, este método oculta el botón.

CMFCToolBarDateTimeCtrl::OnSize

Lo llama el marco cuando la barra de herramientas primaria cambia de tamaño o posición y este cambio hace que el botón cambie de tamaño.

virtual void OnSize(int iSize);

Parámetros

iSize
[in] El nuevo ancho de la columna, en píxeles.

Comentarios

Este método invalida la implementación de clase predeterminada (CMFCToolBarButton::OnMove) actualizando la posición del objeto CMFCToolBarDateTimeCtrlImpl interno.

CMFCToolBarDateTimeCtrl::OnUpdateToolTip

Lo llama el marco cuando la barra de herramientas primaria actualiza su texto de información sobre herramientas.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parámetros

pWndParent
[in] La ventana primaria.

iButtonIndex
[in] Índice de base cero del botón en la colección de botones primaria.

wndToolTip
[in] El control que muestra el texto de información sobre herramientas.

str
[out] Objeto CString que recibe el texto de información sobre herramientas actualizado.

Valor devuelto

Distinto de cero si el método actualiza el texto de la información sobre herramientas; de lo contrario, 0.

Comentarios

Este método extiende la implementación de la clase base (CMFCToolBarButton::OnUpdateToolTip) mostrando el texto de información sobre herramientas asociado al botón. Si el botón no está acoplado horizontalmente, este método no hace nada y devuelve FALSE.

CMFCToolBarDateTimeCtrl::SetTime

Establece la hora y la fecha en el control selector de hora.

BOOL SetTime(const COleDateTime& timeNew);
BOOL SetTime(const CTime* timeNew);
BOOL SetTime(LPSYSTEMTIME pTimeNew=NULL);

Parámetros

timeNew
[in] En la primera versión, una referencia a un objeto Clase COleDateTime que contiene la hora a la que se establecerá el control. En la segunda versión, un puntero a un objeto CTime que contiene la hora a la que se establecerá el control.

pTimeNew
[in] Un puntero a la estructura SYSTEMTIME que contiene la hora a la que se establecerá el control.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

Establece la hora en un control selector de fecha y hora llamando a CDateTimeCtrl::SetTime.

CMFCToolBarDateTimeCtrl::SetTimeAll

Establece la hora y la fecha en todas las instancias del control selector de hora que tienen un id. de comando especificado.

static BOOL SetTimeAll(
    UINT uiCmd,
    const COleDateTime& timeNew);

static BOOL SetTimeAll(
    UINT uiCmd,
    const CTime* pTimeNew);

static BOOL SetTimeAll(
    UINT uiCmd,
    LPSYSTEMTIME pTimeNew=NULL);

Parámetros

uiCmd
[in] Especifica el id. de comando de un botón de la barra de herramientas.

timeNew
[in] En la primera versión, un objeto Clase COleDateTime que contiene la hora en la que se establecerá el control. En la segunda versión, un puntero a un objeto CTime que contiene la hora a la que se establecerá el control.

pTimeNew
[in] Un puntero a la estructura SYSTEMTIME que contiene la hora a la que se establecerá el control.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

Busca un botón de la barra de herramientas con el id. de comando especificado y establece la hora en un control selector de fecha y hora llamando a CMFCToolBarDateTimeCtrl::SetTime.

Consulte también

Gráfico de jerarquías
Clases
CMFCToolBarButton (clase)
Tutorial: Poner controles en las barras de herramientas