GetFeatureList

Description

Returns the array of strings containing the names of camera features grouped under the specified category.


Syntax

[VB]
Value=objActiveGige.GetFeatureList( Category )

[C/C++]
HRESULT GetFeatureList( bstr Category, VARIANT* pList );


Data Types [VB]

Category: String
Return value: Variant (SAFEARRAY)


Parameters [C/C++]

Category [in]

Name of the category for the list of features. If this parameter is "ALL", the list of all features supported by the camera will be returned.

pList [out,retval]

Pointer to the SAFEARRAY of strings containing available formats

Return Values

S_OK

Success

E_NOINTERFACE

Category is not supported by the camera

E_FAIL

Failure.

Example

This VB example initializes a combo box with the names of available camera features:

Private Sub Form_Load()
FeatureLst = ActiveGige1.GetFeatureList("ALL")
For i = 0 To UBound(FeatureLst)
Combo1.AddItem (FeatureLst(i))
Next
Combo1.ListIndex = 0
ActiveGige1.Acquire = True
End Sub

Private Sub Combo1_Click()
ActiveGige1.Feature = Combo1.ListIndex
End Sub

This MFC example fills out a combo box with camera features grouped under the "TriggerAcquisition" category:

VARIANT m_FeatureArray=m_ActiveGige.GetFeatureList("TriggerAcquisition");
SAFEARRAY *pArray=m_FeatureArray.parray;
UINT nFeatures=pArray->rgsabound[0].cElements;

CString strFeature;
CComboBox *pFeature=(CComboBox*)GetDlgItem(IDC_FEATURE);
for(UINT i=0;i<nFeatures;i++)
{
   pFeature->AddString(strFeature);
}
int iFeature=m_ActiveGige.GetFeature();
pFeature->SetCurSel(iFeature);

SafeArrayDestroy(pArray);


Remarks

To get or set the value of a specific camera feature, use GetFeature, GetFeatureString, SetFeature, SetFeatureString

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