Personal tools
You are here: Home Development Guía de referencia para gvSIG 1.1 Otras librerias UI Components ControlesBasicos ComboBoxItemSeeker
Document Actions

ComboBoxItemSeeker

by Victor Acevedo last modified 2010-06-01 22:52

ComboBox utilizado para realizar búsquedas en los items que forman parte de él, según una configuración proporcionda.

Esta clase es una extensión de DefaultComboBox y permite realizar búsquedas de objetos y mostrarlos en un ComboBox. El objeto devuelto depende de la configuracón que utilicemos y de la búsqueda que realicemos. El modelo que representa esta clase puede ser configurado con tres atributos:

Comportamiento inicial (Start Behavior): Configura como devolverá los items al principio (siempre devuelve todos lo items):

  • MAINTAIN_ORIGINAL_POSITION_START: Devuelve los items en el orden en el que se habían introducido.
  • ORDERED_START: Devuelve los items ordenados.
  • DISORDERED_START: Devuelve los items desordenados.

Comportamiento de búsqueda (Search Behavior): Configura cómo devolverá un objeto al realizar una búsqueda:

  • MAINTAIN_ORIGINAL_POSITION_ALL_ITEMS_SEARCH: Devuelve todos los objetos en el orden en que han sido introducidos.
  • ORDERED_ALL_ITEMS_SEARCH: Devuelve todos los items ordenados.
  • DISORDERED_ALL_ITEMS_SEARCH: Devuelve todos los objetos desordenados.
  • MAINTAIN_ORIGINAL_POSITION_DYNAMIC_SEARCH: Devuelve los items cuyo valor de cadena comienza por una determinada serie de carácteres indicados. Los objetos son devueltos en el orden en el que han sido introducidos.
  • ORDERED_DYNAMIC_SEARCH: Realiza una búsqueda similar a la configuración anterior pero en este caso los items devueltos son ordenados.
  • DISORDERED_DYNAMIC_SEARCH: Realiza una búsqueda similar a las anteriores pero en esta configuración los items son devueltos de forma desordenado

Distinguir entre mayúsculas (Case Sensitive): Distingue entre mayúsculas y minúsculas a la hora de realizar la búsqueda:

  • TRUE: Distingue entre mayúsculas y minúsculas cuando se realiza una búsqueda.
  • FALSE: No distingue entre mayúsculas y minúsculas cuando se realiza la búsqueda.

Por defecto la clase está configurada de la siguiente manera:

  • Start_Behavior = MAINTAIN_ORIGINAL_POSITION_START
  • Search_Behavior = ORDERED_DYNAMIC_SEARCH
  • Case_Sensitive = FALSE

El árbol de herencia se completa con "ComboBoxItemSeekerConfigurableModel" y con "ComboBoxSingularItemsSeekerConfigurableModel" que heredan de la clase anterior. La diferencia entre ambas es que la segunda esta optimizada para realizar búsquedas cuando no aparecen objetos repetidos, en cambio no funciona correctamente si aparecen items duplicados. En este caso utilizar la primera, aunque el tiempo empleado sea mayor.

En las siguientes imágenes vemos un ejemplo de su utilización:

imagenes/ComboBoxItemSeeker1.JPG

En esta primera imagen se muestran todos los objetos introducidos según una configuración inicial.

imagenes/ComboBoxItemSeeker2.JPG

En la segunda imágen se muestran los objetos ordenados y que comiencen por el carácter "a".

imagenes/ComboBoxItemSeeker3.JPG

En la tercera imágen aparecen los objetos de la lista anterior que comienzan por "aa".

Los objetos que aparecen lo hacen según las configuraciones introducidas en el programa de test. Además incorpora un menú PopUp que se crea cuando hacemos clic con el botón derecho del ratón sobre el campo de edición del ComboBox. Este menú posee las acciones típicas de edición de texto como son copiar, pegar, cortar, etc. Para más información sobre el menú PopUp mencionado visitar la página JOptionsEditionByMousePopupMenu de esta misma sección.

A continuación se muestra los fragmentos de código de interés en la realización del programa de test.

El constructor de la clase

JComboBoxItemsSeekerConfigurable jCBSC = new JComboBoxItemsSeekerConfigurable();

La forma de incluir algunos items para realizar las pruebas de la utilización

jCBSD.addItem(new Item("libNomenclatorIGN_GUI"));
jCBSD.addItem(new Item("libRemoteServices"));
jCBSD.addItem(new Item("extNomenclatorIGN")); // Duplication test
jCBSD.addItem(new Item("libUI"));
jCBSD.addItem(new Item("libUI"));
jCBSD.addItem(new Item("a"));
jCBSD.addItem(new Item("aa"));
jCBSD.addItem(new Item("aaa"));
jCBSD.addItem(new Item("aaa"));

Diferentes líneas para activar o desactivar flags para realizar pruebas con los items anteriores

// Test a configuration of behavior of the search of JComboBoxSearcheableDynamic
//jCBSD.setSearchBehavior(AbstractDefaultComboBoxItemsSeekerConfigurableModel.ORDERED_ALL_ITEMS_SEARCH);
//jCBSD.setSearchBehavior(AbstractDefaultComboBoxItemsSeekerConfigurableModel.DISORDERED_ALL_ITEMS_SEARCH);
//jCBSD.setSearchBehavior(AbstractDefaultComboBoxItemsSeekerConfigurableModel.ORDERED_DYNAMIC_SEARCH);
//jCBSD.setSearchBehavior(AbstractDefaultComboBoxItemsSeekerConfigurableModel.DISORDERED_DYNAMIC_SEARCH);     
//jCBSD.setStartBehavior(AbstractDefaultComboBoxItemsSeekerConfigurableModel.ORDERED_START);
... 

Cambio de flags de control/vista

// Test the change of the flag 'onlyOneColor_Flag'
jCBSD.setOnlyOneColorOnText_Flag(true);

// Test the change of the flag 'beepEnabled_Flag'
jCBSD.setBeepEnabled_Flag(false);

// Test the change of the flag 'hidePopupIfThereAreNoItems_Flag'
jCBSD.setHidePopupIfThereAreNoItems_Flag(false);

// Test the change of the flag 'toForceSelectAnItem_Flag'
jCBSD.setToForceSelectAnItem_Flag(false);

Cambio de flags del modelo

DefaultComboBoxItemsSeekerConfigurableModel model = (DefaultComboBoxItemsSeekerConfigurableModel)
jCBSD.getModel();

// Test the change of the flag 'itemsShownInListBox_Flag'
model.setLanguageRules_Flag("en_US");
// model.setLanguageRules_Flag("fr_FR");
// model.setLanguageRules_Flag("es_ES");
                    
// Test the change of the flag 'caseSensitive_Flag'
model.setCaseSensitive_Flag(DefaultComboBoxItemsSeekerConfigurableModel.CASE_INSENSITIVE);
// model.setCaseSensitive_Flag(false);
                     
// Test the change of the flag 'itemsOrder_Flag'
model.setItemsOrder_Flag(DefaultComboBoxItemsSeekerConfigurableModel.MAINTAIN_POSITION);
// model.setItemsOrder_Flag(DefaultComboBoxItemsSeekerConfigurableModel.DISORDERED);
// model.setItemsOrder_Flag(DefaultComboBoxItemsSeekerConfigurableModel.ALPHABETICAL_ORDERED);

// Test the change of the flag 'itemsShownInListBox_Flag'
model.setShowAllItemsInListBox_Flag(DefaultComboBoxItemsSeekerConfigurableModel.SHOW_ALL_ITEMS);
// model.setShowAllItemsInListBox_Flag(true);
// model.setShowAllItemsInListBox_Flag(DefaultComboBoxItemsSeekerConfigurableModel.SHOW_ONLY_MATCHES);
// model.setShowAllItemsInListBox_Flag(false);

Powered by Plone CMS, the Open Source Content Management System

This site conforms to the following standards: