Difference between revisions of "EN/Documentation/BASIC Guide/Structure of Spreadsheets"

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{DISPLAYTITLE:表計算ドキュメントの構造}} {{EN/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Spreadsheets |NextPage...)
 
Line 1: Line 1:
−
{{DISPLAYTITLE:表計算ドキュメントの構造}}
+
{{DISPLAYTITLE:Struttura dei fogli elettronici}}
 
{{EN/Documentation/BASICGuideTOC/v2
 
{{EN/Documentation/BASICGuideTOC/v2
 
|ShowPrevNext=block
 
|ShowPrevNext=block
Line 8: Line 8:
 
}}
 
}}
 
   
 
   
−
表計算ドキュメントのドキュメントオブジェクトは、<idl>com.sun.star.sheet.SpreadsheetDocument</idl> サービスをベースにしています。▼通常これらのドキュメントには、複数の\'95\'5c (スプレッドシート) があります。マニュアルで使う用語として、表計算ドキュメント は 1 つのドキュメント全体を意味するものとし、スプレッドシート (略称: シート) は各ドキュメントを構成する個々の表 (テーブル) を意味するものとします。
+
L'oggetto documento di un foglio elettronico si basa sul servizio <idl>com.sun.star.sheet.SpreadsheetDocument</idl>. Ognuno di tali documenti può contenere diversi fogli elettronici. Nel presente manuale, per documento basato su tabelle o foglio elettronico si intende l'intero documento, mentre per tabella si intende una
 +
singola tabella del documento.
  
−
{{Documentation/Note|VBA と {{OOo}} Basic では、スプレッドシートとスプレッドシートの内容に対して、異なった用語が使用されています。VBA のドキュメントオブジェクトは Workbook、個々のページは Worksheets と呼ばれますが、{{OOo}} Basic の場合は SpreadsheetDocument および Sheet と呼ばれています。}}
+
{{Documentation/Note|VBA e {{OOo}} Basic utilizzano una terminologia diversa per i fogli elettronici e il relativo contenuto. In VBA l'oggetto documento è denominato cartella di lavoro, mentre le singole pagine che lo compongono sono denominate fogli di lavoro, mentre in {{OOo}} Basic tali elementi sono denominati rispettivamente foglio elettronico e tabella.}}
  
−
==▼スプレッドシート==
+
== Fogli elettronici ==
  
−
表計算ドキュメントの各シートにアクセスするには、<tt>Sheets</tt> リストを使用します。
+
Potete accedere alle singole tabelle di un foglio elettronico tramite l'elenco <tt>Sheets</tt>.
  
−
▼以下の 2 つのサンプルコードでは、それぞれ番号および名前を使って各シートへアクセスする方法を示します。
+
Gli esempi seguenti mostrano come accedere a una tabella tramite il relativo numero o nome.
  
−
'''▼例 1: 番号によるアクセス (開始値は 0)'''
+
'''Esempio 1: accesso tramite il numero (la numerazione inizia da 0)'''
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 28: Line 29:
 
</source>
 
</source>
  
−
'''▼例 2: 名前によるアクセス'''
+
'''Esempio 2: accesso tramite il nome'''
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 38: Line 39:
 
</source>
 
</source>
  
−
▼最初のサンプルコードでは、シートへのアクセスを番号指定で行なっています (開始値は 0)。▼次のサンプルコードでは、<tt>getByName</tt> メ\'83\'5cッドにシート名を指定してアクセスしています。
+
Nel primo esempio, si accede alla tabella mediante il rispettivo numero. Il conteggio inizia da 0. Nel secondo esempio, si accede alla tabella utilizzando il rispettivo nome e il metodo <tt>getByName</tt>.
  
−
<tt>Sheet</tt> メソッドで取得される <tt>getByName</tt> というオブジェクトは、<idl>com.sun.star.sheet.Spreadsheet</idl> サービスをサポートしています。▼このサービスは、シート編集用の各種インターフェースを提供するもので、以下の属性を利用できます。
+
L'oggetto <tt>Sheet</tt> ottenuto tramite il metodo <tt>getByName</tt> supporta il servizio <idl>com.sun.star.sheet.Spreadsheet</idl>. Oltre a fornire diverse interfacce per la modifica dei contenuti, il servizio fornisce le proprietà seguenti:
  
−
;<tt>IsVisible (Boolean)</tt>:スプレッドシートを表示する指定。
+
;<tt>IsVisible (Boolean)</tt>:Il foglio elettronico è visibile.
−
;<tt>PageStyle (String)</tt>:スプレッドシート用のページテンプレートの名前。
+
;<tt>PageStyle (String)</tt>:Nome del modello di pagina per il foglio elettronico.
  
−
===▼シートの作成、削除、名前の変更===
+
=== Creazione, eliminazione e ridenominazione dei fogli ===
  
−
<tt>Sheets</tt> ドキュメントの <tt>spreadsheet</tt> リストは、個々のシートの作成、削除、名前の変更にも使用します。▼以下のサンプルコードでは、<tt>hasByName</tt> メ\'83\'5cッドを用いて '''MySheet''' という名前のシートが存在するかをチェックします。そうした名前のシートが存在する場合、<tt>getByName</tt> メソッドを用いて該当オブジェクトへの参照を取得して、<tt>Sheet</tt> という変数に収めます。該当するシートが存在しない場合は、<tt>createInstance</tt> メソッドを用いてこれを新規作成して、<tt>insertByName</tt> メソッドにより表計算ドキュメントに挿入します。
+
L'elenco <tt>Sheets</tt> di un documento <tt>spreadsheet</tt> viene  utilizzato anche per creare,
 +
eliminare e rinominare singole tabelle. L'esempio seguente si avvale del metodo <tt>hasByName</tt> per verificare se esiste una tabella denominata '''MySheet'''. In caso affermativo, il metodo determina un riferimento dell'oggetto corrispondente utilizzando il metodo <tt>getByName</tt>, quindi salva il riferimento in una variabile in <tt>Sheet</tt>. Se invece la tabella corrispondente non esiste, viene creata dalla chiamata <tt>createInstance</tt> e inserita nel foglio elettronico tramite il metodo <tt>insertByName</tt>.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 64: Line 66:
 
</source>
 
</source>
  
−
「<tt>getByName API について</tt>」で説明したように、<tt>insertByName</tt> および  [[Documentation/BASIC Guide/API Intro|Documentation/BASIC Guide/API Intro]] メソッドは <idl>com.sun.star.container.XnameContainer</idl> インターフェースから提供されています。
+
I metodi <tt>getByName</tt> e <tt>insertByName</tt> derivano dall'interfaccia <idl>com.sun.star.container.XnameContainer</idl>, come descritto in [[Documentation/BASIC Guide/API Intro|Introduzione all'API]].
  
 
{{PDL1}}
 
{{PDL1}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Structure of Spreadsheets}}

Revision as of 18:21, 25 June 2009

Template:EN/Documentation/BASICGuideTOC/v2

L'oggetto documento di un foglio elettronico si basa sul servizio com.sun.star.sheet.SpreadsheetDocument. Ognuno di tali documenti può contenere diversi fogli elettronici. Nel presente manuale, per documento basato su tabelle o foglio elettronico si intende l'intero documento, mentre per tabella si intende una singola tabella del documento.

Template:Documentation/Note

Fogli elettronici

Potete accedere alle singole tabelle di un foglio elettronico tramite l'elenco Sheets.

Gli esempi seguenti mostrano come accedere a una tabella tramite il relativo numero o nome.

Esempio 1: accesso tramite il numero (la numerazione inizia da 0) 

Dim Doc As Object
Dim Sheet As Object
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets (0)

Esempio 2: accesso tramite il nome 

Dim Doc As Object
Dim Sheet As Object
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets.getByName("Sheet 1")

Nel primo esempio, si accede alla tabella mediante il rispettivo numero. Il conteggio inizia da 0. Nel secondo esempio, si accede alla tabella utilizzando il rispettivo nome e il metodo getByName.

L'oggetto Sheet ottenuto tramite il metodo getByName supporta il servizio com.sun.star.sheet.Spreadsheet. Oltre a fornire diverse interfacce per la modifica dei contenuti, il servizio fornisce le proprietà seguenti:

IsVisible (Boolean)
Il foglio elettronico è visibile.
PageStyle (String)
Nome del modello di pagina per il foglio elettronico.

Creazione, eliminazione e ridenominazione dei fogli

L'elenco Sheets di un documento spreadsheet viene utilizzato anche per creare, eliminare e rinominare singole tabelle. L'esempio seguente si avvale del metodo hasByName per verificare se esiste una tabella denominata MySheet. In caso affermativo, il metodo determina un riferimento dell'oggetto corrispondente utilizzando il metodo getByName, quindi salva il riferimento in una variabile in Sheet. Se invece la tabella corrispondente non esiste, viene creata dalla chiamata createInstance e inserita nel foglio elettronico tramite il metodo insertByName. 

Dim Doc As Object
Dim Sheet As Object
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets(0)
 
If Doc.Sheets.hasByName("MySheet") Then
   Sheet = Doc.Sheets.getByName("MySheet")
Else
   Sheet = Doc.createInstance("com.sun.star.sheet.Spreadsheet")
   Doc.Sheets.insertByName("MySheet", Sheet)
End If

I metodi getByName e insertByName derivano dall'interfaccia com.sun.star.container.XnameContainer, come descritto in Introduzione all'API.

Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=EN/Documentation/BASIC_Guide/Structure_of_Spreadsheets&oldid=133062"
Personal tools