AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • filtros
  • Navegación filtrada
  • Habilitar/Deshabilitar un filtro
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Define y activa un filtro de tipo "Contiene" en un archivo de datos, vista o consulta. El filtro de tipo "Contiene" permite seleccionar todos los registros que contienen un conjunto específico de caracteres.
Este filtro no distingue entre mayúsculas y minúsculas.
Este filtro no utiliza ningún índice, navega por todo el archivo de datos.
Ejemplo
SearchKey is string = Customer.FilterContains(Comments, "VIP")
Customer.ReadFirst(SearchKey)
WHILE NOT Customer.Out()
Trace(Customer.CustomerName, Customer.City)
Customer.ReadNext(SearchKey)
END
// Disables the filter
Customer.DeactivateFilter()
Sintaxis
<Result> = <Source>.FilterContains(<Item> , <Value>)
<Result>: Cadena de caracteres
Campo de navegación. Corresponde a:
  • el nombre del elemento utilizado para el bucle de el archivo de datos si el filtro está activado,
  • una cadena vacía ("") si no se puede establecer el filtro.
<Source>: Tipo de fuente especificada
Nombre del archivo de datos HFSQL, vista o consulta utilizada.
<Item>: Cadena de caracteres
Nombre del elemento sobre el que se implementará el filtro. Esta posición puede ser una posición clave o no clave.
<Value>: Cadena de caracteres
El valor que se debe encontrar en el artículo de Record.
Observaciones

filtros

  • El filtro se activa desde el momento en el que se llama a la función <Fuente>.FilterContains.
  • Equivalente de sintaxis:
    FileName.FilterContains(ItemName, "Value")

    equivale a:
    FileName.Filter("ItemName ~]'Value'")

Navegación filtrada

Cuando se define y se activa un filtro en un archivo de datos, cualquier lectura de Record corresponde al filtro. Si no hay ninguna otra Record que corresponda al filtro durante la iteración:
  • La función <Fuente>.Out devuelve True.
  • la actual Record corresponde a la última Record leída con el filtro.
Por ejemplo:
En un archivo de datos filtrado, después de la función:el actual Record es:
<Fuente>.ReadFirstel primer archivo Record correspondiente al filtro.
<Fuente>.ReadLastel último archivo Record correspondiente al filtro.
<Fuente>.ReadNext (o <Fuente>.Forward)el siguiente Record (o el siguiente n-ésimo Record) correspondiente al filtro.
<Fuente>.ReadPrevious (o <Fuente>.Backward)el anterior Record (o el anterior n-ésimo Record) correspondiente al filtro.

Habilitar/Deshabilitar un filtro

  • <Fuente>.DeactivateFilter se utiliza para desactivar un filtro.
  • <Fuente>.ActivateFilter se utiliza para volver a habilitar un filtro.
  • El filtro se elimina cuando se cierra el archivo de datos (consulta o vista) (<Fuente>.Close o HOpenAnalysis, por ejemplo).
  • Un único filtro puede existir en un momento dado en un archivo de datos (consulta o vista). Si la función <Fuente>.FilterContains se utiliza varias veces, solo se tendrá en cuenta el último filtro: se borrarán los filtros anteriores. Del mismo modo, si se utilizan varios filtros (funciones HFilter*), sólo se tendrá en cuenta el último filtro.
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 25
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 20/06/2023

Señalar un error o enviar una sugerencia | Ayuda local