screen_get_window_property_cv()

Graphics and Screen4.0 (8.x)Screen Graphics Subsystem Developer's GuideAPIProgrammingUtilities

Retrieve the current value of the specified window property of type char

Synopsis:

#include <screen/screen.h>
int screen_get_window_property_cv(screen_window_t win,
                                  int pname,
                                  int len,
                                  char *param)

Arguments:

win
The handle of the window whose property is being queried.
pname
The name of the property whose value is being queried. The properties available for querying are of type Screen property types.
len
The maximum number of bytes that Screen can write to param.
param
The buffer where Screen stores the retrieved value (a character array that includes a terminating null character). This buffer must be an array of type char with a minimum length of len. If this user-provided buffer has insufficient space for storing the property being retrieved, Screen truncates the retrieved value and returns the character array without a terminating null character.

Library:

libscreen

Description:

Function Type: Flushing Execution

This function retrieves the value of a window property and stores them in a user-provided buffer. The values of the following properties can be queried using this function:

Returns:

0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).

Page updated: