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
• 写真とビデオのキャプチャのための手動カメラ制御