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
• 사진 및 비디오 캡처를 위한 수동 카메라 컨트롤