Impact Acquire SDK .NET
Public Member Functions | Static Public Member Functions | Properties | List of all members
PropertyF Class Reference
Common

Provided for convenience only. This type represents a standard float property type. More...

Inheritance diagram for PropertyF:
[legend]

Public Member Functions

EnumPropertyF< T > getTranslationDict (List< KeyValuePair< String, T > > sequence)
 This function queries the property's translation table.
 
String getTranslationDictString ()
 This function reads a single translation table string entry from a property.
 
String getTranslationDictString (int index)
 This function reads a single translation table string entry from a property.
 
EnumPropertyF< T > getTranslationDictStrings (List< String > sequence)
 This function queries a list of valid strings for this property.
 
T getTranslationDictValue ()
 This function reads a single translation table value entry from a property.
 
T getTranslationDictValue (int index)
 This function reads a single translation table value entry from a property.
 
EnumPropertyF< T > getTranslationDictValues (List< T > sequence)
 This function queries a list of valid values for this property.
 
 PropertyF ()
 Constructs a new unbound mv.impact.acquire.PropertyF object.
 
 PropertyF (int hProp)
 Constructs a new mv.impact.acquire.PropertyF object.
 
T read ()
 Reads a value from a property.
 
T read (int index)
 Reads a value from a property.
 
double[] read (int start, int end)
 Reads a set of values from a property.
 
void read (List< T > sequence)
 Reads a set of values from a property.
 
void read (List< T > sequence, int start)
 Reads a set of values from a property.
 
void read (List< T > sequence, int start, int end)
 Reads a set of values from a property.
 
EnumPropertyF< T > write (double[] values)
 Writes a set of values to the property.
 
EnumPropertyF< T > write (double[] values, int start)
 Writes a set of values to the property.
 
EnumPropertyF< T > write (List< T > sequence)
 Writes a set of values to the property.
 
EnumPropertyF< T > write (List< T > sequence, int start)
 Writes a set of values to the property.
 
EnumPropertyF< T > write (T value)
 Writes one value to the property.
 
EnumPropertyF< T > write (T value, int index)
 Writes one value to the property.
 

Static Public Member Functions

static implicit operator T (EnumPropertyF< T > prop)
 Allows a direct cast of the property object to its underlying value type.
 
static double operator+ (PropertyF a, PropertyF b)
 Adds the values stored at index 0 of 2 float properties and returns the result.
 

Properties

ReadOnlyCollection< String > listOfValidStrings [get]
 Returns a list of valid strings for this property.
 
ReadOnlyCollection< T > listOfValidValues [get]
 Returns a list of valid values for this property.
 
T maxValue [get]
 Reads the maximum value from a property.
 
T minValue [get]
 Reads the minimum value from a property.
 
T stepWidth [get]
 Reads the step width from a property.
 

Detailed Description

Provided for convenience only. This type represents a standard float property type.

Constructor & Destructor Documentation

◆ PropertyF() [1/2]

PropertyF ( int hProp)
inline

Constructs a new mv.impact.acquire.PropertyF object.

Parameters
[in]hPropA valid handle to a float property.

◆ PropertyF() [2/2]

PropertyF ( )
inline

Constructs a new unbound mv.impact.acquire.PropertyF object.

Member Function Documentation

◆ getTranslationDict()

EnumPropertyF< T > getTranslationDict ( List< KeyValuePair< String, T > > sequence)
inlineinherited

This function queries the property's translation table.

If this property defines a translation table the strings and their corresponding translation values will be written into sequence. If the property does NOT define a translation table sequence will be empty after this function call.

Note
This function is much more efficient than calling mv.impact.acquire.EnumPropertyF<T>.getTranslationDictString and mv.impact.acquire.EnumPropertyF<T>.getTranslationDictValue multiple times and therefore this function should be called whenever all entries are required.
Returns
A const reference to the calling property.
Parameters
[out]sequenceA reference to a container which will receive the data from the properties translation dictionary.

◆ getTranslationDictString() [1/2]

String getTranslationDictString ( )
inlineinherited

This function reads a single translation table string entry from a property.

If this property defines a translation table and index specifies a valid entry the string representation of this entry will be returned. If the property does NOT define a translation table or index specifies an invalid entry an exception will be thrown.

◆ getTranslationDictString() [2/2]

String getTranslationDictString ( int index)
inlineinherited

This function reads a single translation table string entry from a property.

If this property defines a translation table and index specifies a valid entry the string representation of this entry will be returned. If the property does NOT define a translation table or index specifies an invalid entry an exception will be thrown.

Parameters
[in]indexThe index of the entry to read from the property.

◆ getTranslationDictStrings()

EnumPropertyF< T > getTranslationDictStrings ( List< String > sequence)
inlineinherited

This function queries a list of valid strings for this property.

If this property defines a translation table all valid strings will be written into sequence. If the property does NOT define a translation table sequence will be empty after this function call.

Note
This function is much more efficient than calling mv.impact.acquire.EnumPropertyF<T>.getTranslationDictString multiple times and therefore this function should be called whenever all entries are required.
Since
2.5.0
Returns
A const reference to the calling property.
Parameters
[out]sequenceA reference to a container to store the data read from the property into.

◆ getTranslationDictValue() [1/2]

T getTranslationDictValue ( )
inlineinherited

This function reads a single translation table value entry from a property.

If this property defines a translation table and index specifies a valid entry the value of this entry will be returned. If the property does NOT define a translation table or index specifies an invalid entry an exception will be thrown.

See also
mv.impact.acquire.EnumPropertyF<T>.getTranslationDictValues to query all valid values efficiently in a single call.

◆ getTranslationDictValue() [2/2]

T getTranslationDictValue ( int index)
inlineinherited

This function reads a single translation table value entry from a property.

If this property defines a translation table and index specifies a valid entry the value of this entry will be returned. If the property does NOT define a translation table or index specifies an invalid entry an exception will be thrown.

See also
mv.impact.acquire.EnumPropertyF<T>.getTranslationDictValues to query all valid values efficiently in a single call.
Parameters
[in]indexThe index of the entry to read from the property.

◆ getTranslationDictValues()

EnumPropertyF< T > getTranslationDictValues ( List< T > sequence)
inlineinherited

This function queries a list of valid values for this property.

If this property defines a translation table all valid values will be written into sequence. If the property does NOT define a translation table sequence will be empty after this function call.

Note
This function is much more efficient than calling mv.impact.acquire.EnumPropertyF<T>.getTranslationDictValue multiple times and therefore this function should be called whenever all entries are required.
Returns
A const reference to the calling property.
Parameters
[in]sequenceA reference to a container to store the data read from the property into.

◆ operator T()

static implicit operator T ( EnumPropertyF< T > prop)
inlinestaticinherited

Allows a direct cast of the property object to its underlying value type.

This is the same as calling mv.impact.acquire.EnumPropertyF<T>.read with index 0.

Returns
The properties value at index 0.

◆ operator+()

static double operator+ ( PropertyF a,
PropertyF b )
inlinestatic

Adds the values stored at index 0 of 2 float properties and returns the result.

◆ read() [1/6]

T read ( )
inlineinherited

Reads a value from a property.

This function queries a single value stored under index index in the property.

Returns
The value stored at index within the property.
Examples
GenICamCommonSettingsUsage.cs.

◆ read() [2/6]

T read ( int index)
inlineinherited

Reads a value from a property.

This function queries a single value stored under index index in the property.

Returns
The value stored at index within the property.
Parameters
[in]indexThe index of the value to read from the property.

◆ read() [3/6]

double[] read ( int start,
int end )
inlineinherited

Reads a set of values from a property.

This function queries a set of values from a property and stores these values into sequence.

Returns
A set of values read from the propery.
Parameters
[in]startThe index from where to start reading values from the property.
[in]endThe index where to stop reading values from the property.

◆ read() [4/6]

void read ( List< T > sequence)
inlineinherited

Reads a set of values from a property.

This function queries a set of values from a property and stores these values into sequence.

Parameters
[out]sequenceA reference to a container to store the data read from the property into.

◆ read() [5/6]

void read ( List< T > sequence,
int start )
inlineinherited

Reads a set of values from a property.

This function queries a set of values from a property and stores these values into sequence.

Parameters
[out]sequenceA reference to a container to store the data read from the property into.
[in]startThe index from where to start reading values from the property.

◆ read() [6/6]

void read ( List< T > sequence,
int start,
int end )
inlineinherited

Reads a set of values from a property.

This function queries a set of values from a property and stores these values into sequence.

Parameters
[out]sequenceA reference to a container to store the data read from the property into.
[in]startThe index from where to start reading values from the property.
[in]endThe index where to stop reading values from the property.

◆ write() [1/6]

EnumPropertyF< T > write ( double[] values)
inlineinherited

Writes a set of values to the property.

This function writes a set of values starting at index to the property.

Returns
A const 'self' reference.
Parameters
[in]valuesAn array containing the values to write to the property.

◆ write() [2/6]

EnumPropertyF< T > write ( double[] values,
int start )
inlineinherited

Writes a set of values to the property.

This function writes a set of values starting at index to the property.

Returns
A const 'self' reference.
Parameters
[in]valuesAn array containing the values to write to the property.
[in]startThe index where to write the first value to the property.

◆ write() [3/6]

EnumPropertyF< T > write ( List< T > sequence)
inlineinherited

Writes a set of values to the property.

This function writes a set of values starting at index to the property.

Returns
A const 'self' reference.
Parameters
[in]sequenceAn array containing the values to write to the property.

◆ write() [4/6]

EnumPropertyF< T > write ( List< T > sequence,
int start )
inlineinherited

Writes a set of values to the property.

This function writes a set of values starting at index to the property.

Returns
A const 'self' reference.
Parameters
[in]sequenceAn array containing the values to write to the property.
[in]startThe index where to write the first value to the property.

◆ write() [5/6]

EnumPropertyF< T > write ( T value)
inlineinherited

Writes one value to the property.

This function writes a single value under index index to the property.

Returns
A const 'self' reference
Parameters
[in]valueThe value to write to the property.
Examples
GenICamCommonSettingsUsage.cs.

◆ write() [6/6]

EnumPropertyF< T > write ( T value,
int index )
inlineinherited

Writes one value to the property.

This function writes a single value under index index to the property.

Returns
A const 'self' reference
Parameters
[in]valueThe value to write to the property.
[in]indexThe index defining at which position to write the value.

Property Documentation

◆ listOfValidStrings

ReadOnlyCollection<String> listOfValidStrings
getinherited

Returns a list of valid strings for this property.

If this property does not define a translation dictionary an exception will be thrown.

Since
2.5.0

◆ listOfValidValues

ReadOnlyCollection<T> listOfValidValues
getinherited

Returns a list of valid values for this property.

If this property does not define a translation dictionary an exception will be thrown.

◆ maxValue

T maxValue
getinherited

Reads the maximum value from a property.

Note
To find out if the property defines a maximum value mv.impact.acquire.Property.hasMaxValue should be called first.
If the property does not define a maximum value calling this function will raise an exception.
Since
1.12.63
Examples
GenICamCommonSettingsUsage.cs.

◆ minValue

T minValue
getinherited

Reads the minimum value from a property.

Note
To find out if the property defines a minimum value mv.impact.acquire.Property.hasMinValue should be called first.
If the property does not define a minimum value calling this function will raise an exception.
Since
1.12.63
Examples
GenICamCommonSettingsUsage.cs.

◆ stepWidth

T stepWidth
getinherited

Reads the step width from a property.

Note
To find out if the property defines a step width mv.impact.acquire.Property.hasStepWidth should be called first.
If the property does not define a step width calling this function will raise an exception.
Since
1.12.63