screen_set_buffer_property_cv()

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

Synopsis:

#include <screen/screen.h>
 
int screen_set_buffer_property_cv(screen_buffer_t buf,
                                  int pname,
                                  int len,
                                  const char *param)

Since:

BlackBerry 10.0.0

Arguments:

buf

The handle of the buffer 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 (For the qcc command, use the -l screen option to link against this library)

Description:

Function Type: Immediate Execution

This function sets the value of a buffer property from a user-provided buffer. The buffer must have been created with the function screen_create_buffer().

Currently there are no buffer properties that can be set using this function.

Returns:

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