IPWorks Cloud 2020 C++ Edition

Questions / Feedback?

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

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks Cloud 2020 C++ Edition - Version 20.0 [Build 8265]