Function _conSetFieldCC() | Xbase++

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

XPPAPIRET _conSetFieldCC(CHAR *warea,
                         CHAR *field,
                         ContainerHandle chValue);

CHAR* warea

The character pointer warea contains the alias name of a workarea.

CHAR* field

The character pointer field contains the name of the Xbase++ field variable.

ContainerHandle chValue

The handle of the container whose value is to be assigned to the specified field variable.

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

This function us used to assign a new value to specific field variable of a certain workarea.

#include <windows.h> 

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

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

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

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

   if(_conSetFieldCC( "PHONELIST", "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

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.

Function _conSetFieldCC() Foundation