FocusControl 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供用于控制捕获设备上的焦点设置的功能。
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 FocusControlPublic NotInheritable Class FocusControl- 继承
- 属性
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 锁定，则解锁捕获设备的焦点。 |