CWnd::OnCompareItem
El marco de trabajo llama a esta función miembro para especificar la posición relativa de un nuevo elemento en una combinación o un cuadro de lista ordenada elemento secundario de dibujo propietario.
afx_msg int OnCompareItem(
int nIDCtl,
LPCOMPAREITEMSTRUCT lpCompareItemStruct
);
Parámetros
nIDCtl
El identificador del control que envió el mensaje de WM_COMPAREITEM .lpCompareItemStruct
Contiene un puntero largo en una estructura de datos de COMPAREITEMSTRUCT que contiene identificadores y los datos aplicación-proporcionados para dos elementos de combinación o el cuadro de lista.
Valor devuelto
Indica la posición relativa de los elementos. Puede ser cualquiera de los valores siguientes:
Valor |
Significado |
---|---|
–1 |
Ordena el punto 1 antes del punto 2. |
0 |
El punto 1 y el punto 2 ordenan igual. |
1 |
Ordena el punto 1 después del punto 2. |
Comentarios
Si una combinación o un cuadro de lista se crea con el estilo de CBS_SORT o de LBS_SORT , Windows envía al propietario del cuadro combinado o el cuadro de lista un mensaje de WM_COMPAREITEM siempre que la aplicación agregue un nuevo elemento.
Dos elementos de combinación o el cuadro de lista se reforman en una estructura de COMPAREITEMSTRUCT designada por a lpCompareItemStruct. OnCompareItem debe devolver un valor que indica cuál de los elementos deben aparecer antes que el otro. Normalmente, Windows crea esta llamada varias veces hasta que determine la posición exacta del nuevo elemento.
Si el miembro de hwndItem de la estructura de COMPAREITEMSTRUCT pertenece a CListBox u objeto de CComboBox , la función virtual de CompareItem de la clase correspondiente se denomina. Reemplazo CComboBox::CompareItem o CListBox::CompareItem en CListBox o la clase derivada de CComboBox para que la comparación del elemento.
Nota
Esta función miembro llaman el marco para que la aplicación pueda controlar un mensaje de Windows.Los parámetros pasados a la función reflejan los parámetros recibidos por el marco cuando el mensaje se recibió.Si llama a la implementación de la clase base de esta función, esa implementación utilizará los parámetros pasados originalmente con el mensaje y no los parámetros que se proporciona a la función.
Requisitos
encabezado: afxwin.h