FocusControl Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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. |