WINPUT_CONF(3W)
NAME
winput_conf − read/set configuration of window input channel
SYNOPSIS
#include <window.h>
int winput_conf(fd,param,value);
int fd;
int param,value;
DESCRIPTION
fd is an integer file descriptor for an opened graphics window type device interface.
param
the parameter to set or inquire.
value the value to set the desired parameter. If value is -1, then the parameter will only be inquired. Otherwise, the parameter will be set (enabled) or cleared (disabled) depending on whether value is 1 or 0, respectively. The value of the specified parameter is returned by winput_conf on a successful call, otherwise a -1 is returned.
DISCUSSION
This library call is supported by only the graphics window type. It sets or returns an input configuration parameter for a window. This routine should only be called in input mode 2.
The following parameters, defined in window.h, can be supplied as param:
K_TRACK
If set, report all locator moves. The default is cleared. Locator moves are reported only when the keyboard is connected to the window. Locator moves during an interactive size/move or window system pop-up menu are not reported. Moves will be reported relative to the current window virtual raster in pixel coordinates. Warning: enabling K_TRACK will cause window system performance to degrade.
K_LANGUAGE
Language nationality of the keyboard. The value parameter can be changed to a language supported on the current keyboard family. The default language is that of the keyboard attached. The supported values currently are:
K_I_USASCII ITF United States.
K_I_BELGIAN ITF Belgian.
K_I_CANENG ITF Canadian English.
K_I_DANISH ITF Danish.
K_I_DUTCH ITF Dutch.
K_I_FINNISH ITF Finnish.
K_I_FRENCH ITF French (AZERTY).
K_I_CANFRENCH ITF Canadian French.
K_I_SWISSFRENCH ITF Swiss French.
K_I_GERMAN ITF German.
K_I_SWISSGERMAN ITF Swiss German.
K_I_ITALIAN ITF Italian.
K_I_NORWEGIAN ITF Norwegian.
K_I_EUROSPANISH ITF European Spanish.
K_I_LATSPANISH ITF Latin Spanish.
K_I_SWEDISH ITF Swedish.
K_I_UNITEDK ITF United Kingdom.
K_I_KATAKANA ITF Katakana.
K_I_SWISSFRENCH2 ITF Swiss French II.
K_I_SWISSGERMAN2 ITF Swiss German II.
K_I_KANJI ITF Kanji.
K_CAPSMODE
CAPS Key. If set (the default) then characters will automatically be converted to upper case when the CAPS key is pressed. If cleared, disable handling of CAPS. (In any case, pressing the CAPS key will cause a key code to be sent.)
K_EXTEND
Alternate Keyboards. For some languages, the EXTEND key can be used to toggle between normal and alternate keyboards; for other languages, the EXTEND key is a modifier to get additional codes. This parameter controls whether the EXTEND key will perform the language dependent function. If set (the default) then the language dependent function will be enabled. If cleared, the function will be disabled.
K_CONTROL
Control Collapsing of Printables. If set (the default for wgskbd(3W) mode 0), then the control key will cause characters from 64 to 127 decimal to be collapsed to their control values before being received. If cleared (the default for wgskbd(3W) mode 1 or 2) then collapsing will be disabled. (In any case, pressing the CONTROL key will cause the control bit to be set when the associated key code is sent.)
K_SHIFT
Shift Collapsing of Capitals. If set (the default), then the shift key will cause keys subject to the CAPS key to have their case inverted before being received. If cleared, this inversion is disabled. (In any case, pressing the SHIFT key will cause the shift bit to be set when the associated key code is sent.)
K_META
Enable META Modifiers. If set (the default), the presence of meta keys will be recognized by setting the appropriate meta bits when key codes are sent. A zero parameter will disable this capability.
K_META_EXTEND
Enable Left-EXTEND as META Modifier. This is effective only when K_META is set. If this parameter is set (the default for wgskbd(3W) mode 1 or 2), the left-EXTEND key will become the meta key. For the Katakana keyboard it will also switch the keyboard to the ROMAN keyboard at the same time. If cleared (the default for wgskbd(3W) mode 0), the left-EXTEND key is simply treated as an EXTEND key. (In any case, pressing the left-EXTEND key will cause a key code to be sent.)
K_CAPSLOCK
CAPS Mode State. Set means locked; cleared (the default) means not locked.
K_KANAKBD
Katakana Keyboard. If set, means that the alternate Katakana keyboard is currently active. If cleared (the default), means it is not in effect. This bit is only meaningful for a Katakana language keyboard.
K_KANJI
Enable KANJI mode. This parameter is effective only when the keyboard language is K_META_EXTEND. If this parameter is set, the left extend key is used to toggle the state of K_KANJIKBD. If cleared (the default), means it is not in effect.
K_KANJIKBD
Kanji input mode. If set, left meta key will be used as a key only. If cleared (the default), the left meta key will be used as a meta key.
HARDWARE DEPENDENCIES
Series 500:
Graphics window input routines (winput_∗) are not supported on Series 500; they only work on Series 300.
SEE ALSO
DIAGNOSTICS
A return of -1 indicates failure; otherwise the current value of the specified parameter is returned. See errno(2) for more information.
Hewlett-Packard Company — May 11, 2021