FocusControl 类

定义

命名空间:

Windows.Media.Devices

提供用于控制捕获设备上的焦点设置的功能。

public ref class FocusControl sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class FocusControl final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class FocusControl

Public NotInheritable Class FocusControl

继承

Object Platform::Object IInspectable FocusControl

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

可以通过检查 FocusControl.Supported 来确定设备是否支持此控件。

如果设备不支持 FocusControl，你仍然可以使用 VideoCaptureDevice 上的 Focus 属性来设置焦点值。

可以通过 MediaCapture.VideoDeviceController 访问捕获设备的 FocusControl。

FocusControl 使应用可以进一步控制设备上的焦点设置。

可以通过调用 SetPresetAsync 来使用 FocusPreset 值之一。 或调用 SetValueAsync 以在 Min 和 Max 之间设置特定的值。

有关使用 FocusControl 的操作指南，请参阅 用于照片和视频捕获的手动相机控件。

属性

FocusChangedSupported	获取一个值，该值指定捕获设备是否支持 FocusChanged 事件。
FocusState	获取一个 MediaCaptureFocusState 值，该值指示捕获设备的当前焦点状态。
Max	获取最大焦点长度。
Min	获取最小焦点长度。
Mode	获取捕获设备的当前焦点模式。
Preset	获取焦点预设。
Step	获取捕获设备支持的最小焦点增量。
Supported	获取一个值，该值指定捕获设备是否支持焦点控件。
SupportedFocusDistances	获取一个值列表，这些值指示捕获设备支持的手动对焦距离。
SupportedFocusModes	获取一个值列表，这些值指示捕获设备支持的焦点模式。
SupportedFocusRanges	获取一个值列表，这些值指示捕获设备支持的自动对焦范围。
SupportedPresets	获取捕获设备支持的焦点预设。
Value	获取焦点设置为的当前值。
WaitForFocusSupported	获取一个值，该值指示捕获设备是否支持 WaitForFocus 。

方法

Configure(FocusSettings)	使用提供的 FocusSettings 对象中指定的值配置 FocusControl 对象。
FocusAsync()	异步聚焦设备。
LockAsync()	锁定捕获设备的焦点。
SetPresetAsync(FocusPreset)	异步设置焦点 预设。
SetPresetAsync(FocusPreset, Boolean)	异步设置焦点 预设，指定操作是否必须在设备聚焦之前完成。
SetValueAsync(UInt32)	异步设置焦点 值。
UnlockAsync()	如果捕获设备的焦点之前已通过调用 LockAsync 锁定，则解锁捕获设备的焦点。

另请参阅

• VideoDeviceController
• 用于照片和视频捕获的手动相机控件