Partager via


FocusControl Classe

Définition

Fournit des fonctionnalités pour contrôler les paramètres de focus sur un appareil de capture.

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
Héritage
Object Platform::Object IInspectable FocusControl
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Pour savoir si un appareil prend en charge ce contrôle, consultez FocusControl.Supported.

Si l’appareil ne prend pas en charge le FocusControl, vous pouvez toujours utiliser la propriété Focus sur videoCaptureDevice pour définir la valeur du focus.

Vous pouvez accéder au FocusControl pour l’appareil de capture via MediaCapture.VideoDeviceController.

FocusControl donne aux applications un contrôle supplémentaire sur les paramètres de focus sur un appareil.

Vous pouvez utiliser l’une des valeurs FocusPreset en appelant SetPresetAsync. Ou appelez SetValueAsync pour définir une valeur spécifique entre min et max.

Pour obtenir des conseils pratiques sur l’utilisation de FocusControl, consultez Contrôles d’appareil photo manuels pour la capture photo et vidéo.

Propriétés

FocusChangedSupported

Obtient une valeur qui spécifie si l’appareil de capture prend en charge l’événement FocusChanged .

FocusState

Obtient une valeur MediaCaptureFocusState indiquant l’état de focus actuel de l’appareil de capture.

Max

Obtient la longueur maximale du focus.

Min

Obtient la longueur minimale du focus.

Mode

Obtient le mode focus actuel de l’appareil de capture.

Preset

Obtient la présélection du focus.

Step

Obtient le plus petit incrément de focus pris en charge par l’appareil de capture.

Supported

Obtient une valeur qui spécifie si l’appareil de capture prend en charge le contrôle focus.

SupportedFocusDistances

Obtient une liste de valeurs indiquant les distances de focus manuelles prises en charge par l’appareil de capture.

SupportedFocusModes

Obtient une liste de valeurs indiquant les modes de focus pris en charge par l’appareil de capture.

SupportedFocusRanges

Obtient une liste de valeurs indiquant les plages de focus automatique prises en charge par l’appareil de capture.

SupportedPresets

Obtient les présélections de focus prises en charge par l’appareil de capture.

Value

Obtient la valeur actuelle sur laquelle le focus est défini.

WaitForFocusSupported

Obtient une valeur qui indique si WaitForFocus est pris en charge par l’appareil de capture.

Méthodes

Configure(FocusSettings)

Configure l’objet FocusControl avec les valeurs spécifiées dans l’objet FocusSettings fourni.

FocusAsync()

Concentre de manière asynchrone l’appareil.

LockAsync()

Verrouille le focus de l’appareil de capture.

SetPresetAsync(FocusPreset)

Définit de manière asynchrone la présélection du focus.

SetPresetAsync(FocusPreset, Boolean)

Définit de manière asynchrone la présélection du focus, en spécifiant si l’opération doit se terminer avant que l’appareil soit concentré.

SetValueAsync(UInt32)

Définit de manière asynchrone la valeur du focus.

UnlockAsync()

Déverrouille le focus de l’appareil de capture s’il a déjà été verrouillé avec un appel à LockAsync.

S’applique à

Voir aussi