Freigeben über

FocusControl Klasse

  • Referenz

Definition

Namespace:
Windows.Media.Devices
Bearbeiten

Bietet Funktionen zum Steuern der Fokuseinstellungen auf einem Erfassungsgerät.

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
Vererbung
Object Platform::Object IInspectable FocusControl
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Sie können herausfinden, ob ein Gerät dieses Steuerelement unterstützt, indem Sie FocusControl.Supported aktivieren.

Wenn das Gerät focusControl nicht unterstützt, können Sie weiterhin die Focus-Eigenschaft für videoCaptureDevice verwenden, um den Fokuswert festzulegen.

Sie können über MediaCapture.VideoDeviceController auf focusControl für das Erfassungsgerät zugreifen.

Das FocusControl gibt Apps zusätzliche Kontrolle über die Fokuseinstellungen auf einem Gerät.

Sie können einen der FocusPreset-Werte verwenden, indem Sie SetPresetAsync aufrufen. Oder rufen Sie SetValueAsync auf, um einen bestimmten Wert zwischen Min und Max festzulegen.

Anleitungen zur Verwendung von FocusControl finden Sie unter Manuelle Kamerasteuerelemente für Foto- und Videoaufnahmen.

Eigenschaften

FocusChangedSupported

Ruft einen Wert ab, der angibt, ob das Erfassungsgerät das FocusChanged-Ereignis unterstützt.
FocusState

Ruft einen MediaCaptureFocusState-Wert ab, der den aktuellen Fokuszustand des Erfassungsgeräts angibt.
Max

Ruft die maximale Fokuslänge ab.
Min

Ruft die minimale Fokuslänge ab.
Mode

Ruft den aktuellen Fokusmodus des Aufnahmegeräts ab.
Preset

Ruft die Fokusvoreinstellung ab.
Step

Ruft den kleinsten Fokusschritt ab, der vom Erfassungsgerät unterstützt wird.
Supported

Ruft einen Wert ab, der angibt, ob das Erfassungsgerät das Fokussteuerelement unterstützt.
SupportedFocusDistances

Ruft eine Liste von Werten ab, die die manuellen Fokusabstände angeben, die vom Erfassungsgerät unterstützt werden.
SupportedFocusModes

Ruft eine Liste von Werten ab, die die Fokusmodi angeben, die vom Erfassungsgerät unterstützt werden.
SupportedFocusRanges

Ruft eine Liste von Werten ab, die die automatischen Fokusbereiche angeben, die vom Erfassungsgerät unterstützt werden.
SupportedPresets

Ruft die Fokusvoreinstellungen ab, die vom Aufnahmegerät unterstützt werden.
Value

Ruft den aktuellen Wert ab, auf den der Fokus festgelegt ist.
WaitForFocusSupported

Ruft einen Wert ab, der angibt, ob WaitForFocus vom Erfassungsgerät unterstützt wird.

Methoden

Configure(FocusSettings)

Konfiguriert das FocusControl-Objekt mit Werten, die im angegebenen FocusSettings-Objekt angegeben sind.
FocusAsync()

Fokussiert das Gerät asynchron.
LockAsync()

Sperrt den Fokus des Erfassungsgeräts.
SetPresetAsync(FocusPreset)

Legt die Fokusvoreinstellung asynchron fest.
SetPresetAsync(FocusPreset, Boolean)

Legt die Fokusvoreinstellung asynchron fest, und gibt an, ob der Vorgang abgeschlossen werden muss, bevor das Gerät fokussiert wird.
SetValueAsync(UInt32)

Legt asynchron den Fokuswert fest.
UnlockAsync()

Entsperrt den Fokus des Aufnahmegeräts, wenn es zuvor mit einem LockAsync-Aufruf gesperrt wurde.

Gilt für:

Weitere Informationen