GetEnumList
Top  Previous  Next

Description

Returns the array of string values representing the specified enumerated feature of the camera.


Syntax


[VB]
Value=objActiveGeni.GetEnumList( Name )


[C/C++]
HRESULT GetEnumList( bstr Name, VARIANT* pInfo );


Data Types
[VB]

Name: String
Return value
: Variant (Array)


Parameters
[C/C++]

Name [in]  
String containing the name of the enumerated feature  
pInfo [out,retval]  
Pointer to the SAFEARRAY containing the allowed string values of the feature:  
 
Return Values

S_OK  
Success  
E_NOINTERFACE        
Feature does not exist or not available  
E_INVALIDARG  
Feature is not of enumerated type  
E_FAIL  
Failed to read feature.  


Example


This VB example uses a combo box to switch between different auto exposure modes:

Private Sub
 Form_Load()
Lst = ActiveGeni1.GetEnumList("ExposureAuto")
For
 i = 0 
To
 
UBound
(Lst)
Combo1.AddItem (Lst(i))
Next

Combo1.ListIndex = ActiveGeni1.GetFeature("ExposureAuto")
ActiveGeni1.Acquire = 
True
End Sub

Private Sub
 Combo1_Click()
ActiveGeni1.SetFeatureString Combo1.Text
End Sub


Remarks

The index of an element in the string list can be used as an argument of SetFeature to set a specific value for the feature.

Note that in C/C++ applications it is required to call SafeArrayDestroy() to delete the SAFEARRAY returned by GetEnumList.

If the specified feature is not of the enumerated type or not supported by the camera, the method will return an error.