次の方法で共有


xlCoerce

適用対象: Excel 2013 | Office 2013 | Visual Studio

XLOPER/ XLOPER12 の型を別の型に変換するか、シートのセルの値を検索します。

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

パラメーター

pxSource

変換対象のソース XLOPER/ XLOPER12

pxDestType (xltypeInt)

(省略可能)。 受け入れ可能な変換後の型のビット マスク。 ビット単位の OR 演算子 ( | ) を使用して、複数の使用可能な型を指定します。 この引数を省略すると、単一セルへの参照が xltypeStrxltypeNumxltypeBoolxltypeErrxltypeNil (参照先セルが空の場合) の値型のいずれかに変換され、セルのブロックへの参照は xltypeMulti に変換されます。 これにより xlCoerce はセル値を検索する最も便利な方法になります。

プロパティ値/戻り値

強制変換された値 (xltypeStrxltypeNumxltypeBoolxltypeErrxltypeNil、または xltypeMulti) を返します。

注釈

xlCoercexltypeBigData または 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;
}

関連項目

xlSet

DLL または XLL からのみ呼び出し可能な C API 関数