xlCoerce
適用対象: Excel 2013 | Office 2013 | Visual Studio
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;
}