共用方式為


xlCoerce

適用於:Excel 2013 |Office 2013 |Visualstudio

將一種 類型的 XLOPER/ XLOPER12 轉換成另一種類型,或查閱工作表上的儲存格值。

Excel12(xlCoerce, LPXLOPER12 pxRes, 2, LPXLOPER12 pxSource, LPXLOPER12 pxDestType);

參數

pxSource

需要轉換的來源 XLOPER/ XLOPER12

pxDestType (xltypeInt)

(選擇性) 。 您願意接受之結果型別的位掩碼。 您應該使用位 OR 運算子 ( |) 指定多個可能的類型。 如果省略這個自變數,如果參考的單元格是空的) ,則會將單一單元格的參考轉換成其中一個實值類型 xltypeStrxltypeNumxltypeBoolxltypeErrxltypeNil (,而單元格區塊的參考則會轉換成 xltypeMulti。 這可讓 xlCoerce 成為查閱儲存格值最方便的方式。

屬性值/傳回值

傳回強制型值 (xltypeStrxltypeNumxltypeBoolxltypeErrxltypeNilxltypeMulti) 。

註解

xlCoerce 無法轉換成或轉換成 xltypeBigDataxltypeFlow。 將 xltypeMissingxltypeNil 類型傳遞為 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;
}

另請參閱

xlSet

只能從 DLL 或 XLL 呼叫的 C API 函式