====== QBFINIT event  ======


 
==== Description ====
 
Initialize the QBF mode.  Oi will clear the window so that the user can enter their Query.  Override this event if you want to execute your own form to build a query.  


 
==== Syntax ====
 
//bforward// = **QBFINIT**(//ctrlentID//, //ctrlclassID//)
 
==== Parameters ====
 
QBFINIT accepts arguments for the following parameters.

^Parameter^Description^
|//CtrlentID//|Has the format //WindowName//.//ControlName//, where //WindowName// is the identifier of the window that contains the affected control, and //ControlName// is the identifier of that control. Notice that a period separates the two values.|
|//CtrlclassID//|The type of control. Window control is the only valid entry.|


 
==== Returns ====
 
True or false. If false, then program execution returns to the calling procedure. If true, then event processing goes to the next level.
 
==== See Also ====
 
[[qbfstatus|QBFSTATUS property]]
[[qbflist|QBFLIST property]]
[[[guides:programming:programmers_reference_manual:qbfrun_event|QBFRUN event]]
[[[guides:programming:programmers_reference_manual:qbftable_event|QBFTABLE event]]
 
==== Remarks ====
 
When using the QBFList property to initialize the QBF mode, the QBFINIT event is should not be sent.  If the QBFINIT event is set prior to the QBFLIST property being sent, disabled fields will become enabled.
 

==== Example ====

Use a quick event to call a custom program to supply a custom query builder interface.

{{:programming:programmers_reference_manual:qbf_init_quickevent.png?400|}}


<code>
* Use a custom window to prompt user for criteria, return a list of keys, set the QBFLIST property
* This will perform the function of the QBFInit and QBFRun events/
 
list = Dialog_Box("BOOKS_QUERY", atWindow, "")
if list ne "" then
  call set_Property(atWindow, "QBFLIST", list)
end
</code>