System.Devices.TDeviceInfo.SelectDevices

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Devices.pas
System.Devices.hpp
System.Devices TDeviceInfo


Beschreibung

Gibt ein Array mit den vorhandenen Geräten zurück, die mit den angegebenen Geräteeigenschaften übereinstimmen und sortiert sind, damit die größere Übereinstimmung Präferenz hat.

SelectDevices erhält die folgenden Parameter:

  • ADeviceClass ist die gewünschte Geräteklasse.
  • APhysicalScreenSize gibt die gewünschte Breite und Höhe des physikalischen Gerätebildschirms in Pixel an.
  • ALogicalScreenSize gibt die Breite und Höhe des logischen Gerätebildschirms in Pixel an, um eine Instanz von TDeviceInfo zu suchen oder zu erstellen, und sie zum aktuellen Gerät zu machen, wenn SetThisDevice True ist. Die angegebene logische Bildschirmgröße betrifft nicht das zurückgegebene Array der vorhandenen Geräte.
  • APlatform ist die gewünschte Plattform.
  • APixelsPerInch ist die Anzahl der Pixel der Bildschirmgröße, die ein Zoll in der angegebenen physikalischen Bildschirmgröße repräsentiert.
  • Wenn SetThisDevice True ist, ändert SelectDevices das aktuelle Gerät entweder zu einem vorhandenen Gerät, das mit den angegebenen Daten übereinstimmt oder zu einem neuen Gerät, das die angegebenen Daten und einen leeren String als ID enthält. Wenn SetThisDevice False ist, macht SelectDevices das aktuelle Gerät zu nil.

SelectDevices verwendet die Werte, die für APhysicalScreenSize und APixelsPerInch angegeben sind, um die angegebene physikalische Bildschirmdiagonale in Zoll zu berechnen.

Das resultierende Array enthält die folgenden vorhandenen Geräte in der folgenden Reihenfolge:

  1. Das Gerät mit der angegebenen Plattform und Geräteklassen mit der nächsten physikalischen Bildschirmdiagonale und einer maximalen physikalischen Bildschirmdiagonale, die mit der angegebenen physikalischen Bildschirmdiagonale übereinstimmt oder kleiner ist, falls so ein Gerät vorhanden ist.
  2. Das nicht exklusive Gerät von jeden verbleibenden Geräteklassen mit der angegebene Plattform und der nächsten physikalischen Bildschirmdiagonale und der maximalen physikalischen Bildschirmdiagonale, die mit der angegebenen physikalischen Bildschirmdiagonale übereinstimmt oder kleiner ist, falls so ein Gerät vorhanden ist.
  3. Alle anderen nicht exklusiven Geräte mit der angegebenen Plattform, sortiert nach der Nähe der physikalischen Bildschirmdiagonale zur angegebenen physikalischen Bildschirmdiagonale.

Siehe auch