MetadataValueType Property
The type of the metadata item's value.
Syntax
ANSI (Cross Platform) int GetMetadataValueType(int iMetadataIndex);
int SetMetadataValueType(int iMetadataIndex, int iMetadataValueType); Unicode (Windows) INT GetMetadataValueType(INT iMetadataIndex);
INT SetMetadataValueType(INT iMetadataIndex, INT iMetadataValueType);
Possible Values
MT_STRING(0),
MT_NUMBER(1),
MT_MULTI_SELECT(2)
- (int)metadataValueType:(int)metadataIndex; - (void)setMetadataValueType:(int)metadataIndex:(int)newMetadataValueType;
Possible Values
MT_STRING(0),
MT_NUMBER(1),
MT_MULTI_SELECT(2)
#define PID_BOX_METADATAVALUETYPE 35 IPWORKSCLOUD_EXTERNAL void* IPWORKSCLOUD_CALL IPWorksCloud_Box_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal); IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_Box_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal); IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_Box_CheckIndex(void *lpObj, int propid, int arridx);
Default Value
0
Remarks
The type of the metadata item's value.
This property specifies the type of the metadata item's value, and controls how the class encodes MetadataValue when submitting it to the server. Possible values, and their corresponding Box types, are:
Value Type | Encoded As | Corresponding Box Types |
0 (mtString - default) | String | string, date, enum (single-select) |
1 (mtNumber) | Number | float (note: actually any numeric value, including integers) |
2 (mtMultiSelect) | Array of strings | enum (multi-select) |
The MetadataValue property should hold a comma-separated list of strings when this property is set to 2 (mtMultiSelect).
This property may be used as input when CreateMetadata or UpdateMetadata is called if the MetadataModOp property is set to one of the following:
- 1 (opAdd)
- 2 (opReplace)
- 6 (opTest)
Important: Box only allows string-typed metadata items in the /global/properties metadata container; the class will always ignore this property and encode metadata items as strings when creating or updating the /global/properties container.
The MetadataIndex parameter specifies the index of the item in the array. The size of the array is controlled by the MetadataCount property.
This property is not available at design time.
Data Type
Integer