Compartir a través de

Clase CTabCtrl

  • Artículo

Proporciona la funcionalidad del control de pestaña común de Windows.

Sintaxis

class CTabCtrl : public CWnd

Miembros

Constructores públicos

Nombre Descripción
CTabCtrl::CTabCtrl Construye un objeto CTabCtrl.

Métodos públicos

Nombre Descripción
CTabCtrl::AdjustRect Calcula el área de visualización de un control de pestañas según un rectángulo de ventana o calcula el rectángulo de ventana que correspondería a un área de visualización determinada.
CTabCtrl::Create Crea un control de pestañas y lo adjunta a una instancia de un objeto TabCtrl.
CTabCtrl::CreateEx Crea un control de pestañas con los estilos extendidos de Windows especificados y lo adjunta a un objeto CTabCtrl.
CTabCtrl::DeleteAllItems Quita todos los elementos de un control de pestañas.
CTabCtrl::DeleteItem Quita un elemento de un control de pestañas.
CTabCtrl::DeselectAll Restablece los elementos de un control de pestañas, borrando los que se pulsaron.
CTabCtrl::DrawItem Dibuja un elemento especificado de un control de pestañas.
CTabCtrl::GetCurFocus Recupera la pestaña con el foco actual de un control de pestañas.
CTabCtrl::GetCurSel Determina la pestaña seleccionada actualmente en un control de pestañas.
CTabCtrl::GetExtendedStyle Recupera los estilos extendidos que están actualmente en uso para el control de pestañas.
CTabCtrl::GetImageList Recupera la lista de imágenes asociada a un control de pestañas.
CTabCtrl::GetItem Recupera información sobre una pestaña de un control de pestañas.
CTabCtrl::GetItemCount Recupera el número de pestañas del control de pestañas.
CTabCtrl::GetItemRect Recupera el rectángulo delimitador de una pestaña de un control de pestañas.
CTabCtrl::GetItemState Recupera el estado del elemento de control de pestañas indicado.
CTabCtrl::GetRowCount Recupera el número actual de filas de pestañas de un control de pestañas.
CTabCtrl::GetToolTips Recupera el manipulador del control de información sobre herramientas asociado a un control de pestañas.
CTabCtrl::HighlightItem Establece el estado de resaltado de un elemento de pestaña.
CTabCtrl::HitTest Determina qué pestaña, si la hay, está en una posición de pantalla especificada.
CTabCtrl::InsertItem Inserta una nueva pestaña en un control de pestañas.
CTabCtrl::RemoveImage Quita una imagen de la lista de imágenes de un control de pestañas.
CTabCtrl::SetCurFocus Establece el foco en una pestaña especificada de un control de pestañas.
CTabCtrl::SetCurSel Selecciona una pestaña de un control de pestañas.
CTabCtrl::SetExtendedStyle Establece los estilos extendidos de un control de pestañas.
CTabCtrl::SetImageList Asigna una lista de imágenes a un control de pestañas.
CTabCtrl::SetItem Establece algunos o todos los atributos de una pestaña.
CTabCtrl::SetItemExtra Establece el número de bytes por pestaña reservados para los datos definidos por la aplicación en un control de pestañas.
CTabCtrl::SetItemSize Establece el ancho y el alto de un elemento.
CTabCtrl::SetItemState Recupera el estado del elemento de control de pestañas indicado.
CTabCtrl::SetMinTabWidth Establece el ancho mínimo de los elementos de un control de pestañas.
CTabCtrl::SetPadding Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestañas.
CTabCtrl::SetToolTips Asigna un control de información sobre herramientas a un control de pestañas.

Comentarios

Un "control de pestañas" es análogo a los divisores de un bloc de notas o las carpetas etiquetadas de un archivador. Mediante el uso de un control de ficha, una aplicación puede definir varias páginas para la misma área de un cuadro de diálogo o de una ventana. Cada página consta de un conjunto de información o un grupo de controles que la aplicación muestra cuando el usuario selecciona la pestaña correspondiente. Un tipo especial de control de pestañas muestra pestañas que tienen un aspecto similar al de los botones. Hacer clic en un botón debe realizar inmediatamente un comando en lugar de mostrar una página.

Este control (y, por tanto, la clase CTabCtrl) solo está disponible para los programas que se ejecutan en Windows 95/98 y Windows NT 3.51 y posteriores.

Para obtener más información sobre CTabCtrl, consulte Controles (MFC) y Uso de CTabCtrl.

Jerarquía de herencia

CObject
CCmdTarget
CWnd

CTabCtrl

Requisitos

Encabezadoafxcmn.h:

CTabCtrl::AdjustRect

Calcula el área de visualización de un control de pestañas según un rectángulo de ventana o calcula el rectángulo de ventana que correspondería a un área de visualización determinada.

void AdjustRect(BOOL bLarger,   LPRECT lpRect);

Parámetros

bLarger
Indica la operación que se va a realizar. Si este parámetro es TRUE, lpRect especifica un rectángulo de visualización y recibe el rectángulo de ventana correspondiente. Si este parámetro es FALSE, lpRect especifica un rectángulo de ventana y recibe el rectángulo de visualización correspondiente.

lpRect
Puntero a una estructura RECT que especifica el rectángulo indicado y recibe el rectángulo calculado.

Ejemplo

void CTabDlg::OnSize(UINT nType, int cx, int cy)
{
   CDialog::OnSize(nType, cx, cy);

   if (m_TabCtrl.m_hWnd == NULL)
      return; // Return if window is not created yet.

   RECT rect;

   // Get size of dialog window.
   GetClientRect(&rect);

   // Adjust the rectangle to fit the tab control into the
   // dialog's client rectangle.
   m_TabCtrl.AdjustRect(FALSE, &rect);

   // Move the tab control to the new position and size.
   m_TabCtrl.MoveWindow(&rect, TRUE);
}

CTabCtrl::Create

Crea un control de pestañas y lo adjunta a una instancia de un objeto CTabCtrl.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parámetros

dwStyle
Especifica el estilo del control de pestañas. Aplique cualquier combinación de estilos de control de pestañas, que se describen en Windows SDK. Consulte Comentarios para obtener una lista de estilos de ventana que también puede aplicar al control.

rect
Especifica el tamaño y la posición del control de pestañas. Puede ser un objeto CRect o una estructura RECT.

pParentWnd
Especifica la ventana primaria del control de pestañas (normalmente, un elemento CDialog). Este valor no debe ser NULL.

nID
Especifica el identificador del control de pestañas.

Valor devuelto

TRUE si la inicialización del objeto se realizó correctamente; de lo contrario, FALSE.

Comentarios

El objeto CTabCtrl se construye en dos pasos. En primer lugar, llame al constructor y, luego, llame a Create, lo que crea el control de pestañas y lo asocia al objeto CTabCtrl.

Además de los estilos de control de pestañas, puede aplicar los siguientes estilos de ventana a un control de pestañas:

  • WS_CHILD: crea una ventana secundaria que representa el control de pestañas. No se puede usar con el estilo WS_POPUP.
  • WS_VISIBLE: crea un control de pestañas que está visible inicialmente.
  • WS_DISABLED: crea una ventana que está deshabilitada inicialmente.
  • WS_GROUP: especifica el primer control de un grupo de controles en los que el usuario puede pasar de un control al siguiente con las teclas de dirección. Todos los controles definidos con el estilo WS_GROUP después del primer control pertenecen al mismo grupo. El siguiente control con el estilo WS_GROUP finaliza el grupo de estilo e inicia el siguiente grupo (es decir, un grupo finaliza donde comienza el siguiente).
  • WS_TABSTOP: especifica un control entre varios mediante los cuales el usuario se puede mover con la tecla TAB. La tecla TAB mueve al usuario al siguiente control especificado por el estilo WS_TABSTOP.

Para crear un control de pestañas con estilos de ventana extendidos, llame a CTabCtrl::CreateEx en lugar de a Create.

Ejemplo

// Assuming you have a member variable m_TabCtrl, that is a CTabCtrl
// object, you can use the following to create a tab control.

m_TabCtrl.Create(TCS_TABS | TCS_FIXEDWIDTH | WS_CHILD | WS_VISIBLE,
                 rect, this, IDC_MYTAB);

// This creates a tab control with the given styles, and with
// an ID of IDC_MYTAB.

CTabCtrl::CreateEx

Esta función puede usarse para crear un control (una ventana secundaria) y asociarlo con el objeto CTabCtrl.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parámetros

dwExStyle
El valor de este parámetro se usa para especificar el estilo extendido del control que se va a crear. Para obtener una lista de estilos extendidos de Windows, consulte el parámetro dwExStyle de la función CreateWindowEx en Windows SDK.

dwStyle
Especifica el estilo del control de pestañas. Aplique cualquier combinación de estilos de control de pestañas, que se describen en Windows SDK. Consulte Comentarios en Create para obtener una lista de estilos de ventana que también puede aplicar al control.

rect
Una referencia a una estructura RECT describiendo el tamaño y la posición de la ventana a crear, en las coordenadas cliente de pParentWnd.

pParentWnd
Un puntero a la ventana que constituye el elemento primario del control.

nID
El identificador de ventana secundaria del control.

Valor devuelto

Distinto de cero si se realiza correctamente; de lo contrario, 0.

Comentarios

Usa la función CreateEx, en lugar de Create, para aplicar estilos extendidos de Windows. Estos se especifican en el prefacio de estilo extendido WS_EX_ de Windows.

CreateEx crea el control con los estilos de extendidos de Windows especificados por dwExStyle. Establece estilos extendidos específicos de un control mediante SetExtendedStyle. Por ejemplo, use CreateEx para establecer estilos como WS_EX_CONTEXTHELP, pero use SetExtendedStyle para establecer estilos como TCS_EX_FLATSEPARATORS. Para obtener más información, consulte los estilos que se describen en Estilos extendidos de control de pestañas en Windows SDK.

CTabCtrl::CTabCtrl

Construye un objeto CTabCtrl.

CTabCtrl();

CTabCtrl::DeleteAllItems

Quita todos los elementos de un control de pestañas.

BOOL DeleteAllItems();

Valor devuelto

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

CTabCtrl::DeleteItem

Quita el elemento especificado de un control de pestañas.

BOOL DeleteItem(int nItem);

Parámetros

nItem
Valor de base cero del elemento que se va a eliminar.

Valor devuelto

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

Ejemplo

// This example assumes that there is a CTabCtrl member of the
// CTabDlg class named m_TabCtrl.  On a button handler
// called OnDeleteItem of the dialog box the tab control will
// delete the 0 indexed item.

void CTabDlg::OnDeleteItem()
{
   // Delete the first item in the tab control.
   m_TabCtrl.DeleteItem(0);
}

CTabCtrl::DeselectAll

Restablece los elementos de un control de pestañas, borrando los que se pulsaron.

void DeselectAll(BOOL fExcludeFocus);

Parámetros

fExcludeFocus
Marca que especifica el ámbito de la anulación de selección del elemento. Si este parámetro se establece en FALSE, se restablecerán todos los botones de pestaña. Si se establece en TRUE, se restablecerán todos los elementos de pestaña excepto el seleccionado actualmente.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_DESELECTALL de Win32, tal y como se describe en Windows SDK.

CTabCtrl::DrawItem

Lo llama el marco de trabajo cuando cambia un aspecto visual de un control de pestañas dibujado por el propietario.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

Parámetros

lpDrawItemStruct
Puntero a una estructura DRAWITEMSTRUCT que describe el elemento que se va a pintar.

Comentarios

El miembro itemAction de la estructura DRAWITEMSTRUCT define la acción de dibujo que se va a realizar.

De manera predeterminada, esta función miembro no hace nada. Invalida esta función miembro para implementar el dibujo de un objeto CTabCtrl dibujado por el propietario.

La aplicación debe restaurar todos los objetos de interfaz de dispositivo gráfico (GDI) seleccionados para el contexto de presentación proporcionado en lpDrawItemStruct antes de que finalice esta función miembro.

CTabCtrl::GetCurFocus

Recupera el índice de la pestaña con el foco actual.

int GetCurFocus() const;

Valor devuelto

Índice de base cero de la pestaña con el foco actual.

CTabCtrl::GetCurSel

Recupera la pestaña seleccionada actualmente en un control de pestañas.

int GetCurSel() const;

Valor devuelto

Índice de base cero de la pestaña seleccionada si se realiza correctamente o -1 si no hay ninguna pestaña seleccionada.

CTabCtrl::GetExtendedStyle

Recupera los estilos extendidos que están actualmente en uso para el control de pestañas.

DWORD GetExtendedStyle();

Valor devuelto

Representa los estilos extendidos actualmente en uso para el control de pestañas. Este valor es una combinación de estilos extendidos de control de pestañas, como se describe en Windows SDK.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_GETEXTENDEDSTYLE de Win32, tal y como se describe en Windows SDK.

CTabCtrl::GetImageList

Recupera la lista de imágenes asociada a un control de pestaña.

CImageList* GetImageList() const;

Valor devuelto

Si se realiza correctamente, puntero a la lista de imágenes del control de pestañas; de lo contrario, NULL.

CTabCtrl::GetItem

Recupera información sobre una pestaña de un control de pestañas.

BOOL GetItem(int nItem,   TCITEM* pTabCtrlItem) const;

Parámetros

nItem
Índice de base cero de la pestaña.

pTabCtrlItem
Puntero a una estructura TCITEM que se usa para especificar la información que se va a recuperar. También se usa para recibir información sobre la pestaña. Esta estructura se usa con las funciones miembro InsertItem, GetItem y SetItem.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente; FALSE de lo contrario, .

Comentarios

Cuando se envía el mensaje, el miembro mask especifica qué atributos se van a devolver. Si el miembro mask especifica el valor TCIF_TEXT, el miembro pszText debe contener la dirección del búfer que recibe el texto del elemento y el miembro cchTextMax debe especificar el tamaño del búfer.

  • mask

    Valor que especifica qué miembros de la estructura TCITEM se van a recuperar o establecer. Este miembro puede ser cero o una combinación de los valores siguientes:

    • TCIF_TEXT: el miembro pszText es válido.
    • TCIF_IMAGE: el miembro iImage es válido.
    • TCIF_PARAM: el miembro lParam es válido.
    • TCIF_RTLREADING: el texto de pszText se muestra mediante el orden de lectura de derecha a izquierda en los sistemas hebreo y árabe.
    • TCIF_STATE: el miembro dwState es válido.

  • pszText

    Si la estructura contiene información sobre una pestaña, puntero a una cadena terminada en null que contiene el texto de la pestaña. Si la estructura recibe información, este miembro especifica la dirección del búfer que recibe el texto de la pestaña.

  • cchTextMax

    Tamaño del búfer al que apunta pszText. Este miembro se omite si la estructura no va a recibir información.

  • iImage Índice de la lista de imágenes del control de pestañas o -1 si no hay ninguna imagen para la pestaña.

  • lParam

    Datos definidos por la aplicación asociados a la pestaña. Si hay más de 4 bytes de datos definidos por la aplicación por pestaña, la aplicación debe definir una estructura y usarla en lugar de la estructura TCITEM. El primer miembro de la estructura definida por la aplicación debe ser una estructura TCITEMHEADER. La estructura TCITEMHEADER es idéntica a la estructura TCITEM, pero sin el miembro lParam. La diferencia entre el tamaño de su estructura y el tamaño de la estructura TCITEMHEADER debe ser igual al número de bytes adicionales por pestaña.

Ejemplo

// In this example a CTabCtrl data member, m_TabCtrl, changes the
// text of the tabs in the tab control.  A call to GetItem is used
// to get the current text, and then the text is changed.  A call
// to SetItem is used to update the tab with the new text.

void CTabDlg::OnChangeItem()
{
   TCITEM tcItem;
   CString pszString;

   //  Get text for the tab item.
   GetDlgItemText(IDC_ITEM_TEXT, pszString);

   //  Get the current tab item text.
   TCHAR buffer[256] = {0};
   tcItem.pszText = buffer;
   tcItem.cchTextMax = 256;
   tcItem.mask = TCIF_TEXT;
   m_TabCtrl.GetItem(0, &tcItem);
   TRACE(_T("Changing item text from %s to %s..."), tcItem.pszText, pszString);

   //  Set the new text for the item.
   tcItem.pszText = pszString.LockBuffer();

   //  Set the item in the tab control.
   m_TabCtrl.SetItem(0, &tcItem);

   pszString.UnlockBuffer();
}

CTabCtrl::GetItemCount

Recupera el número de pestañas del control de pestañas.

int GetItemCount() const;

Valor devuelto

Número de elementos del control de pestañas.

Ejemplo

Vea el ejemplo de CPropertySheet::GetTabControl.

CTabCtrl::GetItemRect

Recupera el rectángulo delimitador de la pestaña especificada de un control de pestañas.

BOOL GetItemRect(int nItem,   LPRECT lpRect) const;

Parámetros

nItem
Índice de base cero del elemento de pestaña.

lpRect
Puntero a una estructura RECT que recibe el rectángulo delimitador de la pestaña. Estas coordenadas usan el modo de asignación actual de la ventanilla.

Valor devuelto

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

Ejemplo

Vea el ejemplo de CPropertySheet::GetTabControl.

CTabCtrl::GetItemState

Recupera el estado del elemento de control de pestañas identificado por nItem.

DWORD GetItemState(
    int nItem,
    DWORD dwMask) const;

Parámetros

nItem
Número de índice de base cero del elemento para el que se va a recuperar la información de estado.

dwMask
Máscara que especifica cuál de las marcas de estado del elemento se van a devolver. Para obtener una lista de valores, consulte el miembro de máscara de la estructura TCITEM, como se describe en Windows SDK.

Valor devuelto

Referencia a un valor DWORD que recibe la información de estado. Puede ser uno de los siguientes valores:

Valor Descripción
TCIS_BUTTONPRESSED El elemento de control de pestañas está seleccionado.
TCIS_HIGHLIGHTED El elemento de control de pestañas está resaltado y la pestaña y el texto se dibujan con el color de resaltado actual. Al usar el color de resaltado, será una interpolación verdadera, no un color suavizado.

Comentarios

El miembro dwState de la estructura TCITEM especifica el estado de un elemento.

CTabCtrl::GetRowCount

Recupera el número actual de filas de un control de pestañas.

int GetRowCount() const;

Valor devuelto

Número de filas de pestañas del control de pestañas.

Comentarios

Solo los controles de pestaña que tienen el estilo TCS_MULTILINE pueden tener varias filas de pestañas.

CTabCtrl::GetToolTips

Recupera el manipulador del control de información sobre herramientas asociado a un control de pestañas.

CToolTipCtrl* GetToolTips() const;

Valor devuelto

Manipulador del control de información sobre herramientas si se realiza correctamente; de lo contrario, NULL.

Comentarios

Un control de pestañas crea un control de información sobre herramientas si tiene el estilo TCS_TOOLTIPS. También puede asignar un control de información sobre herramientas a un control de pestañas mediante la función miembro SetToolTips.

CTabCtrl::HighlightItem

Establece el estado de resaltado de un elemento de pestaña.

BOOL HighlightItem(int idItem,  BOOL fHighlight = TRUE);

Parámetros

idItem
Índice de base cero de un elemento de control de pestañas.

fHighlight
Valor que especifica el estado de resaltado que se va a establecer. Si este valor es TRUE, la pestaña está resaltada; si es FALSE, la pestaña se establece en su estado predeterminado.

Valor devuelto

Es distinto de cero si es correcto. En caso contrario, es cero.

Comentarios

En esta función miembro, se implementa el mensaje TCM_HIGHLIGHTITEM de Win32, tal y como se describe en Windows SDK.

CTabCtrl::HitTest

Determina qué pestaña, si la hay, está en la posición de pantalla especificada.

int HitTest(TCHITTESTINFO* pHitTestInfo) const;

Parámetros

pHitTestInfo
Puntero a una estructura TCHITTESTINFO, como se describe en Windows SDK, que especifica la posición de pantalla que se va a probar.

Valor devuelto

Devuelve el índice de base cero de la pestaña o -1 si no hay ninguna pestaña en la posición especificada.

CTabCtrl::InsertItem

Inserta una nueva pestaña en un control de pestañas existente.

LONG InsertItem(
    int nItem,
    TCITEM* pTabCtrlItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem);

LONG InsertItem(
    int nItem,
    LPCTSTR lpszItem,
    int nImage);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam);

LONG InsertItem(
    UINT nMask,
    int nItem,
    LPCTSTR lpszItem,
    int nImage,
    LPARAM lParam,
    DWORD dwState,
    DWORD dwStateMask);

Parámetros

nItem
Índice de base cero de la pestaña nueva.

pTabCtrlItem
Puntero a una estructura TCITEM que especifica los atributos de la pestaña.

lpszItem
Dirección de una cadena terminada en NULL que contiene el texto de la pestaña.

nImage
Índice de base cero de una imagen que se va a insertar desde una lista de imágenes.

nMask
Especifica los atributos de la estructura TCITEM que se van a establecer. Puede ser cero o una combinación de los valores siguientes:

  • TCIF_TEXT: el miembro pszText es válido.
  • TCIF_IMAGE: el miembro iImage es válido.
  • TCIF_PARAM: el miembro lParam es válido.
  • TCIF_RTLREADING: el texto de pszText se muestra mediante el orden de lectura de derecha a izquierda en los sistemas hebreo y árabe.
  • TCIF_STATE: el miembro dwState es válido.

lParam
Datos definidos por la aplicación asociados a la pestaña.

dwState
Especifica valores para los estados del elemento. Para más información, consulte TCITEM en Windows SDK.

dwStateMask
Especifica qué estados se van a establecer. Para más información, consulte TCITEM en Windows SDK.

Valor devuelto

Índice de base cero de la nueva pestaña si se ejecuta correctamente; en caso contrario, -1.

Ejemplo

TCITEM tcItem;
tcItem.mask = TCIF_TEXT;
tcItem.pszText = _T("Tab #1");

m_TabCtrl.InsertItem(0, &tcItem);

CTabCtrl::RemoveImage

Quita la imagen especificada de la lista de imágenes de un control de pestañas.

void RemoveImage(int nImage);

Parámetros

nImage
Índice de base cero de la imagen que se va a quitar.

Comentarios

El control de pestañas actualiza el índice de la imagen de cada pestaña para que cada pestaña permanezca asociada a la misma imagen.

CTabCtrl::SetCurFocus

Establece el foco en una pestaña especificada de un control de pestañas.

void SetCurFocus(int nItem);

Parámetros

nItem
Especifica el índice de la pestaña que obtiene el foco.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_SETCURFOCUS de Win32, tal y como se describe en Windows SDK.

CTabCtrl::SetCurSel

Selecciona una pestaña de un control de pestañas.

int SetCurSel(int nItem);

Parámetros

nItem
Índice de base cero del elemento que se va a seleccionar.

Valor devuelto

Índice de base cero de la pestaña seleccionada anteriormente si se ejecuta correctamente; de lo contrario, -1.

Comentarios

Un control de pestañas no envía un mensaje de notificación TCN_SELCHANGING ni TCN_SELCHANGE cuando se selecciona una pestaña mediante esta función. Estas notificaciones se envían mediante WM_NOTIFY cuando el usuario hace clic o usa el teclado para cambiar de pestaña.

CTabCtrl::SetExtendedStyle

Establece los estilos extendidos de un control de pestañas.

DWORD SetExtendedStyle(DWORD dwNewStyle, DWORD dwExMask = 0);

Parámetros

dwNewStyle
Valor que especifica una combinación de estilos extendidos de control de pestañas.

dwExMask
Valor DWORD que indica qué estilos de dwNewStyle se verán afectados. Solo se cambiarán los estilos extendidos de dwExMask. Todos los demás estilos se mantendrán tal y como están. Si este parámetro es cero, todos los estilos de dwNewStyle se verán afectados.

Valor devuelto

Valor DWORD que contiene los anteriores estilos extendidos de control de pestañas, como se describe en Windows SDK.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_SETEXTENDEDSTYLE de Win32, tal y como se describe en Windows SDK.

CTabCtrl::SetImageList

Asigna una lista de imágenes a un control de pestañas.

CImageList* SetImageList(CImageList* pImageList);

Parámetros

pImageList
Puntero a la lista de imágenes que se va a asignar al control de pestañas.

Valor devuelto

Devuelve un puntero a la lista de imágenes anterior o NULL si no hay ninguna lista de imágenes anterior.

CTabCtrl::SetItem

Establece algunos o todos los atributos de una pestaña.

BOOL SetItem(int nItem,   TCITEM* pTabCtrlItem);

Parámetros

nItem
Índice de base cero del elemento.

pTabCtrlItem
Puntero a una estructura TCITEM que contiene los nuevos atributos del elemento. El miembro mask especifica los atributos que se van a establecer. Si el miembro mask especifica el valor TCIF_TEXT, el miembro pszText es la dirección de una cadena terminada en null y se omite el miembro cchTextMax.

Valor devuelto

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

Ejemplo

Vea el ejemplo de GetItem.

CTabCtrl::SetItemExtra

Establece el número de bytes por pestaña reservados para los datos definidos por la aplicación en un control de pestañas.

BOOL SetItemExtra(int nBytes);

Parámetros

nBytes
Número de bytes adicionales que se van a establecer.

Valor devuelto

Es distinto de cero si es correcto. En caso contrario, es cero.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_SETITEMEXTRA de Win32, tal y como se describe en Windows SDK.

CTabCtrl::SetItemSize

Establece el ancho y alto de los elementos de control de pestaña.

CSize SetItemSize(CSize size);

Parámetros

size
El nuevo ancho y alto, en píxeles, de los elementos de control de pestaña.

Valor devuelto

Devuelve el ancho y el alto antiguos de los elementos de control de pestaña.

CTabCtrl::SetItemState

Establece el estado del elemento de control de pestañas identificado por nItem.

BOOL SetItemState(
    int nItem,
    DWORD dwMask,
    DWORD dwState);

Parámetros

nItem
Número de índice de base cero del elemento para el que se va a establecer la información de estado.

dwMask
Máscara que especifica cuáles de las marcas de estado del elemento se van a devolver. Para obtener una lista de valores, consulte el miembro de máscara de la estructura TCITEM, como se describe en Windows SDK.

dwState
Referencia a un valor DWORD que contiene la información de estado. Puede ser uno de los siguientes valores:

Valor Descripción
TCIS_BUTTONPRESSED El elemento de control de pestañas está seleccionado.
TCIS_HIGHLIGHTED El elemento de control de pestañas está resaltado y la pestaña y el texto se dibujan con el color de resaltado actual. Al usar el color de resaltado, será una interpolación verdadera, no un color suavizado.

Valor devuelto

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

CTabCtrl::SetMinTabWidth

Establece el ancho mínimo de los elementos de un control de pestañas.

int SetMinTabWidth(int cx);

Parámetros

cx
Ancho mínimo que se va a establecer para un elemento de control de pestañas. Si este parámetro se establece en -1, el control usará el ancho de pestaña predeterminado.

Valor devuelto

Ancho de pestaña mínimo anterior.

Comentarios

En esta función miembro, se implementa el comportamiento del mensaje TCM_SETMINTABWIDTH de Win32, tal y como se describe en Windows SDK.

CTabCtrl::SetPadding

Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestañas.

void SetPadding(CSize size);

Parámetros

size
Establece la cantidad de espacio (relleno) alrededor del icono y la etiqueta de cada pestaña en un control de pestañas.

CTabCtrl::SetToolTips

Asigna un control de información sobre herramientas a un control de pestañas.

void SetToolTips(CToolTipCtrl* pWndTip);

Parámetros

pWndTip
Manipulador del control de información sobre herramientas.

Comentarios

Para obtener el control de información sobre herramientas asociado a un control de pestañas, realice una llamada a GetToolTips.

Ejemplo

Vea el ejemplo de CPropertySheet::GetTabControl.

Consulte también

CWnd (clase)
CHeaderCtrl (clase)
CListCtrl (clase)
Gráfico de jerarquías