IInkExtendedProperties::Add-Methode (msinkaut.h)
Erstellt ein IInkExtendedProperty-Objekt und fügt es der IInkExtendedProperties-Auflistung hinzu.
Syntax
HRESULT Add(
[in] BSTR Guid,
[in] VARIANT Data,
[out, retval] IInkExtendedProperty **InkExtendedProperty
);
Parameter
[in] Guid
Der Name des neuen IInkExtendedProperty-Objekts . Der Name wird als BSTR ausgedrückt, der den Globally Unique Identifier (GUID) im folgenden Format darstellt:
{dfc71f44-354b-4ca1-93d7-7459410b6343} (Einschließlich geschweifter Klammern)
Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.
[in] Data
Die Daten für das neue IInkExtendedProperty-Objekt .
Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.
[out, retval] InkExtendedProperty
Wenn diese Methode zurückgibt, enthält einen Zeiger auf die neue erweiterte Eigenschaft.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Der Benutzer hat keine Daten angegeben. |
|
Ungültiges GUID-Format. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
Der Strich ist ungültig. |
Hinweise
Hinweis Sie können kein leeres IInkExtendedProperty-Objekt speichern. Das Objekt muss Daten enthalten, bevor es gespeichert werden kann. Wenn Sie beispielsweise versuchen, einem Strich erweiterte Eigenschaften zur späteren Verwendung hinzuzufügen, wird eine Ausnahme ausgelöst, wenn die erweiterte Eigenschaft keine Daten enthält.
- Byte- oder CHAR-Array
- Arrays von ganzen Zahlen, Floats, großen ganzen Zahlen, Doubles, Datumsangaben oder Dezimalstellen
- Boolesche (aber keine Arrays von Booleanen)
- BSTRs (aber keine Arrays von BSTRs)
- Arrays von Varianten. Alle Arrays von Varianten, die als IInkExtendedProperty übergeben werden, müssen vom gleichen Typ sein und alle numerisch sein. Beispielsweise werden Variantenarrays von BSTRS, Arrays von Arrays, VT_NULL und VT_EMPTY nicht unterstützt.
Hinweis Wenn Sie diese Methode aufrufen, wobei der Guid-Parameter auf eine GUID festgelegt ist, die bereits in der IInkExtendedProperties-Auflistung vorhanden ist, ersetzen die neuen Daten die vorhandene erweiterte Eigenschaft für diese GUID, anstatt ein zweites Element hinzuzufügen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | msinkaut.h |
| Bibliothek | InkObj.dll |