Expand Minimize

IPropertyValue interface

Applies to Windows and Windows Phone

Represents a value in a property store. You can't implement this interface, see Remarks.

Syntax


public interface class IPropertyValue

Attributes

[Version(0x06020000)]

Members

The IPropertyValue interface inherits from the IUnknown interface. IPropertyValue also has these types of members:

Methods

The IPropertyValue interface has these methods. It also inherits methods from the Object class.

MethodDescription
GetBoolean Returns the Boolean value stored as a property value.
GetBooleanArray Returns the array of Boolean values stored as a property value.
GetChar16 Returns the Unicode character stored as a property value.
GetChar16Array Returns the array of Unicode characters stored as a property value.
GetDateTime Returns the date and time value stored as a property value.
GetDateTimeArray Returns the array of date and time values stored as a property value.
GetDouble Returns the floating-point value stored as a property value.
GetDoubleArray Returns the array of floating-point values stored as a property value.
GetGuid Returns the GUID value stored as a property value.
GetGuidArray Returns the array of GUID values stored as a property value.
GetInspectableArray Returns the array of inspectable objects stored as a property value.
GetInt16 Returns the integer value stored as a property value.
GetInt16Array Returns the array of integer values stored as a property value.
GetInt32 Returns the integer value stored as a property value.
GetInt32Array Returns the array of integer values stored as a property value.
GetInt64 Returns the integer value stored as a property value.
GetInt64Array Returns the array of integer values stored as a property value.
GetPoint Returns the point structure stored as a property value.
GetPointArray Returns the array of point structures stored as a property value.
GetRect Returns the rectangle structure stored as a property value.
GetRectArray Returns the array of rectangle structures stored as a property value.
GetSingle Returns the floating-point value stored as a property value.
GetSingleArray Returns the array of floating-point values stored as a property value.
GetSize Returns the size structure stored as a property value.
GetSizeArray Returns the array of size structures stored as a property value.
GetString Returns the string value stored as a property value.
GetStringArray Returns the array of string values stored as a property value.
GetTimeSpan Returns the time interval value stored as a property value.
GetTimeSpanArray Returns the array of time interval values stored as a property value.
GetUInt16 Returns the unsigned integer value stored as a property value.
GetUInt16Array Returns the array of unsigned integer values stored as a property value.
GetUInt32 Returns the unsigned integer value stored as a property value.
GetUInt32Array Returns the array of unsigned integer values stored as a property value.
GetUInt64 Returns the unsigned integer value stored as a property value.
GetUInt64Array Returns the array of unsigned integer values stored as a property value.
GetUInt8 Returns the byte value stored as a property value.
GetUInt8Array Returns the array of byte values stored as a property value.

 

Properties

The IPropertyValue interface has these properties.

PropertyAccess typeDescription

IsNumericScalar

Read-onlyGets a value that indicates whether the property value is a scalar value.

Type

Read-onlyReturns the type stored in the property value.

 

Remarks

The IPropertyValue interface is a store for values whose type is not known until runtime.

To obtain the value stored in an IPropertyValue object, when the type of the stored property is not known ahead of time, you should first determine the stored type from the Type property and then call the appropriate IPropertyValue method for the type.

If the type is known ahead of time, you can the type access method of IPropertyValue interface directory and check for the return value to verify type returned was what is expected. If the type returned does not match the value of the Type property then the method fails with the TYPE_E_TYPEMISMATCH error.

You can't implement the IPropertyValue interface or include it in a signature. IPropertyValue is mainly an internal implementation detail of how the Windows Runtime implements boxing and nullable values.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows::Foundation

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft