Functions and Directives Functions and Directives

Function _conSetFieldNC() Foundation

Assign a new value to a specific field variable of a certain workarea.

Syntax
XPPAPIRET _conSetFieldNC(int warea,
                         CHAR *field,
                         ContainerHandle chValue);
Parameters
int warea
The integer variable warea contains the numeric identifier of the workarea.
CHAR* field
The character pointer field contains the name of the Xbase++ field variable.
ContainerHandle chValue
A handle to the container that contains the new value of the field variable.
Return

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

Description

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

Examples
#include <windows.h> 

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

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

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

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

if(_conSetFieldNC( 1, "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.