System.Devices.TDeviceInfo.SelectDevices

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

class function SelectDevices(ADeviceClass: TDeviceClass; const APhysicalScreenSize, ALogicalScreenSize: TSize;
APlatform: TOSVersion.TPlatform; APixelsPerInch: Integer; SetThisDevice: Boolean = True): TArray<TDeviceInfo>;

C++

__classmethod System::DynamicArray<TDeviceInfo*> __fastcall SelectDevices(TDeviceClass ADeviceClass, const System::Types::TSize &APhysicalScreenSize, const System::Types::TSize &ALogicalScreenSize, System::Sysutils::TOSVersion::TPlatform APlatform, int APixelsPerInch, bool SetThisDevice = true);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Devices.pas
System.Devices.hpp
System.Devices TDeviceInfo


Description

Renvoie un tableau avec les périphériques existants qui correspondent aux propriétés de périphériques spécifiées, triés afin de placer en premier les meilleurs résultats.

SelectDevices reçoit les paramètres suivants :

  • ADeviceClass est la classe de périphérique souhaitée.
  • APhysicalScreenSize indique les largeur et hauteur souhaitées de l'écran physique du périphérique, en pixels.
  • ALogicalScreenSize indique la largeur et la hauteur de l'écran logique du périphérique, en pixels, afin de trouver ou de créer une instance de TDeviceInfo et d'en faire le périphérique en cours si SetThisDevice vaut True. La taille d'écran logique spécifiée n'affecte pas le tableau renvoyé des périphériques existants.
  • APlatform est la plate-forme souhaitée.
  • APixelsPerInch représente le nombre de pixels de taille d'écran qui représente un pouce dans la taille d'écran physique spécifiée.
  • Si SetThisDevice vaut True, SelectDevices change le périphérique en cours, soit en un périphérique existant correspondant aux données spécifiées, soit en un nouveau périphérique qui contient les données spécifiées et une chaîne vide en tant que ID. Si SetThisDevice vaut False, SelectDevices définit le périphérique en cours sur nil.

SelectDevices utilise les valeurs spécifiées pour APhysicalScreenSize et APixelsPerInch afin de calculer la taille en pouces de la diagonale de l'écran physique spécifié.

Le tableau résultant contient les périphériques existants suivants, dans l'ordre suivant :

  1. Le périphérique avec la plate-forme et la classe de périphérique spécifiées ayant la diagonale d'écran physique la plus proche et une diagonale d'écran physique maximale inférieure ou égale à la diagonale d'écran physique spécifiée, si un tel périphérique existe.
  2. Le périphérique non-exclusif de chacune des classes de périphériques spécifiées ayant la plate-forme spécifiée et la diagonale d'écran physique la plus proche et une diagonale d'écran physique maximale inférieure ou égale à la diagonale d'écran physique spécifiée, si un tel périphérique existe.
  3. Tous les autres périphériques non-exclusifs avec la plate-forme spécifiée, triés par proximité de la diagonale de leur écran physique avec la diagonale d'écran physique spécifiée.

Voir aussi