Set the value of the specified session property of type integer
Synopsis:
#include <screen/screen.h>
int screen_set_session_property_iv(screen_session_t ssn,
int pname,
const int *param)
Arguments:
- ssn
- The handle of the session 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.
- param
- A pointer to a buffer containing the new value(s). This buffer must be of type int. param may be a single integer or an array of integers depending on the property being set.
Library:
libscreen
Description:
Function Type: Delayed Execution
This function sets the value of a session property from a user-provided buffer. You can use this function to set the value of the following properties:
- SCREEN_PROPERTY_ACCELERATION (for SCREEN_EVENT_GAMEPAD, SCREEN_EVENT_JOG, and SCREEN_EVENT_JOYSTICK only)
- SCREEN_PROPERTY_CURSOR
- SCREEN_PROPERTY_GESTURE_PARAMETERS (for SCREEN_EVENT_GAMEPAD, SCREEN_EVENT_JOG, and SCREEN_EVENT_JOYSTICK only)
- SCREEN_PROPERTY_MODE (for SCREEN_EVENT_GAMEPAD, SCREEN_EVENT_JOG, SCREEN_EVENT_JOYSTICK, and SCREEN_EVENT_MTOUCH_TOUCH only)
- SCREEN_PROPERTY_PERMISSIONS
- SCREEN_PROPERTY_POSITION
- SCREEN_PROPERTY_PROTECTION_ENABLE (application-specific usage, not used by Screen)
- SCREEN_PROPERTY_SCALE_FACTOR
- SCREEN_PROPERTY_SENSITIVITY
- SCREEN_PROPERTY_SIZE
- SCREEN_PROPERTY_SPEED (for SCREEN_EVENT_GAMEPAD, SCREEN_EVENT_JOG, and SCREEN_EVENT_JOYSTICK only)
- SCREEN_PROPERTY_VISIBLE
- SCREEN_PROPERTY_ZORDER
Returns:
0 if successful, or -1 if an error occurred (errno is set; refer to errno.h for more details).