Variant (JACOB : Java COM Bridge API Docs)

java.lang.Object
- com.jacob.com.JacobObject
- - com.jacob.com.Variant

Direct Known Subclasses:

VariantViaEvent
```
public class Variant
extends JacobObject
```
The multi-format data type used for all call backs and most communications between Java and COM. It provides a single class that can handle all data types.
Just loading this class creates 3 variants that get added to the ROT

PROPVARIANT introduces new types so eventually Variant will need to be upgraded to support PropVariant types. http://blogs.msdn.com/benkaras/archive/2006/09/13/749962.aspx

This object no longer implements Serializable because serialization is broken (and has been since 2000/xp). The underlying marshalling/unmarshalling code is broken in the JNI layer.
(用于Java和COM之间的所有回叫和大多数通信的多格式数据类型。它提供了一个可以处理所有数据类型的类。只需加载此类，就会创建3个变体，这些变体将添加到ROT PROPVARIANT中，从而引入了新类型，因此最终需要对Variant进行升级以支持PropVariant类型。 http://blogs.msdn.com/benkaras/archive/2006/09/13/749962.aspx该对象不再实现Serializable，因为序列化已损坏（并且自2000 / xp起就已存在）。在JNI层中破坏了底层的编组/解组代码。)

Field Summary

Fields
Modifier and Type	Field and Description
`static Variant`	`DEFAULT` Use this constant for optional parameters (使用此常量作为可选参数)
`static short`	`VariantArray` variant's type is array VT_ARRAY 0x2000 (变体的类型是数组VT_ARRAY 0x2000)
`static short`	`VariantBoolean` variant's type is boolean VT_BOOL (变体的类型是布尔VT_BOOL)
`static short`	`VariantByref` variant's type is a reference (to IDispatch?) VT_BYREF 0x4000 (变量的类型是对IDispatch的引用（对IDispatch？）VT_BYREF 0x4000)
`static short`	`VariantByte` variant's type is byte VT_UI1 This is an UNSIGNED byte (变量的类型是字节VT_UI1这是一个未签名的字节)
`static short`	`VariantCurrency` variant's type is currency VT_CY (变体的类型是货币VT_CY)
`static short`	`VariantDate` variant's type is date VT_DATE (变体的类型是日期VT_DATE)
`static short`	`VariantDecimal` variant's type is object VT_DECIMAL (变量的类型是对象VT_DECIMAL)
`static short`	`VariantDispatch` variant's type is dispatch VT_DISPATCH (变体的类型是调度VT_DISPATCH)
`static short`	`VariantDouble` variant's type is double VT_R8 (变体的类型是double VT_R8)
`static short`	`VariantEmpty` variant's type is empty : equivalent to VB Nothing and VT_EMPTY (变体的类型为空：等效于VB Nothing和VT_EMPTY)
`static short`	`VariantError` variant's type is error VT_ERROR (变体的类型为错误VT_ERROR)
`static short`	`VariantFloat` variant's type is float VT_R4 (变体的类型是float VT_R4)
`static short`	`VariantInt` variant's type is int VT_I4, a Long in VC (变体的类型是int VT_I4，VC中的Long)
`static short`	`VariantLongInt` variant's type is 64 bit long integer VT_I8 - not yet implemented in Jacob because we have to decide what to do with Currency and because its only supported on XP and later. (变体的类型是64位长的整数VT_I8-尚未在Jacob中实现，因为我们必须决定如何处理Currency，并且仅在XP和更高版本中才支持。)
`static short`	`VariantNull` variant's type is null : equivalent to VB Null and VT_NULL (变体的类型为null：等效于VB Null和VT_NULL)
`static short`	`VariantObject` variant's type is object VT_UNKNOWN (变量的类型是对象VT_UNKNOWN)
`static short`	`VariantPointer` This value is for reference only and is not to be used by any callers (此值仅供参考，任何调用者均不得使用)
`static short`	`VariantShort` variant's type is short VT_I2 (变体的类型很短VT_I2)
`static short`	`VariantString` variant's type is string also known as VT_BSTR (变体的类型是字符串，也称为VT_BSTR)
`static short`	`VariantTypeMask` what is this? VT_TYPEMASK && VT_BSTR_BLOB 0xfff (这是什么？ VT_TYPEMASK和＆VT_BSTR_BLOB 0xfff)
`static short`	`VariantVariant` variant's type is variant it encapsulate another variant VT_VARIANT (变量的类型是变量，它封装了另一个变量VT_VARIANT)
`static Variant`	`VT_FALSE` Use for true/false variant parameters (用于true / false变体参数)
`static Variant`	`VT_MISSING` Same than `DEFAULT` (与DEFAULT相同)
`static Variant`	`VT_TRUE` Use for true/false variant parameters (用于true / false变体参数)

Constructor Summary

Constructors
Constructor and Description
`Variant()` public constructor, initializes and sets type to VariantEmpty
`Variant(boolean in)` Constructor that accepts a primitive rather than an object
`Variant(byte in)` Constructor that accepts a primitive rather than an object
`Variant(double in)` Constructor that accepts a primitive rather than an object
`Variant(float in)` Constructor that accepts a primitive rather than an object
`Variant(int in)` Constructor that accepts a primitive rather than an object
`Variant(long in)` Constructor that accepts a primitive rather than an object
`Variant(Object in)` Convenience constructor that calls the main one with a byRef value of false
`Variant(Object pValueObject, boolean fByRef)` Constructor that accepts the data object and information about whether this is by reference or not.
`Variant(short in)` Constructor that accepts a primitive rather than an object

Method Summary

Methods
Modifier and Type	Method and Description
`Variant`	`changeType(short in)` Cover for native method so we can cover it. (覆盖本机方法，因此我们可以覆盖它。)
`Object`	`clone()` this returns null (这将返回null)
`Variant`	`cloneIndirect()` Deprecated. No longer used (不推荐使用。不再使用)
`protected void`	`finalize()`
`boolean`	`getBoolean()`
`boolean`	`getBooleanRef()` public cover for native method (本机方法的公共覆盖)
`byte`	`getByte()`
`byte`	`getByteRef()` public cover for native method (本机方法的公共覆盖)
`Currency`	`getCurrency()` MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (MS货币对象是64位定点数，在小数点左边15位，右边4位。)
`Currency`	`getCurrencyRef()` MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (MS货币对象是64位定点数，在小数点左边15位，右边4位。)
`double`	`getDate()`
`double`	`getDateRef()`
`BigDecimal`	`getDecimal()` return the BigDecimal value held in this variant (fails on other types) (返回此变体中保存的BigDecimal值（在其他类型上失败）)
`BigDecimal`	`getDecimalRef()` return the BigDecimal value held in this variant (fails on other types) (返回此变体中保存的BigDecimal值（在其他类型上失败）)
`Dispatch`	`getDispatch()` cover for `toDispatch()` This method now matches other getXXX() methods. (toDispatch（）的封面现在，此方法与其他getXXX（）方法匹配。)
`Dispatch`	`getDispatchRef()` Dispatch and dispatchRef are treated the same This is just a cover for toDispatch() with a flag check (Dispatch和dispatchRef的处理方式相同这只是toDispatch（）的封面，带有标志检查)
`double`	`getDouble()`
`double`	`getDoubleRef()`
`void`	`getEmpty()` Deprecated. method never did anything (不推荐使用。方法从没做过)
`int`	`getError()`
`int`	`getErrorRef()`
`float`	`getFloat()`
`float`	`getFloatRef()`
`int`	`getInt()` return the int value held in this variant if it is an int or a short. (如果它是int或short，则返回此变体中保存的int值。)
`int`	`getIntRef()` get the content of this variant as an int (以int形式获取此变体的内容)
`Date`	`getJavaDate()` returns the windows time contained in this Variant to a Java Date. (将此变体中包含的Windows时间返回到Java日期。)
`Date`	`getJavaDateRef()` returns the windows time contained in this Variant to a Java Date should return null if this is not a date reference Variant SF 959382 (将包含在此变量中的Windows时间返回给Java Date，如果它不是日期引用，则应返回null SF 959382)
`long`	`getLong()` 64 bit Longs only available on x64. (64位长仅在x64上可用。)
`long`	`getLongRef()` 64 bit Longs only available on x64. (64位长仅在x64上可用。)
`void`	`getNull()` Deprecated. method never did anything (不推荐使用。方法从没做过)
`short`	`getShort()` return the int value held in this variant (fails on other types?) (返回此变体中保存的int值（其他类型失败吗？）)
`short`	`getShortRef()` get the content of this variant as an int (以int形式获取此变体的内容)
`String`	`getString()`
`String`	`getStringRef()` gets the content of the variant as a string ref (获取变量的内容作为字符串引用)
`Object`	`getVariant()` Used to get the value from a windows type of VT_VARIANT or a jacob Variant type of VariantVariant. (用于从VT_VARIANT的Windows类型或VariantVariant的jacob Variant类型获取值。)
`Variant[]`	`getVariantArray()` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`Variant[]`	`getVariantArrayRef()` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`short`	`getvt()` Reports the type of the underlying Variant object (报告基础Variant对象的类型)
`protected void`	`init()` initializes the COM Variant and puts its reference in this instance (初始化COM Variant并将其引用放入此实例)
`boolean`	`isNull()`
`void`	`noParam()` Deprecated. replaced by putNoParam() (不推荐使用。替换为putNoParam（）)
`protected boolean`	`objectIsAConstant(Variant pVariant)` returns true if the passed in Variant is a constant that should not be freed (如果传入的Variant是一个不应释放的常量，则返回true)
`void`	`putBoolean(boolean in)` puts a boolean into the variant and sets it's type (将布尔值放入变量中并设置其类型)
`void`	`putBooleanRef(boolean in)` pushes a boolean into the variant by ref and sets the type of the variant to boolean (通过ref将布尔值推送到变量中，并将变量的类型设置为boolean)
`void`	`putByte(byte in)` pushes a byte into the varaint and sets the type (向变体中推送一个字节并设置类型)
`void`	`putByteArray(Object in)` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`void`	`putByteRef(byte in)` pushes a byte into the variant by ref and sets the type (通过ref将字节压入变量并设置类型)
`void`	`putCharArray(Object in)` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`void`	`putCurrency(Currency in)` Puts a value in as a currency and sets the variant type. (以货币形式输入值并设置变量类型。)
`void`	`putCurrencyRef(Currency in)` Pushes a long into the variant as currency and sets the type. (将长整数作为货币推送并设置类型。)
`void`	`putDate(Date inDate)` converts a java date to a windows time and calls putDate(double) SF 959382 (将Java日期转换为Windows时间并调用putDate（double）SF 959382)
`void`	`putDate(double in)` puts a windows date double into the variant and sets the type (将Windows日期的double值放入变量中并设置类型)
`void`	`putDateRef(Date inDate)` converts a java date to a windows time and calls putDateRef(double) SF 959382 (将Java日期转换为Windows时间并调用putDateRef（double）SF 959382)
`void`	`putDateRef(double in)` set the content of this variant to a date (VT_DATE\|VT_BYREF) (将此变体的内容设置为日期（VT_DATE \| VT_BYREF）)
`void`	`putDecimal(BigDecimal in)` EXPERIMENTAL 1.14 feature to support rounded decimals. (实验1.14功能支持四舍五入的小数。)
`void`	`putDecimalRef(BigDecimal in)` Set the value of this variant and set the type. (设置此变量的值并设置类型。)
`void`	`putDispatch(Dispatch in)` This acts a cover for putVariant Dispatch. (这充当了putVariant Dispatch的掩护。)
`void`	`putDispatchRef(Dispatch in)` Dispatch and dispatchRef are treated the same This is a cover for putVariantDispatch(). (Dispatch和dispatchRef的处理方式相同。这是putVariantDispatch（）的封面。)
`void`	`putDouble(double in)` wraps this Variant around the passed in double. (将此Variant包裹在传入的double中。)
`void`	`putDoubleRef(double in)` set the content of this variant to a double (VT_R8\|VT_BYREF) (将此变量的内容设置为双精度（VT_R8 \| VT_BYREF）)
`void`	`putEmpty()` sets the type to VariantEmpty (将类型设置为VariantEmpty)
`void`	`putError(int in)` puts an error code (I think) into the variant and sets the type (将错误代码（我认为）放入变量并设置类型)
`void`	`putErrorRef(int in)` pushes an error code into the variant by ref and sets the type (通过ref将错误代码推送到变量中并设置类型)
`void`	`putFloat(float in)` fills the Variant with a float and sets the type to float (用浮点数填充Variant并将类型设置为float)
`void`	`putFloatRef(float in)` pushes a float into the variant and sets the type (将float推入变量并设置类型)
`void`	`putInt(int in)` set the value of this variant and set the type (设置此变量的值并设置类型)
`void`	`putIntRef(int in)` set the content of this variant to an int (VT_I4\|VT_BYREF) (将此变量的内容设置为int（VT_I4 \| VT_BYREF）)
`void`	`putLong(long in)` Puts a 64 bit Java Long into a 64 bit Variant Long. (将64位Java Long放入64位Variant Long中。)
`void`	`putLongRef(long in)` Puts a 64 bit Java Long into a 64 bit Variant Long. (将64位Java Long放入64位Variant Long中。)
`void`	`putNoParam()` sets the type to VT_ERROR and the error message to DISP_E_PARAMNOTFOIUND (将类型设置为VT_ERROR并将错误消息设置为DISP_E_PARAMNOTFOIUND)
`void`	`putNothing()` Sets the type to VariantDispatch and sets the value to null Equivalent to VB's nothing (将类型设置为VariantDispatch并将值设置为null等效于VB)
`void`	`putNull()` Set this Variant's type to VT_NULL (the VB equivalent of NULL) (将此Variant的类型设置为VT_NULL（VB等效于NULL）)
`void`	`putObject(Object in)` Deprecated. should use putDispatch() (不推荐使用。应该使用putDispatch（）)
`void`	`putObjectRef(Object in)` Deprecated. (不推荐使用。)
`void`	`putSafeArray(SafeArray in)` have no idea... (不知道...)
`void`	`putSafeArrayRef(SafeArray in)` have no idea... (不知道...)
`void`	`putShort(short in)` set the content of this variant to a short (VT_I2) (将此变体的内容设置为简短（VT_I2）)
`void`	`putShortRef(short in)` set the content of this variant to a short (VT_I2\|VT_BYREF) (将此变量的内容设置为简短形式（VT_I2 \| VT_BYREF）)
`void`	`putString(String in)` put a string into the variant and set its type (将字符串放入变量中并设置其类型)
`void`	`putStringRef(String in)` set the content of this variant to a string (VT_BSTR\|VT_BYREF) (将此变量的内容设置为字符串（VT_BSTR \| VT_BYREF）)
`void`	`putVariant(Object objectToBeWrapped)` Puts a variant into this variant making it type VT_VARIANT. (将一个变量放入此变量中，使其类型为VT_VARIANT。)
`void`	`putVariantArray(Variant[] in)` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`void`	`putVariantArrayRef(Variant[] in)` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`void`	`safeRelease()` This will release the "C" memory for the Variant unless this Variant is one of the constants in which case we don't want to release the memory. (这将释放变量的“ C”内存，除非该变量是常量之一，在这种情况下，我们不想释放内存。)
`protected void`	`SerializationReadFromBytes(byte[] ba)` this is supposed to cause the underlying variant object struct to be rebuilt from a previously serialized byte array. (这可能会导致基础变体对象结构从以前序列化的字节数组中重建。)
`protected byte[]`	`SerializationWriteToBytes()` this is supposed to create a byte array that represents the underlying variant object structure (这应该创建一个字节数组，该字节数组表示基础变体对象结构)
`boolean`	`toBoolean()` Deprecated. should be replaced by changeType() followed by getBoolean() (不推荐使用。应该由ch??angeType（）和getBoolean（）代替)
`byte`	`toByte()` Deprecated. should be replaced by changeType() followed by getByte() (不推荐使用。应该由ch??angeType（）和getByte（）代替)
`Object`	`toByteArray()` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`Object`	`toCharArray()` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`Currency`	`toCurrency()` Deprecated. should be replaced by changeType() followed by getCurrency (不推荐使用。应该由ch??angeType（）替换，再由getCurrency替换)
`double`	`toDate()` Deprecated. should use changeType() followed by getDate() (不推荐使用。应该使用changeType（），然后使用getDate（）)
`Dispatch`	`toDispatch()`
`double`	`toDouble()` Deprecated. should call changeType() then getDouble() (不推荐使用。应该先调用changeType（）然后再调用getDouble（）)
`EnumVariant`	`toEnumVariant()`
`int`	`toError()` Deprecated. should use changeType() followed by getError() (不推荐使用。应该使用changeType（），然后使用getError（）)
`float`	`toFloat()` Deprecated. should use changeType() and getFloat() instead (不推荐使用。应该使用changeType（）和getFloat（）代替)
`int`	`toInt()` Deprecated. should use changeType() followed by getInt() (不推荐使用。应该使用changeType（），然后使用getInt（）)
`Date`	`toJavaDate()` Deprecated. callers should use getDate() (不推荐使用。调用者应使用getDate（）)
`Object`	`toJavaObject()` Convert a JACOB Variant value to a Java object (type conversions). (将JACOB Variant值转换为Java对象（类型转换）。)
`Object`	`toObject()` Deprecated. this is a cover for toDispatch(); (不推荐使用。这是toDispatch（）的封面；)
`SafeArray`	`toSafeArray()` By default toSafeArray makes a deep copy due to the fact that this Variant owns the embedded SafeArray and will destroy it when it gc's calls toSafeArray(true). (默认情况下，由于该Variant拥有嵌入式SafeArray，并且在gc调用toSafeArray（true）时会销毁它，因此toSafeArray进行深度复制。)
`SafeArray`	`toSafeArray(boolean deepCopy)` This lets folk turn into a safe array without a deep copy. (这样一来，人们就可以在不进行深层复制的情况下变成安全的阵列。)
`Object`	`toScriptObject()` Deprecated. (不推荐使用。)
`short`	`toShort()` Deprecated. callers should use changeType() followed by getShort() (不推荐使用。调用者应使用changeType（）后跟getShort（）)
`String`	`toString()` This method now correctly implements java toString() semantics Attempts to return the content of this variant as a string "not initialized" if not initialized "null" if VariantEmpty, "null" if VariantError "null" if VariantNull "null" if Variant type didn't convert. (此方法现在可以正确实现java toString（）语义尝试将此变体的内容作为字符串“未初始化”返回（如果未初始化），如果VariantEmpty为“ null”，如果VariantError为“ null”，如果VariantError为“ null”，如果VariantNull，为“ null”，如果Variant类型没有转换。)
`Variant`	`toVariant()` Deprecated. superseded by "this" (不推荐使用。被“ this”取代)
`Variant[]`	`toVariantArray()` Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
`void`	`VariantClear()` Clear the content of this variant (清除此变体的内容)

Methods inherited from class com.jacob.com.JacobObject
debug, getBuildDate, getBuildVersion, isDebugEnabled

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - DEFAULT
```
public static final Variant DEFAULT
```
    Use this constant for optional parameters (使用此常量作为可选参数)
  - VT_MISSING
```
public static final Variant VT_MISSING
```
    Same than DEFAULT (与DEFAULT相同)
  - VT_TRUE
```
public static final Variant VT_TRUE
```
    Use for true/false variant parameters (用于true / false变体参数)
  - VT_FALSE
```
public static final Variant VT_FALSE
```
    Use for true/false variant parameters (用于true / false变体参数)
  - VariantEmpty
```
public static final short VariantEmpty
```
    variant's type is empty : equivalent to VB Nothing and VT_EMPTY (变体的类型为空：等效于VB Nothing和VT_EMPTY)
    
    See Also:
    
    Constant Field Values
  - VariantNull
```
public static final short VariantNull
```
    variant's type is null : equivalent to VB Null and VT_NULL (变体的类型为null：等效于VB Null和VT_NULL)
    
    See Also:
    
    Constant Field Values
  - VariantShort
```
public static final short VariantShort
```
    variant's type is short VT_I2 (变体的类型很短VT_I2)
    
    See Also:
    
    Constant Field Values
  - VariantInt
```
public static final short VariantInt
```
    variant's type is int VT_I4, a Long in VC (变体的类型是int VT_I4，VC中的Long)
    
    See Also:
    
    Constant Field Values
  - VariantFloat
```
public static final short VariantFloat
```
    variant's type is float VT_R4 (变体的类型是float VT_R4)
    
    See Also:
    
    Constant Field Values
  - VariantDouble
```
public static final short VariantDouble
```
    variant's type is double VT_R8 (变体的类型是double VT_R8)
    
    See Also:
    
    Constant Field Values
  - VariantCurrency
```
public static final short VariantCurrency
```
    variant's type is currency VT_CY (变体的类型是货币VT_CY)
    
    See Also:
    
    Constant Field Values
  - VariantDate
```
public static final short VariantDate
```
    variant's type is date VT_DATE (变体的类型是日期VT_DATE)
    
    See Also:
    
    Constant Field Values
  - VariantString
```
public static final short VariantString
```
    variant's type is string also known as VT_BSTR (变体的类型是字符串，也称为VT_BSTR)
    
    See Also:
    
    Constant Field Values
  - VariantDispatch
```
public static final short VariantDispatch
```
    variant's type is dispatch VT_DISPATCH (变体的类型是调度VT_DISPATCH)
    
    See Also:
    
    Constant Field Values
  - VariantError
```
public static final short VariantError
```
    variant's type is error VT_ERROR (变体的类型为错误VT_ERROR)
    
    See Also:
    
    Constant Field Values
  - VariantBoolean
```
public static final short VariantBoolean
```
    variant's type is boolean VT_BOOL (变体的类型是布尔VT_BOOL)
    
    See Also:
    
    Constant Field Values
  - VariantVariant
```
public static final short VariantVariant
```
    variant's type is variant it encapsulate another variant VT_VARIANT (变量的类型是变量，它封装了另一个变量VT_VARIANT)
    
    See Also:
    
    Constant Field Values
  - VariantObject
```
public static final short VariantObject
```
    variant's type is object VT_UNKNOWN (变量的类型是对象VT_UNKNOWN)
    
    See Also:
    
    Constant Field Values
  - VariantDecimal
```
public static final short VariantDecimal
```
    variant's type is object VT_DECIMAL (变量的类型是对象VT_DECIMAL)
    
    See Also:
    
    Constant Field Values
  - VariantByte
```
public static final short VariantByte
```
    variant's type is byte VT_UI1 This is an UNSIGNED byte (变量的类型是字节VT_UI1这是一个未签名的字节)
    
    See Also:
    
    Constant Field Values
  - VariantLongInt
```
public static final short VariantLongInt
```
    variant's type is 64 bit long integer VT_I8 - not yet implemented in Jacob because we have to decide what to do with Currency and because its only supported on XP and later. No win2k, NT or 2003 server. (变体的类型是64位长的整数VT_I8-尚未在Jacob中实现，因为我们必须决定如何处理Currency，并且仅在XP和更高版本中才支持。没有win2k，NT或2003服务器。)
    
    See Also:
    
    Constant Field Values
  - VariantPointer
```
public static final short VariantPointer
```
    This value is for reference only and is not to be used by any callers (此值仅供参考，任何调用者均不得使用)
    
    See Also:
    
    Constant Field Values
  - VariantTypeMask
```
public static final short VariantTypeMask
```
    what is this? VT_TYPEMASK && VT_BSTR_BLOB 0xfff (这是什么？ VT_TYPEMASK和＆VT_BSTR_BLOB 0xfff)
    
    See Also:
    
    Constant Field Values
  - VariantArray
```
public static final short VariantArray
```
    variant's type is array VT_ARRAY 0x2000 (变体的类型是数组VT_ARRAY 0x2000)
    
    See Also:
    
    Constant Field Values
  - VariantByref
```
public static final short VariantByref
```
    variant's type is a reference (to IDispatch?) VT_BYREF 0x4000 (变量的类型是对IDispatch的引用（对IDispatch？）VT_BYREF 0x4000)
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Variant
```
public Variant()
```
    public constructor, initializes and sets type to VariantEmpty (公共构造函数，初始化并将类型设置为VariantEmpty)
  - Variant
```
public Variant(boolean in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(byte in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(double in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(float in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(int in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(long in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
  - Variant
```
public Variant(Object in)
```
    Convenience constructor that calls the main one with a byRef value of false (便利的构造函数，其主方法的byRef值为false)
    
    Parameters:
    
    in - object to be made into variant (-成为变体的对象)
  - Variant
```
public Variant(Object pValueObject,
       boolean fByRef)
```
    Constructor that accepts the data object and information about whether this is by reference or not. It calls the JavaVariantConverter to actually push the data into the newly created Variant. (接受数据对象和有关是否通过引用的信息的构造方法。它调用JavaVariantConverter实际将数据推送到新创建的Variant中。)
    
    Parameters:
    
    pValueObject - The value object that will pushed down into windows memory. A null object sets this to "empty" (-将压入Windows内存的值对象。空对象将此设置为“空”)
    
    fByRef - (-)
  - Variant
```
public Variant(short in)
```
    Constructor that accepts a primitive rather than an object (接受原语而不是对象的构造方法)
    
    Parameters:
    
    in - (-)
- Method Detail
  - changeType
```
public Variant changeType(short in)
```
    Cover for native method so we can cover it.
    This cannot convert an object to a byRef. It can convert from byref to not byref
    (覆盖本机方法，因此我们可以覆盖它。这不能将对象转换为byRef。它可以从byref转换为not byref)
    
    Parameters:
    
    in - type to convert this variant too (-键入也可以转换此变体)
    
    Returns:
    
    Variant returns this same object so folks can change when replacing calls toXXX() with changeType().getXXX() (Variant会返回相同的对象，以便当使用changeType（）。getXXX（）替换对XXX（）的调用时，人们可以进行更改)
  - clone
```
public Object clone()
```
    this returns null (这将返回null)
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    ?? comment says null? (??评论说没有？)
  - cloneIndirect
```
@Deprecated
public Variant cloneIndirect()
```
    Deprecated. No longer used (不推荐使用。不再使用)
    
    Returns:
    
    null ! (空值！)
  - finalize
```
protected void finalize()
```
    Overrides:
    
    finalize in class Object
  - getBoolean
```
public boolean getBoolean()
```
    Returns:
    
    returns the value as a boolean, throws an exception if its not. (以布尔值形式返回值，否则返回一个异常。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getBooleanRef
```
public boolean getBooleanRef()
```
    public cover for native method (本机方法的公共覆盖)
    
    Returns:
    
    the boolean from a booleanRef (booleanRef中的布尔值)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getByte
```
public byte getByte()
```
    Returns:
    
    returns the value as a boolean, throws an exception if its not. (以布尔值形式返回值，否则返回一个异常。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getByteRef
```
public byte getByteRef()
```
    public cover for native method (本机方法的公共覆盖)
    
    Returns:
    
    the byte from a booleanRef (booleanRef中的字节)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getCurrency
```
public Currency getCurrency()
```
    MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (MS货币对象是64位定点数，在小数点左边15位，右边4位。)
    
    Returns:
    
    returns the currency value as a long, throws exception if not a currency type.. (返回货币值（长整型），如果不是货币类型则抛出异常。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getCurrencyRef
```
public Currency getCurrencyRef()
```
    MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (MS货币对象是64位定点数，在小数点左边15位，右边4位。)
    
    Returns:
    
    returns the currency value as a long, throws exception if not a currency type (返回货币值的long，如果不是货币类型则抛出异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDate
```
public double getDate()
```
    Returns:
    
    double return the date (as a double) value held in this variant (fails on other types?) (double返回此变体中保存的日期（作为double）值（是否在其他类型上失败？）)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDateRef
```
public double getDateRef()
```
    Returns:
    
    returns the date value as a double, throws exception if not a date type (返回一个双精度的日期值，如果不是日期类型则抛出异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDecimal
```
public BigDecimal getDecimal()
```
    return the BigDecimal value held in this variant (fails on other types) (返回此变体中保存的BigDecimal值（在其他类型上失败）)
    
    Returns:
    
    BigDecimal (大十进制)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDecimalRef
```
public BigDecimal getDecimalRef()
```
    return the BigDecimal value held in this variant (fails on other types) (返回此变体中保存的BigDecimal值（在其他类型上失败）)
    
    Returns:
    
    BigDecimal (大十进制)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDispatch
```
public Dispatch getDispatch()
```
    cover for toDispatch() This method now matches other getXXX() methods. It throws an IllegalStateException if the object is not of type VariantDispatch (toDispatch（）的封面现在，此方法与其他getXXX（）方法匹配。如果对象不是VariantDispatch类型，则抛出IllegalStateException。)
    
    Returns:
    
    this object as a dispatch (此对象作为调度)
    
    Throws:
    
    IllegalStateException - if wrong variant type
  - getDispatchRef
```
public Dispatch getDispatchRef()
```
    Dispatch and dispatchRef are treated the same This is just a cover for toDispatch() with a flag check (Dispatch和dispatchRef的处理方式相同这只是toDispatch（）的封面，带有标志检查)
    
    Returns:
    
    the results of toDispatch() (toDispatch（）的结果)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDouble
```
public double getDouble()
```
    Returns:
    
    double return the double value held in this variant (fails on other types?) (double返回此变体中保留的double值（其他类型失败吗？）)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getDoubleRef
```
public double getDoubleRef()
```
    Returns:
    
    returns the double value, throws exception if not a Double type (返回double值，如果不是Double类型则抛出异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getEmpty
```
@Deprecated
public void getEmpty()
```
    Deprecated. method never did anything
    
    Pointless method that was put here so that putEmpty() has a get method. This would have returned null if the value was VT_EMPTY or if it wasn't so it would have always returned the same value. (放置在此处的无意义方法，以便putEmpty（）具有get方法。如果该值为VT_EMPTY或不是VT_EMPTY，则该返回值为null，因此它将始终返回相同的值。)
  - getError
```
public int getError()
```
    Returns:
    
    double return the error value held in this variant (fails on other types?) (double返回此变量中保存的错误值（其他类型失败吗？）)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getErrorRef
```
public int getErrorRef()
```
    Returns:
    
    returns the error value as an int, throws exception if not a Error type (以int形式返回错误值，如果不是Error类型，则引发异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getFloat
```
public float getFloat()
```
    Returns:
    
    returns the value as a float if the type is of type float (如果类型为float类型，则以float形式返回值)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getFloatRef
```
public float getFloatRef()
```
    Returns:
    
    returns the float value, throws exception if not a Float type (返回float值，如果不是Float类型则抛出异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getInt
```
public int getInt()
```
    return the int value held in this variant if it is an int or a short. Throws for other types. (如果它是int或short，则返回此变体中保存的int值。为其他类型抛出。)
    
    Returns:
    
    int contents of the windows memory (Windows内存的int内容)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getIntRef
```
public int getIntRef()
```
    get the content of this variant as an int (以int形式获取此变体的内容)
    
    Returns:
    
    int (整型)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getJavaDate
```
public Date getJavaDate()
```
    returns the windows time contained in this Variant to a Java Date. should return null if this is not a date Variant SF 959382 (将此变体中包含的Windows时间返回到Java日期。如果不是日期，则应返回null SF 959382)
    
    Returns:
    
    java.util.Date returns the date if this is a VariantDate != 0, null if it is a VariantDate == 0 and throws an IllegalStateException if this isn't a date. (如果这是VariantDate！= 0，则java.util.Date返回日期；如果这是VariantDate == 0，则返回null；如果这不是日期，则抛出IllegalStateException。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getJavaDateRef
```
public Date getJavaDateRef()
```
    returns the windows time contained in this Variant to a Java Date should return null if this is not a date reference Variant SF 959382 (将包含在此变量中的Windows时间返回给Java Date，如果它不是日期引用，则应返回null SF 959382)
    
    Returns:
    
    java.util.Date (Java.UT IL.date)
  - getLong
```
public long getLong()
```
    64 bit Longs only available on x64. 64 bit long support added 1.14 (64位长仅在x64上可用。增加了64位长支持1.14)
    
    Returns:
    
    returns the value as a long, throws exception if not a Long type.. (以long形式返回值，如果不是Long类型则抛出异常。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getLongRef
```
public long getLongRef()
```
    64 bit Longs only available on x64. 64 bit long support added 1.14 (64位长仅在x64上可用。增加了64位长支持1.14)
    
    Returns:
    
    returns the value as a long, throws exception if not a long type (以long形式返回值，如果不是long类型则抛出异常)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getNull
```
@Deprecated
public void getNull()
```
    Deprecated. method never did anything
    
    This method would have returned null if the type was VT_NULL. But because we return null if the data is not of the right type, this method should have always returned null (如果类型为VT_NULL，则此方法将返回null。但是，因为如果数据类型不正确，我们将返回null，因此此方法应始终返回null)
  - getShort
```
public short getShort()
```
    return the int value held in this variant (fails on other types?) (返回此变体中保存的int值（其他类型失败吗？）)
    
    Returns:
    
    int (整型)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getShortRef
```
public short getShortRef()
```
    get the content of this variant as an int (以int形式获取此变体的内容)
    
    Returns:
    
    int (整型)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getString
```
public String getString()
```
    Returns:
    
    string contents of the variant, null if is of type null or empty (变体的字符串内容，如果类型为null或为空，则为null)
    
    Throws:
    
    IllegalStateException - if this variant is not of type String
  - getStringRef
```
public String getStringRef()
```
    gets the content of the variant as a string ref (获取变量的内容作为字符串引用)
    
    Returns:
    
    String retrieved from the COM area. (从COM区域检索的字符串。)
    
    Throws:
    
    IllegalStateException - if variant is not of the requested type
  - getVariant
```
public Object getVariant()
```
    Used to get the value from a windows type of VT_VARIANT or a jacob Variant type of VariantVariant. Added 1.12 pre 6 - VT_VARIANT support is at an alpha level (用于从VT_VARIANT的Windows类型或VariantVariant的jacob Variant类型获取值。添加了6.12 pre 6-VT_VARIANT支持处于alpha级别)
    
    Returns:
    
    Object a java Object that represents the content of the enclosed Variant (Object一个java对象，表示包含的Variant的内容)
  - getVariantArray
```
@Deprecated
public Variant[] getVariantArray()
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Returns:
    
    never returns anything (从不返回任何东西)
    
    Throws:
    
    NotImplementedException
  - getVariantArrayRef
```
@Deprecated
public Variant[] getVariantArrayRef()
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Returns:
    
    the Variant Array that represents the data in the Variant (表示变量中数据的变量数组)
    
    Throws:
    
    NotImplementedException
  - getvt
```
public short getvt()
```
    Reports the type of the underlying Variant object (报告基础Variant对象的类型)
    
    Returns:
    
    returns the variant type as a short, one of the Variantxxx values defined as statics in this class. returns VariantNull if not initialized (以简短形式返回变量类型，这是在此类中定义为static的Variants值之一。如果未初始化，则返回Variant Null)
    
    Throws:
    
    IllegalStateException - if there is no underlying windows data structure
  - init
```
protected void init()
```
    initializes the COM Variant and puts its reference in this instance (初始化COM Variant并将其引用放入此实例)
  - isNull
```
public boolean isNull()
```
    Returns:
    
    returns true if the variant is considered null (如果变量被认为是null，则返回true)
    
    Throws:
    
    IllegalStateException - if there is no underlying windows memory
  - noParam
```
@Deprecated
public void noParam()
```
    Deprecated. replaced by putNoParam()
    
    sets the type to VT_ERROR and the error message to DISP_E_PARAMNOTFOIUND (将类型设置为VT_ERROR并将错误消息设置为DISP_E_PARAMNOTFOIUND)
  - objectIsAConstant
```
protected boolean objectIsAConstant(Variant pVariant)
```
    returns true if the passed in Variant is a constant that should not be freed (如果传入的Variant是一个不应释放的常量，则返回true)
    
    Parameters:
    
    pVariant - (-)
    
    Returns:
    
    boolean that is true if Variant is a type of constant, VT_FALSE, VT_TRUE, VT_MISSING, DEFAULT (如果Variant是常量，VT_FALSE，VT_TRUE，VT_MISSING，DEFAULT的类型，则为true的布尔值)
  - putBoolean
```
public void putBoolean(boolean in)
```
    puts a boolean into the variant and sets it's type (将布尔值放入变量中并设置其类型)
    
    Parameters:
    
    in - the new value (-新价值)
  - putBooleanRef
```
public void putBooleanRef(boolean in)
```
    pushes a boolean into the variant by ref and sets the type of the variant to boolean (通过ref将布尔值推送到变量中，并将变量的类型设置为boolean)
    
    Parameters:
    
    in - (-)
  - putByte
```
public void putByte(byte in)
```
    pushes a byte into the varaint and sets the type (向变体中推送一个字节并设置类型)
    
    Parameters:
    
    in - (-)
  - putByteArray
```
@Deprecated
public void putByteArray(Object in)
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Parameters:
    
    in - doesn't matter because this method does nothing (-没关系，因为此方法不起作用)
    
    Throws:
    
    NotImplementedException
  - putByteRef
```
public void putByteRef(byte in)
```
    pushes a byte into the variant by ref and sets the type (通过ref将字节压入变量并设置类型)
    
    Parameters:
    
    in - (-)
  - putCharArray
```
@Deprecated
public void putCharArray(Object in)
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Parameters:
    
    in - the object that would be wrapped by the Variant if this method was implemented (-如果实现了此方法，则由Variant包装的对象)
    
    Throws:
    
    NotImplementedException
  - putCurrency
```
public void putCurrency(Currency in)
```
    Puts a value in as a currency and sets the variant type. MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (将值作为货币输入并设置变量类型。 MS货币对象是64位定点数，在小数点左边15位，右边4位。)
    
    Parameters:
    
    in - the long that will be put into the 64 bit currency object. (-将放入64位货币对象中的多头。)
  - putCurrencyRef
```
public void putCurrencyRef(Currency in)
```
    Pushes a long into the variant as currency and sets the type. MS Currency objects are 64 bit fixed point numbers with 15 digits to the left and 4 to the right of the decimal place. (将长整数作为货币推送并设置类型。 MS货币对象是64位定点数，在小数点左边15位，右边4位。)
    
    Parameters:
    
    in - the long that will be put into the 64 bit currency object (-将放入64位货币对象中的多头)
  - putDate
```
public void putDate(Date inDate)
```
    converts a java date to a windows time and calls putDate(double) SF 959382 (将Java日期转换为Windows时间并调用putDate（double）SF 959382)
    
    Parameters:
    
    inDate - a Java date to be converted (-要转换的Java日期)
    
    Throws:
    
    IllegalArgumentException - if inDate = null
  - putDate
```
public void putDate(double in)
```
    puts a windows date double into the variant and sets the type (将Windows日期的double值放入变量中并设置类型)
    
    Parameters:
    
    in - (-)
  - putDateRef
```
public void putDateRef(Date inDate)
```
    converts a java date to a windows time and calls putDateRef(double) SF 959382 (将Java日期转换为Windows时间并调用putDateRef（double）SF 959382)
    
    Parameters:
    
    inDate - a Java date to be converted (-要转换的Java日期)
    
    Throws:
    
    IllegalArgumentException - if inDate = null
  - putDateRef
```
public void putDateRef(double in)
```
    set the content of this variant to a date (VT_DATE|VT_BYREF) (将此变体的内容设置为日期（VT_DATE | VT_BYREF）)
    
    Parameters:
    
    in - (-)
  - putDecimal
```
public void putDecimal(BigDecimal in)
```
    EXPERIMENTAL 1.14 feature to support rounded decimals.
    Set the value of this variant and set the type. This may throw exceptions more often than the caller expects because most callers don't manage the scale of their BigDecimal objects.
    
    This default set method throws exceptions if precision or size is out of bounds
    
    There are 12 bytes available for the integer number.
    
    There is 1 byte for the scale.
    (实验1.14功能支持四舍五入的小数。设置此变量的值并设置类型。这可能比调用者期望的更多地引发异常，因为大多数调用者都不管理其BigDecimal对象的规模。如果精度或大小超出范围，则此默认set方法将引发异常。整数有12个字节可用。标度有1个字节。)
    
    Parameters:
    
    in - the BigDecimal that will be converted to VT_DECIMAL (-将转换为VT_DECIMAL的BigDecimal)
    
    Throws:
    
    IllegalArgumentException - if the scale is > 28, the maximum for VT_DECIMAL or if there are more than 12 bytes worth the digits
  - putDecimalRef
```
public void putDecimalRef(BigDecimal in)
```
    Set the value of this variant and set the type. This may throw exceptions more often than the caller expects because most callers don't manage the scale of their BigDecimal objects.
    This default set method throws exceptions if precision or size is out of bounds
    
    There are 12 bytes available for the integer number.
    
    There is 1 byte for the scale.
    (设置此变量的值并设置类型。这可能比调用者期望的更多地引发异常，因为大多数调用者都不管理其BigDecimal对象的规模。如果精度或大小超出范围，则此默认set方法将引发异常。整数有12个字节可用。标度有1个字节。)
    
    Parameters:
    
    in - the BigDecimal that will be converted to VT_DECIMAL (-将转换为VT_DECIMAL的BigDecimal)
    
    Throws:
    
    IllegalArgumentException - if the scale is > 28, the maximum for VT_DECIMAL or if there are more than 12 bytes worth the digits
  - putDispatch
```
public void putDispatch(Dispatch in)
```
    This acts a cover for putVariant Dispatch. (这充当了putVariant Dispatch的掩护。)
    
    Parameters:
    
    in - the Dispatch we're putting down in the COM variant space. (-我们在COM变量空间中放下的Dispatch。)
  - putDispatchRef
```
public void putDispatchRef(Dispatch in)
```
    Dispatch and dispatchRef are treated the same This is a cover for putVariantDispatch(). putDispatch and putDispatchRef are treated the same because no one has written the COM code for putDispatchRef. (Dispatch和dispatchRef的处理方式相同。这是putVariantDispatch（）的封面。因为没有人为putDispatchRef编写COM代码，所以对putDispatch和putDispatchRef的处理方式相同。)
    
    Parameters:
    
    in - the Dispatch we're putting down in the COM variant space. (-我们在COM变量空间中放下的Dispatch。)
  - putDouble
```
public void putDouble(double in)
```
    wraps this Variant around the passed in double. (将此Variant包裹在传入的double中。)
    
    Parameters:
    
    in - (-)
  - putDoubleRef
```
public void putDoubleRef(double in)
```
    set the content of this variant to a double (VT_R8|VT_BYREF) (将此变量的内容设置为双精度（VT_R8 | VT_BYREF）)
    
    Parameters:
    
    in - (-)
  - putEmpty
```
public void putEmpty()
```
    sets the type to VariantEmpty (将类型设置为VariantEmpty)
  - putError
```
public void putError(int in)
```
    puts an error code (I think) into the variant and sets the type (将错误代码（我认为）放入变量并设置类型)
    
    Parameters:
    
    in - (-)
  - putErrorRef
```
public void putErrorRef(int in)
```
    pushes an error code into the variant by ref and sets the type (通过ref将错误代码推送到变量中并设置类型)
    
    Parameters:
    
    in - (-)
  - putFloat
```
public void putFloat(float in)
```
    fills the Variant with a float and sets the type to float (用浮点数填充Variant并将类型设置为float)
    
    Parameters:
    
    in - (-)
  - putFloatRef
```
public void putFloatRef(float in)
```
    pushes a float into the variant and sets the type (将float推入变量并设置类型)
    
    Parameters:
    
    in - (-)
  - putInt
```
public void putInt(int in)
```
    set the value of this variant and set the type (设置此变量的值并设置类型)
    
    Parameters:
    
    in - (-)
  - putIntRef
```
public void putIntRef(int in)
```
    set the content of this variant to an int (VT_I4|VT_BYREF) (将此变量的内容设置为int（VT_I4 | VT_BYREF）)
    
    Parameters:
    
    in - (-)
  - putLong
```
public void putLong(long in)
```
    Puts a 64 bit Java Long into a 64 bit Variant Long. Only works on x64 systems otherwise throws an error. 64 bit long support added 1.14 (将64位Java Long放入64位Variant Long中。仅适用于x64系统，否则会引发错误。增加了64位长支持1.14)
    
    Parameters:
    
    in - the long that will be put into the 64 bit Long object. (-将放入64位Long对象中的long。)
  - putLongRef
```
public void putLongRef(long in)
```
    Puts a 64 bit Java Long into a 64 bit Variant Long. Only works on x64 systems otherwise throws an error. 64 bit long support added 1.14 (将64位Java Long放入64位Variant Long中。仅适用于x64系统，否则会引发错误。增加了64位长支持1.14)
    
    Parameters:
    
    in - the long that will be put into the 64 bit Long object. (-将放入64位Long对象中的long。)
  - putNoParam
```
public void putNoParam()
```
    sets the type to VT_ERROR and the error message to DISP_E_PARAMNOTFOIUND (将类型设置为VT_ERROR并将错误消息设置为DISP_E_PARAMNOTFOIUND)
  - putNothing
```
public void putNothing()
```
    Sets the type to VariantDispatch and sets the value to null Equivalent to VB's nothing (将类型设置为VariantDispatch并将值设置为null等效于VB)
  - putNull
```
public void putNull()
```
    Set this Variant's type to VT_NULL (the VB equivalent of NULL) (将此Variant的类型设置为VT_NULL（VB等效于NULL）)
  - putObject
```
@Deprecated
public void putObject(Object in)
```
    Deprecated. should use putDispatch()
    
    Puts an object into the Variant -- converts to Dispatch. Acts as a cover for putVariantDispatch(); This primarily exists to support jacobgen. This should be deprecated. (将对象放入Variant中-转换为Dispatch。充当putVariantDispatch（）的封面；这主要是为了支持雅各布根。不建议使用。)
    
    Parameters:
    
    in - the object we are putting into the Variant, assumes a (-我们要放入Variant中的对象假设一个)
    
    See Also:
    
    putDispatch(Dispatch)
  - putObjectRef
```
@Deprecated
public void putObjectRef(Object in)
```
    Deprecated.
    
    Just a cover for putObject(). We shouldn't accept any old random object. This has been left in to support jacobgen. This should be deprecated. (只是putObject（）的封面。我们不应该接受任何旧的随机对象。这留给了雅各布根。不建议使用。)
    
    Parameters:
    
    in - (-)
  - putSafeArray
```
public void putSafeArray(SafeArray in)
```
    have no idea... (不知道...)
    
    Parameters:
    
    in - (-)
  - putSafeArrayRef
```
public void putSafeArrayRef(SafeArray in)
```
    have no idea... (不知道...)
    
    Parameters:
    
    in - (-)
  - putShort
```
public void putShort(short in)
```
    set the content of this variant to a short (VT_I2) (将此变体的内容设置为简短（VT_I2）)
    
    Parameters:
    
    in - (-)
  - putShortRef
```
public void putShortRef(short in)
```
    set the content of this variant to a short (VT_I2|VT_BYREF) (将此变量的内容设置为简短形式（VT_I2 | VT_BYREF）)
    
    Parameters:
    
    in - (-)
  - putString
```
public void putString(String in)
```
    put a string into the variant and set its type (将字符串放入变量中并设置其类型)
    
    Parameters:
    
    in - (-)
  - putStringRef
```
public void putStringRef(String in)
```
    set the content of this variant to a string (VT_BSTR|VT_BYREF) (将此变量的内容设置为字符串（VT_BSTR | VT_BYREF）)
    
    Parameters:
    
    in - (-)
  - putVariant
```
public void putVariant(Object objectToBeWrapped)
```
    Puts a variant into this variant making it type VT_VARIANT. Added 1.12 pre 6 (将一个变量放入此变量中，使其类型为VT_VARIANT。已添加1.12 pre 6)
    
    Parameters:
    
    objectToBeWrapped - A object that is to be referenced by this variant. If objectToBeWrapped is already of type Variant, then it is used. If objectToBeWrapped is not Variant then new Variant(objectToBeWrapped) is called and the result is passed into the com layer (-该变量要引用的对象。如果objectToBeWrapped已经是Variant类型，则使用它。如果objectToBeWrapped不是Variant，则将其调用并将结果传递到com层)
    
    Throws:
    
    IllegalArgumentException - if inVariant = null or if inVariant is a Varint
  - putVariantArray
```
@Deprecated
public void putVariantArray(Variant[] in)
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Parameters:
    
    in - doesn't matter because this method does nothing (-没关系，因为此方法不起作用)
    
    Throws:
    
    NotImplementedException
  - putVariantArrayRef
```
@Deprecated
public void putVariantArrayRef(Variant[] in)
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Parameters:
    
    in - the thing that would be come an array if this method was implemented (-如果实现此方法，将成为数组的东西)
    
    Throws:
    
    NotImplementedException
  - safeRelease
```
public void safeRelease()
```
    This will release the "C" memory for the Variant unless this Variant is one of the constants in which case we don't want to release the memory.
    (这将释放变量的“ C”内存，除非该变量是常量之一，在这种情况下，我们不想释放内存。)
    
    Overrides:
    
    safeRelease in class JacobObject
    
    See Also:
    
    JacobObject.safeRelease()
  - SerializationReadFromBytes
```
protected void SerializationReadFromBytes(byte[] ba)
```
    this is supposed to cause the underlying variant object struct to be rebuilt from a previously serialized byte array. (这可能会导致基础变体对象结构从以前序列化的字节数组中重建。)
    
    Parameters:
    
    ba - (-)
  - SerializationWriteToBytes
```
protected byte[] SerializationWriteToBytes()
```
    this is supposed to create a byte array that represents the underlying variant object structure (这应该创建一个字节数组，该字节数组表示基础变体对象结构)
  - toBoolean
```
@Deprecated
public boolean toBoolean()
```
    Deprecated. should be replaced by changeType() followed by getBoolean() (不推荐使用。应该由ch??angeType（）和getBoolean（）代替)
    
    Returns:
    
    the value of this variant as boolean (after possible conversion) (此变量的值作为布尔值（可能的转换后）)
  - toByte
```
@Deprecated
public byte toByte()
```
    Deprecated. should be replaced by changeType() followed by getByte()
    
    attempts to return the content of this variant as a double (after possible conversion) (尝试将此变体的内容返回为double（可能的转换后）)
    
    Returns:
    
    byte (字节)
  - toByteArray
```
@Deprecated
public Object toByteArray()
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Returns:
    
    nothing because this method is not implemented (没什么，因为没有实现此方法)
    
    Throws:
    
    NotImplementedException
  - toCharArray
```
@Deprecated
public Object toCharArray()
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Returns:
    
    never returns anything (从不返回任何东西)
    
    Throws:
    
    NotImplementedException
  - toCurrency
```
@Deprecated
public Currency toCurrency()
```
    Deprecated. should be replaced by changeType() followed by getCurrency (不推荐使用。应该由ch??angeType（）替换，再由getCurrency替换)
    
    Returns:
    
    the content of this variant as a long representing a monetary amount (此变体的内容，以long表示金额)
  - toDate
```
@Deprecated
public double toDate()
```
    Deprecated. should use changeType() followed by getDate() (不推荐使用。应该使用changeType（），然后使用getDate（）)
    
    Returns:
    
    the value of this variant as a date (after possible conversion) (此变体的值作为日期（可能转换后）)
  - toDispatch
```
public Dispatch toDispatch()
```
    Returns:
    
    the content of this variant as a Dispatch object (after possible conversion) (此变体的内容作为Dispatch对象（可能的转换后）)
  - toDouble
```
@Deprecated
public double toDouble()
```
    Deprecated. should call changeType() then getDouble() (不推荐使用。应该先调用changeType（）然后再调用getDouble（）)
    
    Returns:
    
    the content of this variant as a double (after possible conversion) (此变体的内容为两倍（可能的转换后）)
  - toEnumVariant
```
public EnumVariant toEnumVariant()
```
    Returns:
    
    the value of this variant as an enumeration (java style) (此变量的值作为枚举（java样式）)
  - toError
```
@Deprecated
public int toError()
```
    Deprecated. should use changeType() followed by getError()
    
    converts to an error type and returns the error (转换为错误类型并返回错误)
    
    Returns:
    
    the error as an int (after conversion) (作为int的错误（转换后）)
  - toFloat
```
@Deprecated
public float toFloat()
```
    Deprecated. should use changeType() and getFloat() instead
    
    attempts to return the contents of this variant as a float (after possible conversion) (尝试以浮点数形式返回此变体的内容（可能的转换之后）)
    
    Returns:
    
    float (浮动)
  - toInt
```
@Deprecated
public int toInt()
```
    Deprecated. should use changeType() followed by getInt() (不推荐使用。应该使用changeType（），然后使用getInt（）)
    
    Returns:
    
    the value of this variant as an int (after possible conversion) (此变体的值作为int（可能的转换后）)
  - toJavaDate
```
@Deprecated
public Date toJavaDate()
```
    Deprecated. callers should use getDate()
    
    Returns the windows time contained in this Variant as a Java Date converts to a date like many of the other toXXX() methods SF 959382.
    This method added 12/2005 for possible use by jacobgen instead of its conversion code
    
    This does not convert the data
    (返回此Variant中包含的Windows时间，因为Java Date转换为与其他toXXX（）方法SF 959382一样的日期。此方法添加了12/2005，供jacobgen可能使用，而不是其转换代码。此方法不转换数据)
    
    Returns:
    
    java.util.Date version of this variant if it is a date, otherwise null (此变体的java.util.Date版本（如果是日期），否则为null)
  - toJavaObject
```
public Object toJavaObject()
                    throws JacobException
```
    Convert a JACOB Variant value to a Java object (type conversions). provided in Sourceforge feature request 959381. See JavaVariantConverter..convertVariantTJavaObject(Variant) for more information. (将JACOB Variant值转换为Java对象（类型转换）。在Sourceforge功能请求959381中提供。请参见JavaVariantConverter..convertVariantTJavaObject（Variant）了解更多信息。)
    
    Returns:
    
    Corresponding Java object of the type matching the Variant type. (匹配Variant类型的对应Java对象。)
    
    Throws:
    
    IllegalStateException - if no underlying windows data structure
    
    NotImplementedException - if unsupported conversion is requested
    
    JacobException - if the calculated result was a JacobObject usually as a result of error
  - toObject
```
@Deprecated
public Object toObject()
```
    Deprecated. this is a cover for toDispatch();
    
    Acts a a cover for toDispatch. This primarily exists to support jacobgen. (充当toDispatch的封面。这主要是为了支持雅各布根。)
    
    Returns:
    
    Object returned by toDispatch() (toDispatch（）返回的对象)
    
    See Also:
    
    instead
  - toSafeArray
```
public SafeArray toSafeArray()
```
    By default toSafeArray makes a deep copy due to the fact that this Variant owns the embedded SafeArray and will destroy it when it gc's calls toSafeArray(true). (默认情况下，由于该Variant拥有嵌入式SafeArray，并且在gc调用toSafeArray（true）时会销毁它，因此toSafeArray进行深度复制。)
    
    Returns:
    
    the object converted to a SafeArray (将对象转换为SafeArray)
  - toSafeArray
```
public SafeArray toSafeArray(boolean deepCopy)
```
    This lets folk turn into a safe array without a deep copy. Should this API be public? (这样一来，人们就可以在不进行深层复制的情况下变成安全的阵列。此API应该公开吗？)
    
    Parameters:
    
    deepCopy - (-)
    
    Returns:
    
    SafeArray constructed (构造SafeArray)
  - toScriptObject
```
@Deprecated
public Object toScriptObject()
```
    Deprecated.
    
    I don't know what this is. Is it some legacy (pre 1.8) thing? (我不知道这是什么这是旧版（1.8版之前）的东西吗？)
    
    Returns:
    
    this object as a dispatch object by calling toDispatch() (通过调用toDispatch（）将此对象作为调度对象)
  - toShort
```
@Deprecated
public short toShort()
```
    Deprecated. callers should use changeType() followed by getShort()
    
    attempts to return the contents of this Variant as a short (after possible conversion) (尝试以简短形式返回此Variant的内容（可能的转换之后）)
    
    Returns:
    
    short (短)
  - toString
```
public String toString()
```
    This method now correctly implements java toString() semantics Attempts to return the content of this variant as a string
    - "not initialized" if not initialized
    - "null" if VariantEmpty,
    - "null" if VariantError
    - "null" if VariantNull
    - "null" if Variant type didn't convert. This can happen for date conversions where the returned value was 0.
    - the value if we know how to describe one of that type
    - three question marks if can't convert
    (此方法现在可以正确实现java toString（）语义尝试将此变体的内容作为字符串“未初始化”返回（如果未初始化），如果VariantEmpty为“ null”，如果VariantError为“ null”，如果VariantError为“ null”，如果VariantNull，为“ null”，如果Variant类型没有转换。对于返回的值为0的日期转换，可能会发生这种情况。该值，如果我们知道如何描述该类型的三个问号（如果无法转换）)
    Overrides:
    
    toString in class Object
    
    Returns:
    
    String value conversion, (字符串值转换，)
    
    Throws:
    
    IllegalStateException - if there is no underlying windows data structure
  - toVariant
```
@Deprecated
public Variant toVariant()
```
    Deprecated. superseded by "this"
    
    Exists to support jacobgen. This would be deprecated if it weren't for jacobgen (存在以支持雅各布根。如果不是雅各布根，将不推荐使用此方法)
    
    Returns:
    
    this same object (同一对象)
  - toVariantArray
```
@Deprecated
public Variant[] toVariantArray()
```
    Deprecated. superseded by SafeArray (不推荐使用。被SafeArray取代)
    
    Returns:
    
    nothing because this method is not implemented (没什么，因为没有实现此方法)
    
    Throws:
    
    NotImplementedException
  - VariantClear
```
public void VariantClear()
```
    Clear the content of this variant (清除此变体的内容)

Class Variant

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.jacob.com.JacobObject

Methods inherited from class java.lang.Object

Field Detail

DEFAULT

VT_MISSING

VT_TRUE

VT_FALSE

VariantEmpty

VariantNull

VariantShort

VariantInt

VariantFloat

VariantDouble

VariantCurrency

VariantDate

VariantString

VariantDispatch

VariantError

VariantBoolean

VariantVariant

VariantObject

VariantDecimal

VariantByte

VariantLongInt

VariantPointer

VariantTypeMask

VariantArray

VariantByref

Constructor Detail

Variant

Variant

Variant

Variant

Variant

Variant

Variant

Variant

Variant

Variant

Method Detail

changeType

clone

cloneIndirect

finalize

getBoolean

getBooleanRef

getByte

getByteRef

getCurrency

getCurrencyRef

getDate

getDateRef

getDecimal

getDecimalRef

getDispatch

getDispatchRef

getDouble

getDoubleRef

getEmpty

getError

getErrorRef

getFloat

getFloatRef

getInt

getIntRef

getJavaDate

getJavaDateRef

getLong

getLongRef

getNull

getShort

getShortRef

getString

getStringRef

getVariant

getVariantArray