Click above to get retro games delivered to your door ever month!

  m6_SetAreaFilter():

  Purpose:  Provides a way to SET FILTER TO a Roll-Your-Own filter.

   Syntax:  m6_SetAreaFilter( <nHandle> )

    Where:  <nHandle>   --  Is a valid handle to a RYO filter.

  Returns:  Logical value:  .T. means the operation was successful,  .F.
            indicates it failed.  In the case of a .F. value call m6_Error()
            to retrieve the reason for the error.

     Note:  You may only set the area filter to a filter that you own.
            By default any RYO filter you create will be owned by your
            program.  However, once you set the filter via m6_SetAreaFilter()
            ownership is transferred to the system and the filter will
            freed by the system.
  Example:

         #include "SIXCDX.CH"
         #include "MACHSIX.CH"

         USE Customer via "SIXCDX"

         SET INDEX TO State

         //..........................................create a RYO filter
         nHandle := m6_NewFilter()

         //...........................................Add records 10, 5
         ? m6_AddRec( nHandle, 10  )  //  .T.
         ? m6_AddRec( nHandle,  5  )  //  .T.
         ? m6_AddRec( nHandle, 101 )  //  .F.

         //..................................SET FILTER TO my RYO filter
         m6_SetAreaFilter( nHandle )

         //..........Browse data.  Only records 5 and 10 will be visible
         browse()

         // Attempt to free filter. Note that the function returns false
         // because the filter is now owned by the system.
         ? m6_FreeFilter( nHandle )            //  .F.