Clase wxTextCompleter
Clase base para objetos completadores de texto personalizados.
Jerarquía:
Los objetos completadores personalizados utilizados con wxTextEntry::AutoComplete() deben derivar de esta clase e implementar su método virtual puro que devuelve los completados. Normalmente se utilizaría un completador personalizado cuando el número total de compleciones es demasiado grande para que el rendimiento sea aceptable si todas ellas necesitan ser devueltas a la vez, sino que pueden ser generadas jerárquicamente, es decir, inicialmente solo el primer componente, después el segundo una vez que el usuario termine de introducir el primero y así sucesivamente.
Cuando se hereda de esta clase es necesario implementar sus dos métodos virtuales puros. Esto permite devolver los resultados de forma incremental y puede ser conveniente o no dependiendo de donde vengan. Si se prefiere devolver todos los resultados a la vez, se debería heredar de wxTextCompleterSimple.
Funciones miembro
GetNext()
virtual wxString wxTextCompleter::GetNext()
Llamada para recuperar la siguiente finalización.
Todas las finalizaciones devueltas por esta función deben comenzar con el prefijo pasado a la última llamada a Start().
Hay que tener en cuenta que, al igual que Start(), este método se llama desde un contexto de hilo de trabajo bajo MSW.
Valor de retorno
La siguiente compleción o una cadena vacía para indicar que no hay más.
Funciones miembro
Start()
virtual bool wxTextCompleter::Start(const wxString & prefix)
Función llamada para iniciar la iteración sobre las terminaciones para el prefijo dado.
Esta función podría iniciar una consulta a una base de datos, por ejemplo, si los resultados se leen de una base de datos.
Hay que tener en cuenta que en algunas plataformas (actualmente solo MSW) se llama desde otro contexto de subproceso, por lo que debe utilizarse el mecanismo de sincronización adecuado para acceder a cualquier dato utilizado también por el subproceso principal de la interfaz de usuario.
Parámetros
- prefix
- Prefijo para el que se deben generar las terminaciones.
Valor de retorno
true para continuar con la llamada a GetNext() o false para indicar que no hay coincidencias y no se debe llamar a GetNext().