CWiauPropertyList::D efineProperty-Methode (wiautil.h)
Die CWiauPropertyList::D efineProperty--Methode fügt einem Eigenschaftenlistenobjekt eine Eigenschaftsdefinition hinzu.
Syntax
HRESULT DefineProperty(
int *pIdx,
PROPID PropId,
LPOLESTR PropName,
ULONG Access,
ULONG SubType
);
Parameter
pIdx
Zeigen Sie auf einen Speicherspeicherort, der den Index für die neu hinzugefügte Eigenschaft empfängt. Viele andere Methoden in dieser Klasse verwenden den Index einer Eigenschaft, um die Eigenschaft zu identifizieren.
PropId
Gibt eine Eigenschafts-ID-Konstante an.
PropName
Zeigen Sie auf eine Namenszeichenfolge für die Eigenschaft.
Access
Gibt den Typ des Zugriffs für die Eigenschaft an, in der Regel entweder WIA_PROP_READ (schreibgeschützt) oder WIA_PROP_RW (Lese-/Schreibzugriff).
SubType
Gibt den Untertyp der Eigenschaft, einen von WIA_PROP_FLAG, WIA_PROP_LIST, WIA_PROP_RANGE oder WIA_PROP_NONE an. Die ersten drei Konstanten geben an, dass eine Eigenschaft eine Gruppe von Kennzeichenwerten, eine Liste von Werten oder einen Wertebereich ist. Die vierte Konstante gibt an, dass eine Eigenschaft keines dieser Eigenschaften ist.
Rückgabewert
Diese Methode gibt S_OK zurück, wenn sie eine Eigenschaft erfolgreich definieren kann. Wenn die Eigenschaftsliste nicht genügend Platz für eine zusätzliche Eigenschaft hat, gibt die Methode E_FAIL zurück.
Bemerkungen
Bevor einer Eigenschaftsliste eine Eigenschaft hinzugefügt werden kann, muss die Eigenschaftsliste initialisiert werden. Rufen Sie dazu die CWiauPropertyList::Init-Methode auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiautil.h (include Wiautil.h, Wiamindr.h) |