screen_set_event_property_cv()

Set the value of the specified event property of type char.

Synopsis:

#include <screen/screen.h>
 
int screen_set_event_property_cv(screen_event_t ev, int pname, int len, const char *param)

Arguments:

ev

The handle of the event whose property is being set.

pname

The name of the property whose value is being set. The properties that you can set are of type Screen property types.

len

The maximum number of bytes that can be read from param.

param

A pointer to a buffer containing the new value(s). This buffer must be an array of type char with a maximum length of len.

Library:

libscreen

Description:

Function Type: Immediate Execution

This function sets the value of an event property from a user-provided buffer. No more than len bytes of the specified type will be written. The list of properties that can be set per event type are listed as follows:

Returns:

0 if the value(s) of the property was set to new value(s), or -1 if an error occurred (errno is set).