適用於:Excel 2013 |Office 2013 |Visualstudio
將一種 類型的 XLOPER/ XLOPER12 轉換成另一種類型,或查閱工作表上的儲存格值。
Excel12(xlCoerce, LPXLOPER12 pxRes, 2, LPXLOPER12 pxSource, LPXLOPER12 pxDestType);
參數
pxSource
需要轉換的來源 XLOPER/ XLOPER12 。
pxDestType (xltypeInt)
(選擇性) 。 您願意接受之結果型別的位掩碼。 您應該使用位 OR 運算子 ( |) 指定多個可能的類型。 如果省略這個自變數,如果參考的單元格是空的) ,則會將單一單元格的參考轉換成其中一個實值類型 xltypeStr、 xltypeNum、 xltypeBool、 xltypeErr、 xltypeNil (,而單元格區塊的參考則會轉換成 xltypeMulti。 這可讓 xlCoerce 成為查閱儲存格值最方便的方式。
屬性值/傳回值
傳回強制型值 (xltypeStr、 xltypeNum、 xltypeBool、 xltypeErr、 xltypeNil 或 xltypeMulti) 。
註解
xlCoerce 無法轉換成或轉換成 xltypeBigData 或 xltypeFlow。 將 xltypeMissing 或 xltypeNil 類型傳遞為 pxDestType 相當於省略自變數。 在某些情況下,轉換可能會失敗。 例如,某些字串無法轉換成數位,而其他字串則可以。
如果陣列或多儲存格參考轉換成單一實值類型,則結果會是左上方儲存格或陣列專案的值。
範例
您可以在 中 \SAMPLES\EXAMPLE\EXAMPLE.C
找到下列程序代碼。
注意事項
xlcAlert 函式會隱含地嘗試將其自變數轉換成字元串,以便實際上可以移除此處顯示的強制型轉步驟,而且 xInt 可以直接傳遞至 xlcAlert。 由於 xlcAlert 是命令宏,因此只有在從宏表呼叫時,此程式代碼才能正確運作。
short WINAPI xlCoerceExample(short iVal)
{
XLOPER12 xStr, xInt, xDestType;
xInt.xltype = xltypeInt;
xInt.val.w = iVal;
xDestType.xltype = xltypeInt;
xDestType.val.w = xltypeStr;
Excel12f(xlCoerce, &xStr, 2, (LPXLOPER12)&xInt, (LPXLOPER12)&xDestType);
Excel12f(xlcAlert, 0, 1, (LPXLOPER12)&xStr);
Excel12f(xlFree, 0, 1, (LPXLOPER12)&xStr);
return 1;
}