AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
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 = HFilterContains(Customer, Comment, "VIP")
HReadFirst(Customer, SearchKey)
WHILE NOT HOut()
Trace(Customer.CustomerName, Customer.City)
HReadNext(Customer, SearchKey)
END
// Disables the filter
HDeactivateFilter(Customer)
Sintaxis
<Result> = HFilterContains(<Data file> , <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.
<Data file>: Cadena de caracteres
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 HFilterContiene.
  • Equivalente de sintaxis:
    HFilterContains(FileName, ItemName, "Value")

    equivale a:
    HFilter(FileName, "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 HOut 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:
HReadFirstel primer archivo Record correspondiente al filtro.
HReadLastel último archivo Record correspondiente al filtro.
HReadNext (o HForward)el siguiente Record (o el siguiente n-ésimo Record) correspondiente al filtro.
HReadPrevious (o HBackward)el anterior Record (o el anterior n-ésimo Record) correspondiente al filtro.

Habilitar/Deshabilitar un filtro

  • HDeactivateFilter se utiliza para desactivar un filtro.
  • HActivateFilter se utiliza para volver a habilitar un filtro.
  • El filtro se elimina cuando se cierra el archivo de datos (consulta o vista) (HClose 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 HFilterContiene 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 17
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 06/07/2023

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