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來設定最小值與最大值之間的特定值。

如需使用 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)	以非同步方式設定焦點 Preset。
SetPresetAsync(FocusPreset, Boolean)	以非同步方式設定焦點 Preset，指定作業是否必須完成，才能將裝置設為焦點。
SetValueAsync(UInt32)	以非同步方式設定焦點 值。
UnlockAsync()	如果先前已鎖定擷取裝置的焦點，並呼叫 LockAsync，則會解除鎖定該擷取裝置的焦點。

另請參閱

• VideoDeviceController
• 相片和視訊擷取的手動相機控制項