CoreIndependentInputSourceController.SetControlledInput Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| SetControlledInput(CoreInputDeviceTypes) |
Identifies the CoreInputDeviceTypes that should be delivered to the input source associated with the CoreIndependentInputSourceController. |
| SetControlledInput(CoreInputDeviceTypes, CoreIndependentInputFilters, CoreIndependentInputFilters) |
Identifies the CoreInputDeviceTypes that should be delivered to the input source associated with the CoreIndependentInputSourceController, based on the specified filters. |
SetControlledInput(CoreInputDeviceTypes)
Identifies the CoreInputDeviceTypes that should be delivered to the input source associated with the CoreIndependentInputSourceController.
public:
virtual void SetControlledInput(CoreInputDeviceTypes inputTypes) = SetControlledInput;/// [Windows.Foundation.Metadata.Overload("SetControlledInput")]
void SetControlledInput(CoreInputDeviceTypes const& inputTypes);[Windows.Foundation.Metadata.Overload("SetControlledInput")]
public void SetControlledInput(CoreInputDeviceTypes inputTypes);function setControlledInput(inputTypes)Public Sub SetControlledInput (inputTypes As CoreInputDeviceTypes)Parameters
- inputTypes
- CoreInputDeviceTypes
The supported input device types.
- Attributes
See also
Applies to
SetControlledInput(CoreInputDeviceTypes, CoreIndependentInputFilters, CoreIndependentInputFilters)
Identifies the CoreInputDeviceTypes that should be delivered to the input source associated with the CoreIndependentInputSourceController, based on the specified filters.
public:
virtual void SetControlledInput(CoreInputDeviceTypes inputTypes, CoreIndependentInputFilters required, CoreIndependentInputFilters excluded) = SetControlledInput;/// [Windows.Foundation.Metadata.Overload("SetControlledInputWithFilters")]
void SetControlledInput(CoreInputDeviceTypes const& inputTypes, CoreIndependentInputFilters const& required, CoreIndependentInputFilters const& excluded);[Windows.Foundation.Metadata.Overload("SetControlledInputWithFilters")]
public void SetControlledInput(CoreInputDeviceTypes inputTypes, CoreIndependentInputFilters required, CoreIndependentInputFilters excluded);function setControlledInput(inputTypes, required, excluded)Public Sub SetControlledInput (inputTypes As CoreInputDeviceTypes, required As CoreIndependentInputFilters, excluded As CoreIndependentInputFilters)Parameters
- inputTypes
- CoreInputDeviceTypes
The supported input device types.
- required
- CoreIndependentInputFilters
The required filtering criteria for certain input device types.
- excluded
- CoreIndependentInputFilters
The filtering criteria for certain input device types to exclude.
- Attributes
Remarks
If any filtering criteria are specified, the corresponding input device type must be specified in the inputTypes parameter.
Pen-related filtering criteria are only supported in the excluded parameter.
The filtering criteria are considered by the system when input is hit tested to determine where it should be routed. In some scenarios, hit testing results in input capture, where subsequent input is delivered to the same target without its own hit test. In these scenarios, the filtering criteria are not considered, as the input destination has already been determined.
For example, if CoreIndependentInputFilters.MouseButton: 1 is set, then the input source will also receive subsequent mouse motion input until the mouse buttons are released (mouse motion while a mouse button is held is captured to the destination of the mouse button).