Command PV Get picture property

PV Get picture property

version 6.8

---

PV Get picture property (area; picNum; property) Longint

Parameter	Type		Description
area	Longint		4D View area
picNum	Longint		Picture number
property	Longint		Property number

Function result Longint Property value

Description

The PV Get picture property command returns the value of property for the picture of area set by picNum.

The PV Picture properties constants are used to define the properties.

You can also use the PV Picture mapping mode theme to compare the returned value, once you pass the pv picture mapping mode value in the property parameter.

Example

This method displays information relating to picture number 1.

   C_INTEGER($Index)  `Loop index for properties arrays
   C_LONGINT($Value)  `Value corresponding to the option
   ARRAY STRING($PropertiesCodes;12)  `Properties codes
   ARRAY STRING(80;$PropertiesLabels;12)  `Properties labels

            `Initialize properties arrays
      $PropertiesCodes{1}:=pv picture column
      $PropertiesLabels{1}:="Reference column"
      $PropertiesCodes{2}:=pv picture row
      $PropertiesLabels{2}:="Reference row"
      $PropertiesCodes{3}:=pv picture horz offset
      $PropertiesLabels{3}:="Décalage H"
      $PropertiesCodes{4}:=pv picture vert offset
      $PropertiesLabels{4}:="V offset"
      $PropertiesCodes{5}:=pv picture data width
      $PropertiesLabels{5}:="Real width"
      $PropertiesCodes{6}:=pv picture data height
      $PropertiesLabels{6}:="Real height"
      $PropertiesCodes{7}:=pv picture display width
      $PropertiesLabels{7}:="Display width"
      $PropertiesCodes{8}:=pv picture display height
      $PropertiesLabels{8}:="Display height"
      $PropertiesCodes{9}:=pv picture background
      $PropertiesLabels{9}:="Background"
      $PropertiesCodes{10}:=pv picture mapping mode 
      $PropertiesLabels{10}:="Mapping"
      $PropertiesCodes{11}:=pv picture fixed size 
      $PropertiesLabels{11}:="Sixed size"
      $PropertiesCodes{12}:=pv picture locked 
      $PropertiesLabels{12}:="Locked"

      $PictureInfo:="Picture number 1 information:"+Character(Carriage return)
      For ($Index;1;12)  `Review the different properties
         $Value:=PV Get picture property (Area;1;$PropertiesCodes{$Index})  `Read property
         $PictureInfo:=$PictureInfo+$PropertiesLabels{$Index}+" : "+String($Value)+". "  `Update info
      End for

      ALERT($PictureInfo)  `Display info

See Also

PV SET PICTURE PROPERTY.

Constants

PV Picture properties and PV Picture mapping mode themes.