OraFormsPopListActivate Function

Action

OraFormsPopListActivate is used to send an activate message for an element in a pop-up list box control. A control is identified by a unique name or ID.

Include file

OraForms.bdh

Syntax

OraFormsPopListActivate( in sName     :  string,
                         in sLabel    :  string,
                         in nIndex    :  number optional,
                         in nPosition :  number optional ) : boolean;

Return value

true if successful
false otherwise

Parameter	Description
sName	The control's unique ID.
sLabel	If not NULL - The element with the defined label (textual representation) will be activated. If you pass NULL, you have to define the index of the item that should be activated in the next parameter.
nIndex	If sLabel is NULL - This parameter defines the index of the element that should be activated. The index of the first element is 0.
nPosition	If the control contains multiple entries with the same label, this parameter will be used to specify the nth position. The default value is 0.

Example

transaction TMain 
  var 
    sValue :  string; 
  begin 
    OraFormsSetConnectMode(ORA_SOCKET_CONNECTION); 
    // Connect - with connection properties 
    OraFormsSetInt( "INITIAL_VERSION", 608); 
    OraFormsSetPoint( "INITIAL_RESOLUTION",  96,  96); 
    OraFormsSetPoint( "INITIAL_DISP_SIZE", 1024,  768); 
    OraFormsSetInt( "INITIAL_COLOR_DEPTH", 256); 
    OraFormsSetString( "FONT_NAME" , "Dialog" ); 
    OraFormsSetPoint( "INITIAL_SCALE_INFO",  8,  18); 
    OraFormsSetBoolean( "WINSYS_REQUIREDVA_LIST",  false); 
    OraFormsConnect( "server module=Person3.fmx userid= useSDI=yes record=names"); 
    // New window activated: Logon 
    OraFormsSetWindow( "Logon"); 
    OraFormsLogon( "user",  "password",  "orcl_server"); 
    // --- 
    // New window activated: WINDOW1 
    OraFormsSetWindow( "WINDOW1"); 
    OraFormsSetFocus( "PERSON_GENDER"); 
    OraFormsPopListActivate( "PERSON_GENDER",  "Male",  0); 
    OraFormsPopListClose( "PERSON_GENDER"); 
    OraFormsMenuItem( "WINDOW1",  "Action::Exit"); 
  end TMain;