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 の呼び出しでロックされている場合は、キャプチャ デバイスのフォーカスのロックを解除します。

適用対象

こちらもご覧ください