CTabCtrl::GetItem

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

Valor devuelto

Devuelve TRUE si tiene éxito; Falso lo contrario.

Parámetros

nItem

Índice de base cero de la ficha.

pTabCtrlItem

Puntero a un TCITEM estructura que se utiliza para especificar la información a recuperar. También se utiliza para recibir información acerca de la ficha. Esta estructura se utiliza con las funciones miembro InsertItem, GetItemy SetItem.

Observaciones

Llamar a esta función para recuperar información acerca de una ficha en un control de ficha.

Cuando se envía el mensaje, el miembro de máscara especifica los atributos para volver. Si el miembro de máscara 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 de cchTextMax debe especificar el tamaño del búfer.

máscara

Valor que especifica que los miembros de estructura TCITEM para recuperar o establecer. Este miembro puede ser cero o una combinación de los siguientes valores:

• 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_RTLREADI&NGnbsp;  Se muestra el texto de pszText utilizando el orden de lectura de derecha a izquierda en hebreo o árabe sistemas.
  
  
• TCIF_STATE   El miembro dwState es válido.

pszText

Puntero a una cadena terminada en nulo que contiene el texto de la ficha si la estructura contiene información acerca de una ficha. Si la estructura está recibiendo información, este miembro especifica la dirección del búfer que recibe el texto de la ficha.

cchTextMax

Tamaño del búfer apuntado por pszText. Este miembro se omite si la estructura no está recibiendo la información.

iImage

Í&ndice en la lista de imágenes del control ficha, ornbsp; – 1 si no hay ninguna imagen de la ficha.

lParam

Definido por la aplicación datos asociados con la ficha. Si hay más de cuatro bytes de datos definido por la aplicación por ficha, una aplicación debe definir una estructura y usarlo 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 ficha.

Visió&n General de CTabCtrl |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CTabCtrl::InsertItem, CTabCtrl::SetItem