PropertyContext 類別含有用以取得和設定內容的函數。這些函數可運作在可含有內容的任何物件上。
除了 ErrorBlock、Iterator 和 Property 物件外, 所有物件都可含有內容。
函數 | 說明 |
---|---|
xmsGetBooleanProperty | 取得名稱所識別之 Boolean 內容的值。 |
xmsGetByteArrayProperty | 取得名稱所識別之位元組陣列內容的值。 |
xmsGetByteArrayPropertyByRef | 取得名稱所識別之位元組陣列內容值的指標。 |
xmsGetByteProperty | 取得名稱所識別之位元組內容的值。 |
xmsGetCharProperty | 取得名稱所識別之二位元組字元內容的值。 |
xmsGetDoubleProperty | 取得名稱所識別之倍精準度浮點數內容的值。 |
xmsGetFloatProperty | 取得名稱所識別之浮點數內容的值。 |
xmsGetHandleTypeId | 取得物件的控點類型。 |
xmsGetIntProperty | 取得名稱所識別之整數內容的值。 |
xmsGetLongProperty | 取得名稱所識別之長整數內容的值。 |
xmsGetObjectProperty | 取得名稱所識別之內容的值和資料類型。 |
xmsGetProperty | 取得名稱所識別之內容的 Properties 物件。 |
xmsGetShortProperty | 取得名稱所識別之短整數內容的值。 |
xmsGetStringProperty | 取得名稱所識別之字串內容的值。 |
xmsGetStringPropertyByRef | 取得名稱所識別之字串內容值的指標。 |
xmsSetBooleanProperty | 設定名稱所識別之 Boolean 內容的值。 |
xmsSetByteProperty | 設定名稱所識別之位元組內容的值。 |
xmsSetByteArrayProperty | 設定名稱所識別之位元組陣列內容的值。 |
xmsSetCharProperty | 設定名稱所識別之二位元組字元內容的值。 |
xmsSetDoubleProperty | 設定名稱所識別之倍精準度浮點數內容的值。 |
xmsSetFloatProperty | 設定名稱所識別之浮點數內容的值。 |
xmsSetIntProperty | 設定名稱所識別之整數內容的值。 |
xmsSetLongProperty | 設定名稱所識別之長整數內容的值。 |
xmsSetObjectProperty | 設定名稱所識別之內容的值和資料類型。 |
xmsSetProperty | 使用 Properties 物件來設定內容的值。 |
xmsSetShortProperty | 設定名稱所識別之短整數內容的值。 |
xmsSetStringProperty | 設定名稱所識別之字串內容的值。 |
xmsRC xmsGetBooleanProperty(xmsHObj object, xmsCHAR *propertyName, xmsBOOL *propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsGetByteArrayProperty(xmsHObj object xmsCHAR *propertyName, xmsSBYTE *propertyValue, xmsINT length, xmsINT *actualLength xmsHErrorBlock errorBlock) const;
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回位元組陣列的 C 函數。
xmsRC xmsGetByteArrayPropertyByRef(xmsHObj object xmsCHAR *propertyName, xmsSBYTE **propertyValue, xmsINT *length, xmsHErrorBlock errorBlock) const;
如需如何使用此函數的相關資訊, 請參閱會以參照形式來傳回字串或位元組陣列的 C 函數。
xmsRC xmsGetCharProperty(xmsHObj object, xmsCHAR *propertyName, xmsCHAR16 *propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsGetDoubleProperty(xmsHObj object, xmsCHAR *propertyName, xmsDOUBLE *propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsGetHandleTypeId(xmsHObj object, xmsHANDLE_TYPE *handleType, xmsHErrorBlock errorBlock);
xmsRC xmsGetObjectProperty(xmsHObj object, xmsCHAR *propertyName, xmsSBYTE *propertyValue, xmsINT length, xmsINT *actualLength, xmsOBJECT_TYPE *objectType, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回位元組陣列的 C 函數。
xmsRC xmsGetProperty(xmsHObj object, xmsCHAR *propertyName, xmsHProperty *property, xmsHErrorBlock errorBlock);
xmsRC xmsGetStringProperty(xmsHObj object, xmsCHAR *propertyName, xmsCHAR *propertyValue, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。
xmsRC xmsMsgGetStringPropertyByRef(xmsHObj object, xmsCHAR *propertyName, xmsCHAR **propertyValue, xmsINT *length, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以參照形式來傳回字串或位元組陣列的 C 函數。
請注意,內容值必須是一個字串。函數不會試著將另一種資料類型的值轉換成字串。如果應用程式呼叫此函數以取得非字串值的指標, 則 XMS 會傳回 XMS_E_TYPE_CONVERSION_FAILED 錯誤碼。
xmsRC xmsSetBooleanProperty(xmsHObj object, xmsCHAR *propertyName, xmsBOOL propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetByteProperty(xmsHObj object, xmsCHAR *propertyName, xmsSBYTE propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetByteArrayProperty(xmsHObj object, xmsCHAR *propertyName, xmsSBYTE *propertyValue, xmsINT length xmsHErrorBlock errorBlock);
xmsRC xmsSetCharProperty(xmsHObj object, xmsCHAR *propertyName, xmsCHAR16 propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetDoubleProperty(xmsHObj object, xmsCHAR *propertyName, xmsDOUBLE propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetFloatProperty(xmsHObj object, xmsCHAR *propertyName, xmsFLOAT propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetIntProperty(xmsHObj object, xmsCHAR *propertyName, xmsINT propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetLongProperty(xmsHObj object, xmsCHAR *propertyName, xmsLONG propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetObjectProperty(xmsHObj object, xmsCHAR *propertyName, xmsSBYTE *propertyValue, xmsINT length, xmsOBJECT_TYPE objectType, xmsHErrorBlock errorBlock);
xmsRC xmsSetShortProperty(xmsHObj object, xmsCHAR *propertyName, xmsSHORT propertyValue, xmsHErrorBlock errorBlock);
xmsRC xmsSetStringProperty(xmsHObj object, xmsCHAR *propertyName, xmsCHAR *propertyValue, xmsINT length, xmsHErrorBlock errorBlock);