最終更新日 :
2025年3月31日
説明
スプレッドシートのヘッダーに画像を追加します。ヘッダーの画像がスプレッドシート印刷プレビューに表示されます。
戻り値
なし
履歴
- ColdFusion（2025 リリース）：関数が追加されました。
シンタックス
spreadsheetSetHeaderImage(spreadsheetObject, byte[] imageData, String alignment, String imageType)
spreadsheetSetHeaderImage(spreadsheetObject,String image, String alignment)
spreadsheetSetHeaderImage(spreadsheetObject, byte[] imageData, String alignment, String imageType)
spreadsheetSetHeaderImage(spreadsheetObject,String image, String alignment)
spreadsheetSetHeaderImage(spreadsheetObject, byte[] imageData, String alignment, String imageType) spreadsheetSetHeaderImage(spreadsheetObject,String image, String alignment)
警告：
シートでは、ヘッダーに画像を 1 つだけ配置できます。既に画像が存在する場合に 2 番目の画像を追加すると、例外がトリガーされます。
パラメーター
名前
|
必須
|
Type
|
説明
|
spreadSheetObject
|
はい
|
ExcelInfo
|
ヘッダー画像を追加する Excel スプレッドシートオブジェクトです。
|
alignment
|
はい
|
文字列
|
ヘッダーの画像の配置です。値は left、center、または right です。
|
image
|
はい
|
CFImage
|
ColdFusion イメージオブジェクトです。サポートされている画像形式は jpg／jpeg または png です。
|
例 1 - image オブジェクトの使用
<cfscript>
myImage=imageNew("",200,50)
imageSetDrawingColor(myImage,"yellow")
imageSetAntialiasing(myImage,"on")
imageDrawRect(myImage,80,25,50,30,"yes")
</cfscript>
<cfquery name="art" datasource="cfartgallery">
SELECT * FROM ART
</cfquery>
<cfscript>
theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-object.xls";
// スプレッドシートオブジェクトを作成します
theSheet=spreadsheetNew("SampleData",true)
// テーブルからスプレッドシートに行を追加します
spreadsheetAddRows(theSheet,art)
spreadsheetSetHeaderImage(spreadsheet = theSheet,
image = myImage,
alignment = 'center',
imagetype = 'png')
// スプレッドシートに書き込みます
spreadsheetWrite(theSheet,theFile,"yes")
</cfscript>
<cfscript>
myImage=imageNew("",200,50)
imageSetDrawingColor(myImage,"yellow")
imageSetAntialiasing(myImage,"on")
imageDrawRect(myImage,80,25,50,30,"yes")
</cfscript>
<cfquery name="art" datasource="cfartgallery">
SELECT * FROM ART
</cfquery>
<cfscript>
theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-object.xls";
// スプレッドシートオブジェクトを作成します
theSheet=spreadsheetNew("SampleData",true)
// テーブルからスプレッドシートに行を追加します
spreadsheetAddRows(theSheet,art)
spreadsheetSetHeaderImage(spreadsheet = theSheet,
image = myImage,
alignment = 'center',
imagetype = 'png')
// スプレッドシートに書き込みます
spreadsheetWrite(theSheet,theFile,"yes")
</cfscript>
<cfscript> myImage=imageNew("",200,50) imageSetDrawingColor(myImage,"yellow") imageSetAntialiasing(myImage,"on") imageDrawRect(myImage,80,25,50,30,"yes") </cfscript> <cfquery name="art" datasource="cfartgallery"> SELECT * FROM ART </cfquery> <cfscript> theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-object.xls"; // スプレッドシートオブジェクトを作成します theSheet=spreadsheetNew("SampleData",true) // テーブルからスプレッドシートに行を追加します spreadsheetAddRows(theSheet,art) spreadsheetSetHeaderImage(spreadsheet = theSheet, image = myImage, alignment = 'center', imagetype = 'png') // スプレッドシートに書き込みます spreadsheetWrite(theSheet,theFile,"yes") </cfscript>
例 1 - ファイルパスの使用
<cfquery name="art" datasource="cfartgallery">
SELECT * FROM ART
</cfquery>
<cfscript>
theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-image.xls"
theImage=GetDirectoryFromPath(GetCurrentTemplatePath()) &"Images/pngImage.png"
// スプレッドシートオブジェクトを作成します
theSheet=spreadsheetNew("SampleData",true)
// テーブルからスプレッドシートに行を追加します
spreadsheetAddRows(theSheet,art)
spreadsheetSetHeaderImage(spreadsheet = theSheet,
image = theImage,
alignment = 'center')
// スプレッドシートに書き込みます
spreadsheetWrite(theSheet,theFile,"yes")
</cfscript>
<cfquery name="art" datasource="cfartgallery">
SELECT * FROM ART
</cfquery>
<cfscript>
theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-image.xls"
theImage=GetDirectoryFromPath(GetCurrentTemplatePath()) &"Images/pngImage.png"
// スプレッドシートオブジェクトを作成します
theSheet=spreadsheetNew("SampleData",true)
// テーブルからスプレッドシートに行を追加します
spreadsheetAddRows(theSheet,art)
spreadsheetSetHeaderImage(spreadsheet = theSheet,
image = theImage,
alignment = 'center')
// スプレッドシートに書き込みます
spreadsheetWrite(theSheet,theFile,"yes")
</cfscript>
<cfquery name="art" datasource="cfartgallery"> SELECT * FROM ART </cfquery> <cfscript> theFile=GetDirectoryFromPath(GetCurrentTemplatePath()) & "art-header-image.xls" theImage=GetDirectoryFromPath(GetCurrentTemplatePath()) &"Images/pngImage.png" // スプレッドシートオブジェクトを作成します theSheet=spreadsheetNew("SampleData",true) // テーブルからスプレッドシートに行を追加します spreadsheetAddRows(theSheet,art) spreadsheetSetHeaderImage(spreadsheet = theSheet, image = theImage, alignment = 'center') // スプレッドシートに書き込みます spreadsheetWrite(theSheet,theFile,"yes") </cfscript>
