Presentación

El widget SearchPicker, permite crear fácilmente las áreas estándar de búsqueda, similares a las encontradas en los navegadores o barras de herramientas. La apariencia del área depende de la plataforma.

Windows: Mac OS:

El texto que se muestra por defecto en el área puede controlarse por programación, utilizando el método componente SearchPicker SET HELP TEXT.

Además de su apariencia, un área de búsqueda SearchPicker se caracteriza por los siguientes elementos: texto en gris, un área de entrada y un icono de eliminación.

• El área de entrada es donde el usuario introduce el valor a buscar. Este valor es asignado automática y dinámicamente a la variable asociada al área en la lista de propiedades (propiedad "Nombre de variable"). Utilice esta variable para proporcionar el valor buscado al método de búsqueda.
• El texto gris es una ayuda que indica al usuario el o los campo(s) donde se efectúo la búsqueda. Desaparece tan pronto como el área tiene el foco. Este texto puede definirse vía el comando SearchPicker SET HELP TEXT.
• El botón de eliminación permite borrar el contenido del área. Su funcionamiento es automático.

Durante la ejecución, puede iniciar su método de búsqueda haciendo clic en el botón o en un evento formulario. El área genera concretamente los eventos On Data Change y On Losing Focus.  Puede ofrecer una búsqueda dinámica que se reevalúe cada vez que el usuario introduzca otro carácter mediante una llamada al método de búsqueda en el evento On Data Change. También puede iniciar la búsqueda cuando el usuario presiona la tecla Intro: en este caso, sólo tiene que llamar al método de búsqueda en el evento On Losing Focus.

Puede insertar un área SearchPicker de dos formas:

• Insertando un objeto "SearchPicker" de la librería de objetos preconfigurados de 4D (tema "áreas de entrada").
• Creando un área de subformulario y asignándola al formulario detallado SearchPicker.
  

A continuación, especifique el nombre de la variable asociada al subformulario (propiedad "Nombre de la variable" en la Lista de propiedades). Cuando el formulario se ejecuta, esta variable contendrá automáticamente el valor buscado por el usuario. A continuación, puede pasar este valor a su método de búsqueda personalizado.