CListCtrl::SortItemsEx

Artículo
02/19/2013

Ordena los elementos del control actual de la vista de lista mediante una función definido por la aplicación de la comparación.

BOOL SortItemsEx(
     PFNLVCOMPARE pfnCompare, 
     DWORD_PTR dwData
);

Parámetros

Parámetro	Descripción
[in] pfnCompare	dirección de la función definido por la aplicación de la comparación. La operación de ordenación llama a la función de comparación cada vez que el orden relativo de dos elementos de lista debe ser determinado.La función de comparación debe ser un miembro estático de una clase o función independiente que no es miembro de ninguna clase.
[in] dwData	Valor definido por la aplicación pasado a la función de comparación.

[in] pfnCompare

dirección de la función definido por la aplicación de la comparación.

La operación de ordenación llama a la función de comparación cada vez que el orden relativo de dos elementos de lista debe ser determinado.La función de comparación debe ser un miembro estático de una clase o función independiente que no es miembro de ninguna clase.

[in] dwData

Valor definido por la aplicación pasado a la función de comparación.

Valor devuelto

true si este método es correcto; si no, false.

Comentarios

este método cambia el índice de cada elemento para reflejar la nueva secuencia.

La función de comparación, pfnCompare, tiene el formato siguiente:

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);

Este mensaje es como LVM_SORTITEMS, a excepción del tipo de información que se pasa a la función de comparación.En LVM_SORTITEMS, lParam1 y lParam2 son los valores de los elementos que se van a comparar.En LVM_SORTITEMSEX, lParam1 es el índice actual del primer elemento a comparar y lParam2 es el índice actual del segundo elemento.Puede enviar un mensaje de LVM_GETITEMTEXT para recuperar más información sobre un elemento.

La función de comparación debe devolver un valor negativo si el primer elemento precede al segundo, un valor positivo si el primer elemento sigue el segundo, o pone a cero si los dos elementos son iguales.

[!NOTA]

Durante el proceso de ordenación, el contenido de la vista de lista son inestables.Si la función de devolución de llamada envía los mensajes al control listview con excepción de LVM_GETITEM, los resultados son imprevisibles.

este método envía el mensaje de LVM_SORTITEMSEX , que se describe en Windows SDK.

Requisitos

encabezado: afxcmn.h

Este método se admite en Windows, Windows NT 4.0 con Internet Explorer 5, Ejecutar, y posteriormente.

Ejemplo

El ejemplo de código siguiente define una variable, m_listCtrl, que se utiliza para tener acceso al control actual de la vista de lista.esta variable se utiliza en el ejemplo siguiente.

public:
    // Variable used to access the list control.
    CListCtrl m_listCtrl;

En el ejemplo de código siguiente se muestra el método SortItemEx.En una sección anterior de este ejemplo de código, creamos un control listview que muestra dos columnas titularon “ClientID” y “grado” en una vista de informe.El ejemplo de código siguiente ordena la tabla mediante los valores de la columna “grado”.

// The ListCompareFunc() method is a global function used by SortItemEx().
int CALLBACK ListCompareFunc(
                             LPARAM lParam1, 
                             LPARAM lParam2, 
                             LPARAM lParamSort)
{
    CListCtrl* pListCtrl = (CListCtrl*) lParamSort;
    CString    strItem1 = pListCtrl->GetItemText(static_cast<int>(lParam1), 1);
    CString    strItem2 = pListCtrl->GetItemText(static_cast<int>(lParam2), 1);

    int x1 = _tstoi(strItem1.GetBuffer());
    int x2 = _tstoi(strItem2.GetBuffer());
    int result = 0;
    if ((x1 - x2) < 0)
        result = -1;
    else if ((x1 - x2) == 0)
        result = 0;
    else
        result = 1;

    return result;
}

void CCListCtrl_s2Dlg::OnBnClickedButton1()
{
    // SortItemsEx
    m_listCtrl.SortItemsEx( ListCompareFunc, (LPARAM)&m_listCtrl );
}