Functions and Directives Functions and Directives

Function _conSetCurrentField() Foundation

Assign the value of a container to a field variable of the current workarea.

Syntax
XPPAPIRET _conSetCurrentField(CHAR *field,
                              ContainerHandle chValue);
Parameters
CHAR* field
The character pointer field contains the name of the Xbase++ field variable.
ContainerHandle chValue
The handle of a container that holds the value that is to be assigned to the field variable.
Return

This function returns NULL if no error occured, otherwise it returns an error code (XPP_ERR_...).

Description

The function _conSetCurrentField() is used to assign a new value to a field variable of the current workarea.

Examples
#include <windows.h> 

#include "xppdef.h" 
#include "xpppar.h" 
#include "xppcon.h" 

XPPRET XPPENTRY MyCAPIFunction(XppParamList paramList) 
{ 
ContainerHandle chName  = _conGetCurrentField( "NAME",  NULLCONTAINER ); 
ContainerHandle chPhone = _conGetCurrentField( "PHONE", NULLCONTAINER ); 

/* Now swap name and phone number... */ 

if(_conSetCurrentField( "NAME", chPhone )) 
{ 
   /* Error handler... */ 
} 

if(_conSetCurrentField( "PHONE", chName )) 
{ 
   /* Error handler... */ 
} 
} 


/* Xbase++ code */ 
PROCEDURE Main 
LOCAL aStruct := { { "NAME",  "C", 30, 0 }, ; 
                   { "PHONE", "C", 30, 0 }  } 
CLS 

DbCreate( "PHONELIST", aStruct ) 

USE PHONELIST NEW EXCLUSIVE 

APPEND BLANK 
PHONELIST->NAME  := "XENIA B." 
PHONELIST->PHONE := "+49 6196 9572-0" 

? "NAME :", PHONELIST->NAME 
? "PHONE:", PHONELIST->PHONE 

MyCAPIFunction() 

? "NAME :", PHONELIST->NAME 
? "PHONE:", PHONELIST->PHONE 

CLOSE DATABASES 
RETURN
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.