Top > OOoBasic > Calc > sheetcellranges

セル範囲コンテナ Edit

セル範囲コンテナはセル範囲もしくはセルを複数含むことができるコンテナです。サービス名は com.sun.star.sheet.SheetCellRanges です。

セル範囲コンテナのメソッド以外に、セル範囲のプロパティとメソッドを利用することができます。

このコンテナオブジェクトは離れたセルをまとめて処理する時などに利用できます。

要素 Edit

hasElements メソッドでコンテナオブジェクトに要素があるかどうか調べることができます。

getCount で要素数を取得できます。

名前によるアクセス Edit

名前がつけられていない範囲ばかりのときには使用できません。

インデックスアクセス Edit

セル範囲コンテナオブジェクトでは com.sun.star.container.XIndexAccess などのインターフェースがサポートされていないため、インデックスによるアクセスは利用できません。

列挙によるアクセス Edit

createEnumeration メソッドを利用します。この場合には、要素はセル範囲またはセルのどちらかになります。

getCells メソッドを利用した場合にもさらに createEnumeration メソッドを呼び出します。

セルクエリーなどのメソッドで取得したセル範囲コンテナオブジェクトのすべての要素にアクセスする場合には列挙によってのみ行えます。

範囲内の検索と置換 Edit

シートセル範囲コンテナ中のセルから検索と置換ができます。これを利用すると特定の範囲内のみ検索と置換が行えます。

Sub sheetcellranges_5
  oDoc = ThisComponent
  oSheet = oDoc.getSheets().getByIndex(0)
  oRange = oSheet.getCellRangeByPosition(0,0,0,3)
  
  oRanges = oDoc.createInstance("com.sun.star.sheet.SheetCellRanges")
  oRanges.insertByName("range_1",oRange)
  
  oReplaceDesc = oRanges.createReplaceDescriptor()
  oReplaceDesc.setSearchString("A")
  oReplaceDesc.setReplaceString("1")
  
  oRanges.replaceAll(oReplaceDesc)
End Sub

Reload   New Lower page making Edit Freeze Diff Upload Copy Rename   Front page List of pages Search Recent changes Backup   Help   RSS of recent changes