Clase wxDataViewModel

Constructor.

Destructor.

No debe llamarse directamente. Utilizar DecRef en su lugar.

Añade un wxDataViewModelNotifier al modelo.

Cambia el valor del elemento dado y actualiza el control para reflejarlo.

Esta función simplemente llama a SetValue() y, si tiene éxito, a ValueChanged().

Parámetros

variant

El nuevo valor.

item

El ítem (fila) a actualizar.

col

La columna a actualizar.

Valor de retorno

true si tanto SetValue() como ValueChanged() devuelven true.

Llamado para informar al modelo que todos sus datos han sido cambiados.

Este método debería ser llamado si han cambiado tantos de los ítems del modelo, que el control debería simplemente releerlos todos, repoblándose por completo.

hay que tener en cuenta que, contrariamente al nombre del método, no indica necesariamente que el modelo se ha vaciado - aunque este es el método correcto a llamar, en lugar de ItemsDeleted(), si efectivamente se vació, lo que explica el origen de su nombre.

La función de comparación a utilizar por el control.

La función de comparación por defecto ordena la mayoría de los tipos de datos implementados por wxVariant (es decir, bool, int, long, double, string), así como datetime y wxDataViewIconText. Anular este método para implementar un comportamiento de ordenación diferente o anular sólo DoCompareValues() para extenderlo a otros tipos de wxVariant.

La función debe devolver negativo, nulo o positivo para una comparación ascendente, dependiendo de si el primer elemento es menor, igual o mayor que el segundo. Lo contrario ocurre para las comparaciones descendentes. Los elementos deben compararse utilizando el tipo apropiado para la columna pasada.

Parámetros

item1

Primer elemento a comparar.

item2

Segundo elemento a comparar.

column

La columna que contiene los elementos que se van a comparar. Si la clase modelo anula HasDefaultCompare() para que devuelva true, este parámetro será (unsigned)-1 al ordenar los elementos si no se selecciona ninguna columna para ordenarlos.

ascending

Indica si la ordenación se realiza en orden ascendente o descendente.

Valor de retorno

Para una comparación ascendente: un valor negativo si el ítem1 es menor que (es decir, debería aparecer por encima de) el ítem2, cero si los dos ítems son iguales o un valor positivo si el ítem1 es mayor que (es decir, debería aparecer por debajo de) el segundo. Lo contrario para una comparación descendente.

Nota: Si puede haber varias filas con el mismo valor, considerar la posibilidad de diferenciarlas entre sí por sus ID en lugar de devolver cero. Esto evita que filas con el mismo valor salten de posición cuando se añaden elementos, etc. Por ejemplo:

// Note that we need to distinguish between items with the same
// value.
wxUIntPtr id1 = wxPtrToUInt(item1.GetID()),
          id2 = wxPtrToUInt(item2.GetID());
 
return (ascending == (id1 > id2)) ? : 1 : -1;

Método virtual que puede sobrescribirse para definir la comparación de valores de tipos no estándar.

Esta función es llamada desde la implementación por defecto de Compare() para comparar valores de tipos que no conoce (es decir, que no son ninguno de los estándar). Como la propia función Compare(), este método debe devolver un valor negativo si valor1 es menor que (es decir, debe aparecer por encima de) valor2 y un valor positivo si valor2 es menor que valor1.

A diferencia de Compare(), si los valores son iguales, este método debería simplemente devolver 0 para indicarlo y dejar que Compare() los ordene por los valores de sus elementos. Tampoco hay que preocuparse por la dirección del orden, por lo que es más sencillo de anular que la propia función Compare().

La implementación por defecto sólo devuelve 0, por lo que la versión de la clase derivada puede simplemente reenviarla si no sabe cómo comparar los valores dados.

Sobrescribir esta opción para indicar que el elemento tiene atributos de fuente especiales.

Esto sólo afecta al renderizador wxDataViewTextRendererText.

La versión de la clase base siempre devuelve false.

Parámetros

item

El ítem para el que se solicita el atributo.

col

La columna del ítem para el que se solicita el atributo.

attr

El atributo a rellenar si la función devuelve true.

Valor de retorno

true si este elemento tiene un atributo o false en caso contrario.

sobrescribir esta opción para que el control pueda consultar los elementos hijos de un elemento.

Devuelve el número de elementos.

Sobrescribir para indicar qué wxDataViewItem representa al padre del ítem o un wxDataViewItem inválido si el ítem raíz es el ítem padre.

Sobrescribir esta función para indicar el valor del elemento.

Esta función debe rellenar la variant proporcionada con el valor a mostrar para el elemento especificado en la columna dada. El valor devuelto en esta wxVariant debe tener el tipo apropiado, por ejemplo string para las columnas de texto, boolean para las columnas que utilizan wxDataViewToggleRenderer etc, y si hay un desajuste de tipo, no se mostrará nada y se registrará un mensaje de error de depuración.

También es posible no devolver ningún valor, en cuyo caso no se mostrará nada en la celda correspondiente, del mismo modo que si HasValue() devolviera false.

Sobrescribir este método para indicar si un elemento contenedor actúa meramente como encabezado (o para categorización) o si también actúa como un elemento normal con entradas para otras columnas.

Por defecto devuelve false.

Sobrescribir para indicar que el modelo proporciona una función de comparación por defecto que el control debe utilizar si no se ha elegido wxDataViewColumn para la ordenación.

Normalmente, si el usuario hace clic en la cabecera de una columna para ordenarla, los datos se ordenarán alfanuméricamente.

Si se requiere cualquier otro orden (por ejemplo, por índice o por orden de aparición), entonces debe utilizarse este método.

Hay que tener en cuenta que si este método se sobrescribe para que devuelva true, la implementación de Compare() debería estar preparada para aceptar (unsigned)-1 como valor para el parámetro de índice de columna.

Ver a href="/winapi/wxwidgets/wxDataViewIndexListModel">wxDataViewIndexListModel para un modelo que hace uso de esto.

Devuelve true si hay un valor en la columna dada de este elemento.

Todos los ítems normales tienen valores en todas las columnas pero los ítems contenedores sólo muestran su etiqueta en la primera columna (col == 0) por defecto (pero ver HasContainerColumns()). Así que esta función por defecto devuelve true para la primera columna mientras que para las otras sólo devuelve true si el ítem no es un contenedor o HasContainerColumns() fue sobrescrito para devolver true para él.

Desde wxWidgets 3.1.4, este método es virtual y puede ser sobrescrito para especificar explícitamente para qué columnas un elemento dado tiene, y no tiene, valores.

Anula esta opción para indicar si el elemento es un contenedor, es decir, si puede tener elementos secundarios.

Sobrescribir esta opción para indicar que el elemento debe estar desactivado.

Los elementos desactivados se muestran de forma diferente (por ejemplo, en gris) y no se puede interactuar con ellos.

La versión de la clase base siempre devuelve true, por lo que todos los elementos están habilitados por defecto.

Parámetros

item

El elemento cuyo estado de habilitación se solicita.

col

Columna del elemento cuyo estado de habilitación se solicita.

Valor de retorno

true si este elemento debe estar habilitado, false en caso contrario.

Llama a esta opción para informar al modelo de que se ha añadido un elemento a los datos.

Llamarla para informar al modelo de que un elemento ha cambiado.

Esto eventualmente emitirá un evento wxEVT_DATAVIEW_ITEM_VALUE_CHANGED (en el que los campos de columna no se establecerán) al usuario.

Llamar a esta opción para informar al modelo de que se ha eliminado un elemento de los datos.

Llamarla para informar al modelo de que varios elementos se han añadido a los datos.

Llamarla para informar al modelo de que varios elementos han cambiado.

Esto eventualmente emitirá eventos wxEVT_DATAVIEW_ITEM_VALUE_CHANGED (en los que los campos de columna no se establecerán) al usuario.

Llamar a esta opción para informar al modelo de que se han eliminado varios elementos.

Elimina el notificador de la lista de notificadores.

Llamarla para iniciar un recurso después de que la función de clasificación se ha cambiado.

Este método es llamado para establecer un valor en el modelo de datos.

El escenario más común es que el wxDataViewCtrl llame a este método después de que el usuario haya cambiado algún dato en la vista.

Esta es la función que se debe anular en la clase derivada, pero si se desea llamarla, ChangeValue() suele ser más conveniente, ya que de lo contrario se tendrá que llamar manualmente a ValueChanged() para actualizar el propio control.

Llamala para informar a este modelo que un valor en el modelo ha sido cambiado.

También es llamada desde el código de edición interno de wxDataViewCtrl, por ejemplo cuando se edita un campo de texto en el control.

Eventualmente emitirá un evento wxEVT_DATAVIEW_ITEM_VALUE_CHANGED para el usuario.