screen_set_display_property_cv()

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

Synopsis:

#include <screen/screen.h>
 
int screen_set_display_property_cv(screen_display_t disp,
                                   int pname,
                                   int len,
                                   const char *param)

Arguments:

disp

The handle of the display whose property is to be 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: Delayed Execution

This function sets the value of a display property from a user-provided buffer. No more than len bytes will be read from param.

Currently there are no display properties that can be queried using this function.

Returns:

0 if the command to set the new property value(s) was queued, or -1 if an error occurred (errno is set; refer to /usr/include/errno.h for more details).