Difference between revisions of "EN/Documentation/BASIC Guide/Formatting Spreadsheet Documents"

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{EN/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Cells and Ranges |NextPage=Documentation/BASIC Guide/Editing Spreadsheet Doc...)
 
Line 6: Line 6:
 
|spread=block
 
|spread=block
 
}}
 
}}
−
{{DISPLAYTITLE: 表計算ド ュメントの書式設定}}
+
{{DISPLAYTITLE:Formattazione dei fogli elettronici}}
 
   
 
   
−
▼\'95\'5c計算ドキュメントには、セルおよびページ単位での書式設定を行うための属性とメ\'83\'5cッドが用意されています。
+
Un foglio elettronico dispone di proprietà e metodi per formattare celle e pagine.
  
−
==▼セル属性==
+
== Proprietà delle celle ==
  
−
▼セルの書式設定としては、\'95\'5c示フォントの種類やサイズなど、各種の項目が存在します。個々のセルは <idl>com.sun.star.style.CharacterProperties</idl> および <idl>com.sun.star.style.ParagraphProperties</idl> サービスをサポートしていますが、これらが使用する主要な属性については[[Documentation/BASIC Guide/Text Documents| 「文書ドキュメント ]]で説明しています。また特殊なセル書式については、<idl>com.sun.star.table.CellProperties</idl> サービスで処理します。▼このサービスで使用する主要な属性については、以下の節で説明します。
+
Esistono numerose opzioni per formattare le celle: è ad esempio possibile specificare tipo e dimensioni carattere per il testo. Ogni cella supporta i servizi <idl>com.sun.star.style.CharacterProperties</idl> e <idl>com.sun.star.style.ParagraphProperties</idl>, le cui proprietà principali sono descritte in [[Documentation/BASIC Guide/Text Documents|Documenti di testo]]. La formattazione speciale delle celle è gestita dal servizio <idl>com.sun.star.table.CellProperties</idl>, le cui proprietà principali sono descritte nelle sezioni seguenti.
  
−
▼これらの属性は、個々のセルおよびセル範囲に対して指定できます。
+
Tutte le proprietà si possono applicare sia a singole celle che a intervalli di celle.
  
−
{{Documentation/Note|{{}}OOo API の <tt>CellProperties</tt> オブジェクトは、VBA の <tt>Interior</tt> オブジェクトに相当しますが、これはセル固有の属性の指定にも使用します。}}
+
{{Documentation/Note|L'oggetto <tt>CellProperties</tt> dell'API di {{OOo}} è paragonabile all'oggetto <tt>Interior</tt> di VBA, che definisce anche le proprietà specifiche delle celle.}}
  
−
==▼背景色および影==
+
== Colore di sfondo e ombre ==
  
−
<idl>com.sun.star.table.CellProperties</idl> サービスには、背景色および影の表示指定用に、以下の属性が用意されています。
+
Il servizio <idl>com.sun.star.table.CellProperties</idl> fornisce le seguenti proprietà per definire i colori di sfondo e le ombre:
  
−
;<tt>CellBackColor (Long)</tt>:テーブルのセルの背景色。
+
;<tt>CellBackColor (Long)</tt>:Colore di sfondo della cella di tabella
−
;<tt>IsCellBackgroundTransparent (Boolean)</tt>:背景色を透明にする指定。
+
;<tt>IsCellBackgroundTransparent (Boolean)</tt>:Imposta il colore di sfondo su trasparente
−
;<tt>ShadowFormat (struct)</tt>:セルの影の指定 (<idl>com.sun.star.table.ShadowFormat</idl> に定められた構造体)。
+
;<tt>ShadowFormat (struct)</tt>:Specifica l'ombra per le celle (struttura conforme a <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
<idl>com.sun.star.table.ShadowFormat</idl> 構造体とセルの影指定は、以下のような関係になっています。
+
La struttura <idl>com.sun.star.table.ShadowFormat</idl> e le specifiche dettagliate per le ombre delle celle hanno la struttura seguente:
  
−
;<tt>Location (enum)</tt>:影の位置 (<idl>com.sun.star.table.ShadowLocation</idl> 構造体の値)。
+
;<tt>Location (enum)</tt>:Posizione dell'ombra (valore della struttura <idl>com.sun.star.table.ShadowLocation</idl>)
−
;<tt>ShadowWidth (Short)</tt>:100 分の 1 ミリ単位で指定した影の幅。
+
;<tt>ShadowWidth (Short)</tt>:Dimensioni dell'ombra in centesimi di millimetro
−
;<tt>IsTransparent (Boolean)</tt>:影を透明にする指定。
+
;<tt>IsTransparent (Boolean)</tt>:Imposta l'ombra su trasparente
−
;<tt>Color (Long)</tt>: 影の色。
+
;<tt>Color (Long)</tt>:Colore dell'ombra
  
−
以下のサンプルコードでは、B2 セルへの数値 1000 の入力、<tt>CellBackColor</tt> 属性による背景色の赤への変更、左下側 1 mm の位置への明るい灰色の影の表示を行います。
+
L'esempio seguente scrive il numero 1000 nella cella B2, cambia in rosso il colore dello sfondo avvalendosi della proprietà <tt>CellBackColor</tt> e quindi crea per la cella un'ombra di colore grigio chiaro, spostata di 1 mm verso sinistra e verso il basso.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 56: Line 56:
 
</source>
 
</source>
  
−
==▼テキストの配置==
+
== Giustificazione ==
  
−
{{OOo}}▼には、セルのテキスト配置を指定する各種の機\'94\'5cが用意されています。
+
{{OOo}} offre varie funzioni che permettono di modificare la giustificazione del testo nella cella di una tabella.
  
−
▼以下の属性は、テキストの水平および垂直方向の配置を指定するものです。
+
Le proprietà seguenti definiscono la giustificazione orizzontale e verticale di un testo:
  
−
;<tt>HoriJustify (enum)</tt>:テキストの水平方向の配置 (<idl>com.sun.star.table.CellHoriJustify</idl> の値)。
+
;<tt>HoriJustify (enum)</tt>:Giustificazione orizzontale del testo (valore da <idl>com.sun.star.table.CellHoriJustify</idl>)
−
;<tt>VertJustify (enum)</tt>:テキストの垂直方向の配置 (<idl>com.sun.star.table.CellVertJustify</idl> の値)。
+
;<tt>VertJustify (enum)</tt>:Giustificazione verticale del testo (valore da <idl>com.sun.star.table.CellVertJustify</idl>)
−
;<tt>Orientation (enum)</tt>:テキストの向き (<idl>com.sun.star.table.CellOrientation</idl> に定められた値)。
+
;<tt>Orientation (enum)</tt>:Orientamento del testo (valore conforme a <idl>com.sun.star.table.CellOrientation</idl>)
−
;<tt>IsTextWrapped (Boolean)</tt>:セル内の自動行ブレークを許可する指定。
+
;<tt>IsTextWrapped (Boolean)</tt>:Consente interruzioni di riga automatiche all'interno della cella
−
;<tt>RotateAngle (Long)</tt>:100 分の 1 度単位で指定したテキストの回転角。
+
;<tt>RotateAngle (Long)</tt>:Angolo di rotazione del testo in centesimi di grado
  
−
▼以下のサンプルコードでは、左上隅にあるセルの\'95\'5c示を「縦書き」 (stack) にして、文字を 1 文字ずつ上下方向に並べて\'95\'5c示します。▼なお、文字の回転は指定していません。
+
L'esempio seguente mostra come "impilare" i contenuti di una cella in modo che i singoli caratteri vengano visualizzati uno sotto l'altro nell'angolo superiore sinistro della cella. I caratteri non vengono ruotati.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 86: Line 86:
 
</source>
 
</source>
  
−
==▼数値、日付、テキストの\'95\'5c示書式==
+
== Formati di numeri, data e testo ==
  
−
{{OOo}} には、日付および時刻に対する各種の\'95\'5c示書式が用意されています。▼これらの\'95\'5c示書式にはそれぞれ固有の内部番号が割り当てられており、<tt>NumberFormat 属性による書式指定もこの番号を使用します。</tt>{{OOo}} ▼ では、<tt>queryKey</tt> および <tt>addNew メ\'83\'5cッドを利用して、既存の数の書式だけでなく、数の書式をユーザー定義することもできます。</tt>▼これらのメ\'83\'5cッドには、以下のようなオブジェクト呼び出しでアクセスします。
+
{{OOo}} fornisce una serie completa di formati di data e ora predefiniti. Ciascuno di tali formati ha un numero interno utilizzato per assegnare il formato alle celle con la proprietà <tt>NumberFormat</tt>. {{OOo}} dispone dei metodi <tt>queryKey</tt> e <tt>addNew</tt> che consentono di accedere ai formati numerici esistenti nonché crearne di personalizzati. I metodi sono accessibili tramite la seguente chiamata:
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 94: Line 94:
 
</source>
 
</source>
  
−
書式の指定は、{{OOo}} Basic の Format 関数とよく似た形式のフォーマット用文字列を使用します。▼ただし両者の間には大きな違いがあり、Format 関数のフォー\'83\'7dット用文字列は英語式の小数点と千単位の桁区切り記号を使用しますが、<tt>NumberFormats</tt> オブジェクトのフォー\'83\'7dット用文字列には、各ロケール別の記号を使う必要があります。
+
Il formato viene specificato utilizzando una stringa di formattazione strutturata in modo analogo alla funzione di formattazione di {{OOo}} Basic. Va tuttavia segnalata un'importante differenza: mentre quest'ultima richiede l'uso delle abbreviazioni inglesi e del punto decimale o dei caratteri come separatori delle migliaia, per la struttura di un comando di formattazione per l'oggetto <tt>NumberFormats</tt> dovete utilizzare le abbreviazioni specifiche del paese.
  
−
▼以下のサンプルコードでは、B2 セルに対して、小数部を 3 桁\'95\'5c示とし、コン\'83\'7dを千単位の桁区切りの記号とする数の書式を指定しています。
+
L'esempio seguente formatta la cella B2 in modo che i numeri vengano visualizzati con tre posizioni decimali e utilizzino le virgole come separatore delle migliaia.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 128: Line 128:
 
</source>
 
</source>
  
−
▼セルの書式設定用オプションについては、'''''' Calc 上の通常の操作で書式設定を行う際に用いる、{{セルの書式設定OOo}} のダイアログも参照してください。
+
La finestra di dialogo '''Formatta celle''' di {{OOo}} Calc offre una panoramica delle diverse opzioni di formattazione per le celle.
  
−
==▼ページ属性==
+
== Proprietà delle pagine ==
  
−
ページ属性では、ドキュメントの各ページの示内容に対する書式設定および、全ページに共通して配置する項目の設定などを行います。▼具体的には、以下のようなオプションを指定します。
+
Le proprietà delle pagine sono le opzioni di formattazione che posizionano il contenuto del documento su una pagina, nonché gli elementi visivi che vengono ripetuti pagina dopo pagina. Includono
  
−
*▼用紙サイズ
+
* Formati dei fogli
−
*▼ページ余白
+
* Margini
−
*▼ヘッダとフッタ
+
* Intestazioni e piè di pagina
  
−
▼ページ書式は、他の書式指定と設定法が異なります。セル、段落、テキストの書式は直接指定できますが、ページ書式はページスタイルを用いた間接的な設定も行えます。▼たとえば、ヘッダやフッタは、ページスタイルとして登録できます。
+
La procedura per definire i formati pagina differisce da quella di altre modalità di formattazione. Infatti, mentre gli elementi di celle, paragrafi e caratteri possono essere formattati direttamente, i formati pagina possono essere anche definiti e applicati in modo indiretto utilizzando i modelli di pagina. Intestazioni e piè di pagina, ad esempio, vengono aggiunti al modello di pagina.
  
−
▼以降の節では、\'95\'5c計算ドキュメントの主要なページ書式設定オプションについて説明します。▼ここで説明するページスタイルの多くは、文書ドキュメントと共通するものです。こうした共通で使用されるページ属性は、<idl>com.sun.star.style.PageProperties</idl> サービスで定義されています。これに対して、表計算ドキュメント固有のページ属性は、<idl>com.sun.star.sheet.TablePageStyle</idl> サービスで定義されています。
+
Le sezioni seguenti descrivono le principali opzioni di formattazione per le pagine dei fogli elettronici. Molti degli stili descritti sono disponibili anche per i documenti di testo. Le proprietà di pagina valide per entrambi i tipi di documenti sono definite nel servizio <idl>com.sun.star.style.PageProperties</idl>. Le proprietà di pagina che si applicano invece solo ai fogli elettronici sono definite nel servizio <idl>com.sun.star.sheet.TablePageStyle</idl>.
  
−
{{Documentation/Note|▼Microsoft Office ドキュメントのページ属性 (ページ余白、枠線など) は、 <tt>PageSetup</tt> オブジェクト (Excel) または <tt>Worksheet</tt> オブジェクト (Word) レベルの <tt>Document オブジェクトで指定します。</tt>▼{{OOo}} の場合、このような属性の指定はページスタイルを用いて行い、その後これらのページスタイルを該当するドキュメントにリンクさせる形になります。}}
+
{{Documentation/Note|Le proprietà di pagina (margini, bordi e così via) per i documenti di Microsoft Office sono definite per mezzo di un oggetto <tt>PageSetup</tt> a livello di oggetto <tt>Worksheet</tt> (Excel) o <tt>Document</tt> (Word). In {{OOo}}, tali proprietà vengono invece definite usando un modello di pagina, che è a sua volta collegato al documento associato.}}
  
−
==▼ページ背景==
+
== Sfondo pagina ==
  
−
<idl>com.sun.star.style.PageProperties</idl> サービスには、ページ背景に関する以下の属性が用意されています。
+
Il servizio <idl>com.sun.star.style.PageProperties</idl> definisce le seguenti proprietà dello sfondo delle pagine:
  
−
;<tt>BackColor (long)</tt>: 背景の色。
+
;<tt>BackColor (long)</tt>:Colore di sfondo
−
;<tt>BackGraphicURL (String)</tt>:背景に表示する画像の URL。
+
;<tt>BackGraphicURL (String)</tt>:URL dell'immagine di sfondo da usare
−
;<tt>BackGraphicFilter (String)</tt>:背景用の画像に対するフィルタ名。
+
;<tt>BackGraphicFilter (String)</tt>:Nome del filtro che interpreta le immagini di sfondo
−
;<tt>BackGraphicLocation (Enum)</tt>:背景用の画像の位置 (列挙型で定められた値)。
+
;<tt>BackGraphicLocation (Enum)</tt>:Posizione delle immagini di sfondo (valore conforme all'enumerazione)
−
;<tt>BackTransparent (Boolean)</tt>:背景を透明にする指定。
+
;<tt>BackTransparent (Boolean)</tt>:Rende lo sfondo trasparente
  
−
==▼ページ書式==
+
== Formato della pagina ==
  
−
ページ書式の指定には、<idl>com.sun.star.style.PageProperties</idl> サービスを使用します。
+
Il formato della pagina viene definito utilizzando le seguenti proprietà del servizio <idl>com.sun.star.style.PageProperties</idl>:
  
−
;<tt>IsLandscape (Boolean)</tt>:横長書式。
+
;<tt>IsLandscape (Boolean)</tt>:Formato orizzontale
−
;<tt>Width (long)</tt>:100 分の 1 ミリ単位で指定したページの幅。
+
;<tt>Width (long)</tt>:Larghezza della pagina in centesimi di millimetro
−
;<tt>Height (long)</tt>:100 分の 1 ミリ単位で指定したページの高さ。
+
;<tt>Height (long)</tt>:Altezza della pagina in centesimi di millimetro
−
;<tt>PrinterPaperTray (String)</tt>:使用するプリンタの用紙トレイの名前。
+
;<tt>PrinterPaperTray (String)</tt>:Nome del cassetto della stampante da usare
  
−
▼以下のサンプルコードでは、「標準」ページスタイルのページサイズを、A5 サイズ (高さ 14.8 cm、幅 21 cm) の横方向に設定します。
+
L'esempio seguente imposta le dimensioni della pagina del modello di pagina "Default" sul formato orizzontale DIN A5 (altezza 14,8 cm, larghezza 21 cm):
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 182: Line 182:
 
</source>
 
</source>
  
−
==▼ページ余白、外枠、影==
+
== Margine, bordo e ombra della pagina ==
  
−
<idl>com.sun.star.style.PageProperties</idl> サービスには、ページの余白、外枠、影の設定用に、以下の属性が用意されています。
+
Il servizio <idl>com.sun.star.style.PageProperties</idl> fornisce le seguenti proprietà per regolare i margini della pagina, i bordi e le ombre:
  
−
;<tt>LeftMargin (long)</tt>:100 分の 1 ミリ単位で指定したページの左余白。
+
;<tt>LeftMargin (long)</tt>:Larghezza del margine sinistro della pagina in centesimi di millimetro
−
;<tt>RightMargin (long)</tt>:100 分の 1 ミリ単位で指定したページの右余白。
+
;<tt>RightMargin (long)</tt>:Larghezza del margine destro della pagina in centesimi di millimetro
−
;<tt>TopMargin (long)</tt>:100 分の 1 ミリ単位で指定したページの上余白。
+
;<tt>TopMargin (long)</tt>:Larghezza del margine superiore della pagina in centesimi di millimetro
−
;<tt>BottomMargin (long)</tt>:100 分の 1 ミリ単位で指定したページの下余白。
+
;<tt>BottomMargin (long)</tt>:Larghezza del margine inferiore della pagina in centesimi di millimetro
−
;<tt>LeftBorder (struct)</tt>:左側の外枠線の指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>LeftBorder (struct)</tt>:Specifiche per il bordo della linea sinistra della pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>RightBorder (struct)</tt>:右側の外枠線の指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>RightBorder (struct)</tt>:Specifiche per il bordo della linea destra della pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>TopBorder (struct)</tt>:上側の外枠線の指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>TopBorder (struct)</tt>:Specifiche per il bordo della linea superiore della pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>BottomBorder (struct)</tt>:ページ罫線の下の線の指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>BottomBorder (struct)</tt>:Specifiche per il bordo della linea inferiore della pagina (struttura<idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>LeftBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、左側の外枠線とページ本文との距離。
+
;<tt>LeftBorderDistance (long)</tt>:Distanza tra il bordo sinistro e il contenuto della pagina in centesimi di millimetro
−
;<tt>RightBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、右側の外枠線とページ本文との距離。
+
;<tt>RightBorderDistance (long)</tt>:Distanza tra il bordo destro e i contenuti della pagina in centesimi di millimetro
−
;<tt>TopBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、上側の外枠線とページ本文との距離。
+
;<tt>TopBorderDistance (long)</tt>:Distanza tra il bordo superiore e il contenuto della pagina in centesimi di millimetro
−
;<tt>BottomBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、下側の外枠線とページ本文との距離。
+
;<tt>BottomBorderDistance (long)</tt>:Distanza tra il bordo inferiore e il contenuto della pagina in centesimi di millimetro
−
;<tt>ShadowFormat (struct)</tt>:ページのコンテンツ領域の影の指定 (<idl>com.sun.star.table.ShadowFormat</idl> 構造体)。
+
;<tt>ShadowFormat (struct)</tt>:Specifiche per l'ombra dell'area del contenuto di una pagina (struttura <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
▼以下のサンプルコードでは、「標準」ページスタイルの左および右側の余白を、1 センチメートルに指定しています。
+
L'esempio seguente imposta i bordi sinistro e destro del modello di pagina "Default" su 1 centimetro.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 218: Line 218:
 
</source>
 
</source>
  
−
==▼ヘッダとフッタ==
+
== Intestazioni e piè di pagina ==
  
−
ヘッダおよびフッタもページ属性として扱われるもので、これらも <idl>com.sun.star.style.PageProperties</idl> サービスで定義されています。▼ヘッダの書式設定には、以下の属性を使用します。
+
Le intestazioni e i piè di pagina di un documento fanno parte delle proprietà della pagina e vengono definiti mediante il servizio <idl>com.sun.star.style.PageProperties</idl>. Le proprietà per la formattazione delle intestazioni sono le seguenti:
  
−
;<tt>HeaderIsOn (Boolean)</tt>:ヘッダを有効化。
+
;<tt>HeaderIsOn (Boolean)</tt>:L'intestazione è attivata
−
;<tt>HeaderLeftMargin (long)</tt>:100 分の 1 ミリ単位で指定した、左ページ余白からヘッダまでの距離。
+
;<tt>HeaderLeftMargin (long)</tt>:Distanza tra intestazione e margine sinistro della pagina, espressa in centesimi di millimetro
−
;<tt>HeaderRightMargin (long)</tt>:100 分の 1 ミリ単位で指定した、右ページ余白からヘッダまでの距離。
+
;<tt>HeaderRightMargin (long)</tt>:Distanza tra intestazione e margine destro della pagina, espressa in centesimi di millimetro
−
;<tt>HeaderBodyDistance (long)</tt>:100 分の 1 ミリ単位で指定した、ページ本文領域からヘッダまでの距離。
+
;<tt>HeaderBodyDistance (long)</tt>:Distanza tra intestazione e corpo principale del documento, espressa in centesimi di millimetro
−
;<tt>HeaderHeight (long)</tt>:100 分の 1 ミリ単位で指定したヘッダの高さ。
+
;<tt>HeaderHeight (long)</tt>:Altezza dell'intestazione in centesimi di millimetro
−
;<tt>HeaderIsDynamicHeight (Boolean)</tt>:ヘッダの高さを表示内容に自動的に合わせる指定。
+
;<tt>HeaderIsDynamicHeight (Boolean)</tt>:L'altezza dell'intestazione viene automaticamente adattata al contenuto
−
;<tt>HeaderLeftBorder (struct)</tt>:ヘッダ周囲の左側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>HeaderLeftBorder (struct)</tt>:Dettagli del bordo sinistro della cornice attorno all'intestazione (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>HeaderRightBorder (struct)</tt>:ヘッダ周囲の右側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>HeaderRightBorder (struct)</tt>:Dettagli del bordo destro della cornice attorno all'intestazione (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>HeaderTopBorder (struct)</tt>:ヘッダ周囲の上側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>HeaderTopBorder (struct)</tt>:Dettagli del bordo superiore della cornice attorno all'intestazione (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>HeaderBottomBorder (struct)</tt>:ヘッダ周囲の下側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>HeaderBottomBorder (struct)</tt>:Dettagli del bordo inferiore della cornice attorno all'intestazione (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>HeaderLeftBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、左側の外枠線からヘッダ本文までの距離。
+
;<tt>HeaderLeftBorderDistance (long)</tt>:Distanza tra il bordo sinistro e il contenuto dell'intestazione, espressa in centesimi di millimetro
−
;<tt>HeaderRightBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、右側の外枠線からヘッダ本文までの距離。
+
;<tt>HeaderRightBorderDistance (long)</tt>:Distanza tra il bordo destro e il contenuto dell'intestazione, espressa in centesimi di millimetro
−
;<tt>HeaderTopBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、上側の外枠線からヘッダ本文までの距離。
+
;<tt>HeaderTopBorderDistance (long)</tt>:Distanza tra il bordo superiore e il contenuto dell'intestazione, espressa in centesimi di millimetro
−
;<tt>HeaderBottomBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、下側の外枠線からヘッダ本文までの距離。
+
;<tt>HeaderBottomBorderDistance (long)</tt>:Distanza tra il bordo inferiore e il contenuto dell'intestazione, espressa in centesimi di millimetro
−
;<tt>HeaderIsShared (Boolean)</tt>:左右のページで共通のヘッダを使う指定 (<tt>HeaderText</tt>、<tt>HeaderTextLeft</tt>、<tt>HeaderTextRight</tt> を参照)。
+
;<tt>HeaderIsShared (Boolean)</tt>:Le intestazioni delle pagine pari e delle pagine dispari hanno lo stesso contenuto (vedere <tt>HeaderText</tt>, <tt>HeaderTextLeft</tt> e <tt>HeaderTextRight</tt>)
−
;<tt>HeaderBackColor (long)</tt>:ヘッダの背景色。
+
;<tt>HeaderBackColor (long)</tt>:Colore di sfondo dell'intestazione
−
;<tt>HeaderBackGraphicURL (String)</tt>:背景に表示する画像の URL。
+
;<tt>HeaderBackGraphicURL (String)</tt>:URL dell'immagine di sfondo da usare
−
;<tt>HeaderBackGraphicFilter (String)</tt>:ヘッダの背景画像に対するフィルタ名。
+
;<tt>HeaderBackGraphicFilter (String)</tt>:Nome del filtro che interpreta le immagini di sfondo per l'intestazione
−
;<tt>HeaderBackGraphicLocation (Enum)</tt>:ヘッダの背景画像の位置 <idl>com.sun.star.style.GraphicLocation</idl> の列挙型で定められた値)。
+
;<tt>HeaderBackGraphicLocation (Enum)</tt>:Posizione delle immagini di sfondo per l'intestazione (valore conforme all'enumerazione <idl>com.sun.star.style.GraphicLocation</idl>)
−
;<tt>HeaderBackTransparent (Boolean)</tt>:ヘッダの背景を透明に表示する指定。
+
;<tt>HeaderBackTransparent (Boolean)</tt>:Mostra lo sfondo dell'intestazione come trasparente
−
;<tt>HeaderShadowFormat (struct)</tt>:ヘッダの影の詳細指定 (<idl>com.sun.star.table.ShadowFormat</idl> 構造体)。
+
;<tt>HeaderShadowFormat (struct)</tt>:Dettagli dell'ombra dell'intestazione (struttura <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
▼フッタの書式設定には、以下の属性を使用します。
+
Le proprietà per la formattazione dei piè di pagina sono le seguenti:
  
−
;<tt>FooterIsOn (Boolean)</tt>:フッタを有効化。
+
;<tt>FooterIsOn (Boolean)</tt>:Il piè di pagina è attivato
−
;<tt>FooterLeftMargin (long)</tt>:100 分の 1 ミリ単位で指定した、左ページ余白からフッタまでの距離。
+
;<tt>FooterLeftMargin (long)</tt>:Distanza tra piè di pagina e margine sinistro della pagina, espressa in centesimi di millimetro
−
;<tt>FooterRightMargin (long)</tt>:100 分の 1 ミリ単位で指定した、右ページ余白からフッタまでの距離。
+
;<tt>FooterRightMargin (long)</tt>:Distanza tra piè di pagina e margine destro della pagina, espressa in centesimi di millimetro
−
;<tt>FooterBodyDistance (long)</tt>:100 分の 1 ミリ単位で指定した、ページ本文領域からフッタまでの距離。
+
;<tt>FooterBodyDistance (long)</tt>:Distanza tra piè di pagina e corpo principale del documento, espressa in centesimi di millimetro
−
;<tt>FooterHeight (long)</tt>:100 分の 1 ミリ単位で指定したフッタの高さ。
+
;<tt>FooterHeight (long)</tt>:Altezza del piè di pagina in centesimi di millimetro
−
;<tt>FooterIsDynamicHeight (Boolean)</tt>:フッタの高さを表示内容に自動的に合わせる指定。
+
;<tt>FooterIsDynamicHeight (Boolean)</tt>:L'altezza del piè di pagina viene automaticamente adattata al contenuto
−
;<tt>FooterLeftBorder (struct)</tt>:フッタ周囲の左側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>FooterLeftBorder (struct)</tt>:Dettagli del bordo sinistro della cornice attorno al piè di pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterRightBorder (struct)</tt>:フッタ周囲の右側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>FooterRightBorder (struct)</tt>:Dettagli del bordo destro della cornice attorno al piè di pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterTopBorder (struct)</tt>:フッタ周囲の上側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>FooterTopBorder (struct)</tt>:Dettagli del bordo superiore della cornice attorno al piè di pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterBottomBorder (struct)</tt>:フッタ周囲の下側の外枠線の詳細指定 (<idl>com.sun.star.table.BorderLine</idl> 構造体)。
+
;<tt>FooterBottomBorder (struct)</tt>:Dettagli del bordo inferiore della cornice attorno al piè di pagina (struttura <idl>com.sun.star.table.BorderLine</idl>)
−
;<tt>FooterLeftBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、左側の外枠線からフッタ本文までの距離。
+
;<tt>FooterLeftBorderDistance (long)</tt>:Distanza tra il bordo sinistro e il contenuto del piè di pagina, espressa in centesimi di millimetro
−
;<tt>FooterRightBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、右側の外枠線からフッタ本文までの距離。
+
;<tt>FooterRightBorderDistance (long)</tt>:Distanza tra il bordo destro e il contenuto del piè di pagina, espressa in centesimi di millimetro
−
;<tt>FooterTopBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、上側の外枠線からフッタ本文までの距離。
+
;<tt>FooterTopBorderDistance (long)</tt>:Distanza tra il bordo superiore e il contenuto del piè di pagina, espressa in centesimi di millimetro
−
;<tt>FooterBottomBorderDistance (long)</tt>:100 分の 1 ミリ単位で指定した、下側の外枠線からフッタ本文までの距離。
+
;<tt>FooterBottomBorderDistance (long)</tt>:Distanza tra il bordo inferiore e il contenuto del piè di pagina, espressa in centesimi di millimetro
−
;<tt>FooterIsShared (Boolean)</tt>:左右のページで共通のフッタを使う指定 (<tt>FooterText</tt>、<tt>FooterTextLeft</tt>、<tt>FooterTextRight</tt> を参照)。
+
;<tt>FooterIsShared (Boolean)</tt>:I piè di pagina delle pagine pari e delle pagine dispari hanno lo stesso contenuto (vedere <tt>FooterText</tt>, <tt>FooterTextLeft</tt> e <tt>FooterTextRight</tt>)
−
;<tt>FooterBackColor (long)</tt>:フッタの背景色。
+
;<tt>FooterBackColor (long)</tt>:Colore di sfondo del piè di pagina
−
;<tt>FooterBackGraphicURL (String)</tt>:背景に表示する画像の URL。
+
;<tt>FooterBackGraphicURL (String)</tt>:URL dell'immagine di sfondo da usare
−
;<tt>FooterBackGraphicFilter (String)</tt>:フッタの背景画像に対するフィルタ名。
+
;<tt>FooterBackGraphicFilter (String)</tt>:Nome del filtro che interpreta le immagini di sfondo per il piè di pagina
−
;<tt>FooterBackGraphicLocation (Enum)</tt>:フッタの背景画像の位置 (<idl>com.sun.star.style.GraphicLocation</idl> の列挙型で定められた値)。
+
;<tt>FooterBackGraphicLocation (Enum)</tt>:Posizione delle immagini di sfondo per il piè di pagina (valore conforme all'enumerazione <idl>com.sun.star.style.GraphicLocation</idl>)
−
;<tt>FooterBackTransparent (Boolean) </tt>:フッタの背景を透明に表示する指定。
+
;<tt>FooterBackTransparent (Boolean) </tt>:Mostra lo sfondo del piè di pagina come trasparente
−
;<tt>FooterShadowFormat (struct)</tt>:フッタの影の詳細指定 (<idl>com.sun.star.table.ShadowFormat</idl> 構造体)。
+
;<tt>FooterShadowFormat (struct)</tt>:Dettagli dell'ombra del piè di pagina (struttura <idl>com.sun.star.table.ShadowFormat</idl>)
  
−
==▼ヘッダおよびフッタの\'95\'5c示テキストの変更==
+
== Modifica del testo di intestazioni e piè di pagina ==
  
−
▼\'95\'5c計算ドキュメントのヘッダやフッタの内容へアクセスするには、以下の属性を使用します。
+
Si accede al contenuto di intestazioni e piè di pagina di un foglio elettronico per mezzo delle seguenti proprietà:
  
−
;<tt>LeftPageHeaderContent (Object)</tt>:偶数ページのヘッダの表示内容 (<idl>com.sun.star.sheet.HeaderFooterContent</idl> サービス)。
+
;<tt>LeftPageHeaderContent (Object)</tt>:Contenuto delle intestazioni delle pagine pari (servizio <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>RightPageHeaderContent (Object)</tt>:奇数ページのヘッダの表示内容 (<idl>com.sun.star.sheet.HeaderFooterContent</idl> サービス)。
+
;<tt>RightPageHeaderContent (Object)</tt>:Contenuto delle intestazioni delle pagine dispari (servizio <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>LeftPageFooterContent (Object)</tt>:偶数ページのフッタの表示内容 (<idl>com.sun.star.sheet.HeaderFooterContent</idl> サービス)。
+
;<tt>LeftPageFooterContent (Object)</tt>:Contenuto dei piè di pagina delle pagine pari (servizio <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
−
;<tt>RightPageFooterContent (Object)</tt>:奇数ページのフッタの表示内容 (<idl>com.sun.star.sheet.HeaderFooterContent</idl> サービス)。
+
;<tt>RightPageFooterContent (Object)</tt>:Contenuto dei piè di pagina delle pagine dispari (servizio <idl>com.sun.star.sheet.HeaderFooterContent</idl>)
  
−
偶数ページと奇数ページで共通のヘッダやフッタを用いる場合は (<tt>FooterIsShared</tt> 属性に <tt>False</tt> を指定)、それぞれ奇数ページ用の属性を指定します。
+
Se non è necessario distinguere tra intestazioni e piè di pagina di pagine pari e dispari (ovvero la proprietà <tt>FooterIsShared</tt> è <tt>False</tt>), impostare le proprietà delle intestazioni e dei piè di pagina sulle pagine dispari.
  
−
これらのオブジェクトは、<idl>com.sun.star.sheet.HeaderFooterContent</idl> サービスをサポートしたオブジェクトを返します。このサービスは、<tt>LeftText</tt>、<tt>CenterText</tt>、<tt>RightText</tt> という (疑似) 属性を用いて、{{OOo}} Calc のヘッダやフッタに関する 3 種類のテキスト情報を取得します。
+
Tutti gli oggetti citati restituiscono un oggetto che supporta il servizio <idl>com.sun.star.sheet.HeaderFooterContent</idl>. Per mezzo delle proprietà (non originali) <tt>LeftText</tt>, <tt>CenterText</tt> e <tt>RightText</tt>, questo servizio mette a disposizione tre elementi di testo per le intestazioni e i piè di pagina di {{OOo}} Calc.
  
−
以下のサンプルコードを使うと「Just a Test.」と表示されます。「デフォルト」テンプレートからヘッダの左側のテキストフィールドに記述します。
+
L'esempio seguente scrive il valore "Just a Test" nel campo di testo di sinistra dell'intestazione del modello "Default".
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 303: Line 303:
 
</source>
 
</source>
  
−
サンプルコードの最後の行に注意してください。テキストを変更する場合、変更を有効にするには、<tt>TextContent</tt> オブジェクトをヘッダに再割り当てする必要があります。
+
Osservare l'ultima riga dell'esempio: una volta modificato il testo, per rendere effettiva la modifica l'oggetto <tt>TextContent</tt> deve essere di nuovo assegnato all'intestazione.
  
−
文書ドキュメント ({{OOo}} Writer) の場合、ヘッダやフッタは単一のテキストブロックから構成されているため、他の方法でヘッダやフッタの表示テキストを変更できます。以下の属性は、<idl>com.sun.star.style.PageProperties</idl> サービスに定義されています。
+
Per i documenti di testo ({{OOo}} Writer) è disponibile un altro meccanismo di modifica del testo di intestazioni e piè di pagina, perché in questo contesto sono formati da un singolo blocco di testo. Le proprietà seguenti sono definite nel servizio <idl>com.sun.star.style.PageProperties</idl>:
  
−
;<tt>HeaderText (Object) </tt>:ヘッダの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>HeaderText (Object) </tt>:Oggetto testo con i contenuti dell'intestazione (servizio <idl>com.sun.star.text.XText</idl>)
−
;<tt>HeaderTextLeft (Object)</tt>:左側のページのヘッダの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>HeaderTextLeft (Object)</tt>:Oggetto testo con i contenuti dell'intestazione delle pagine di sinistra (servizio <idl>com.sun.star.text.XText</idl>)
−
;<tt>HeaderTextRight (Object)</tt>:右側のページのヘッダの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>HeaderTextRight (Object)</tt>:Oggetto testo con i contenuti dell'intestazione delle pagine di destra (servizio <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterText (Object)</tt>:フッタの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>FooterText (Object)</tt>:Oggetto testo con i contenuti del piè di pagina (servizio <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterTextLeft (Object)</tt>:左側のページのフッタの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>FooterTextLeft (Object)</tt>:Oggetto testo con i contenuti dei piè di pagina delle pagine di sinistra (servizio <idl>com.sun.star.text.XText</idl>)
−
;<tt>FooterTextRight (Object)</tt>:右側のページのフッタの内容が表示されたテキストオブジェクト (<idl>com.sun.star.text.XText</idl> サービス)。
+
;<tt>FooterTextRight (Object)</tt>:Oggetto testo con i contenuti dei piè di pagina delle pagine di destra (servizio <idl>com.sun.star.text.XText</idl>)
  
−
▼以下のサンプルコードでは、文書ドキュメントの「標準」ページスタイルにヘッダを作成し、その\'95\'5c示テキストを「Just a Test.」としています。
+
L'esempio seguente crea un'intestazione nel modello di pagina "Default" per i documenti di testo e aggiunge il testo "Just a Test" all'intestazione.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 335: Line 335:
 
</source>
 
</source>
  
−
この場合は、<tt>HeaderText</tt> オブジェクトではなく、<tt>HeaderFooterContent</tt> 属性を使用してヘッダに直接アクセスしています。
+
In questo caso, l'accesso viene fornito direttamente tramite la proprietà <tt>HeaderText</tt> del modello di pagina anziché dall'oggetto <tt>HeaderFooterContent</tt>.
  
−
==▼中央揃え (\'95\'5c計算ドキュメントのみ)==
+
== Centratura (solo fogli elettronici) ==
  
−
<idl>com.sun.star.sheet.TablePageStyle</idl> サービスは、{{OOo}} Calc のページスタイルでのみ使用するもので、印刷するセル範囲をページの中央に配置させることができます。▼このサービスでは、以下の属性を利用できます。
+
Il servizio <idl>com.sun.star.sheet.TablePageStyle</idl> è utilizzato solo nei modelli di pagina di {{OOo}} Calc e permette di centrare sulla pagina gli intervalli di celle da stampare. Questo servizio dispone delle proprietà seguenti:
  
−
;<tt>CenterHorizontally (Boolean)</tt>:テーブルコンテンツを水平方向に中央揃え。
+
;<tt>CenterHorizontally (Boolean)</tt>:I contenuti della tabella vengono centrati orizzontalmente
−
;<tt>CenterVertically (Boolean)</tt>:テーブルコンテンツを垂直方向に中央揃え。
+
;<tt>CenterVertically (Boolean)</tt>:I contenuti della tabella vengono centrati verticalmente
  
−
==▼印刷対象の指定 (\'95\'5c計算ドキュメントのみ)==
+
== Definizione degli elementi da stampare (solo fogli elettronici) ==
  
−
▼スプレッドシートの書式設定では、ページ上の各種要素を印刷させるかどうかを指定できます。<idl>com.sun.star.sheet.TablePageStyle</idl> サービスには、このような処理を行うために以下の属性が用意されています。
+
Durante la formattazione dei fogli è possibile definire gli elementi della pagina da rendere visibili. A tal fine, il servizio <idl>com.sun.star.sheet.TablePageStyle</idl> fornisce le proprietà seguenti:
  
−
;<tt>PrintAnnotations (Boolean)</tt>:セルのコメントを印刷する指定。
+
;<tt>PrintAnnotations (Boolean)</tt>:Stampa i commenti delle celle
−
;<tt>PrintGrid (Boolean)</tt>:セルのグリッド線を印刷する指定。
+
;<tt>PrintGrid (Boolean)</tt>:Stampa la griglia delle celle
−
;<tt>PrintHeaders (Boolean)</tt>:行と列の見出しを印刷する指定。
+
;<tt>PrintHeaders (Boolean)</tt>:Stampa le intestazioni di righe e colonne
−
;<tt>PrintCharts (Boolean)</tt>:シートに含まれるグラフを印刷する指定。
+
;<tt>PrintCharts (Boolean)</tt>:Stampa i diagrammi contenuti in un foglio
−
;<tt>PrintObjects (Boolean)</tt>:埋め込みオブジェクトを印刷する指定。
+
;<tt>PrintObjects (Boolean)</tt>:Stampa gli oggetti incorporati
−
;<tt>PrintDrawing (Boolean)</tt>:図形描画オブジェクトを印刷する指定。
+
;<tt>PrintDrawing (Boolean)</tt>:Stampa gli oggetti di disegno
−
;<tt>PrintDownFirst (Boolean)</tt>:シートの印刷範囲が複数ページにまたがる場合に、上から下の方向に印刷してから右側のページという順番で印刷する指定。
+
;<tt>PrintDownFirst (Boolean)</tt>:Se i contenuti di un foglio si estendono su diverse pagine, vengono prima stampati in ordine decrescente verticale, procedendo in direzione inferiore destra
−
;<tt>PrintFormulas (Boolean)</tt>:計算された値ではなく数式を印刷する指定。
+
;<tt>PrintFormulas (Boolean)</tt>:Stampa le formule anziché i valori calcolati
−
;<tt>PrintZeroValues (Boolean)</tt>:ゼロの値を印刷する指定。
+
;<tt>PrintZeroValues (Boolean)</tt>:Stampa gli zeri
  
 
{{PDL1}}
 
{{PDL1}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Formatting Spreadsheet Documents}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Formatting Spreadsheet Documents}}

Revision as of 18:22, 25 June 2009

Template:EN/Documentation/BASICGuideTOC/v2


Un foglio elettronico dispone di proprietà e metodi per formattare celle e pagine.

Proprietà delle celle

Esistono numerose opzioni per formattare le celle: è ad esempio possibile specificare tipo e dimensioni carattere per il testo. Ogni cella supporta i servizi com.sun.star.style.CharacterProperties e com.sun.star.style.ParagraphProperties, le cui proprietà principali sono descritte in Documenti di testo. La formattazione speciale delle celle è gestita dal servizio com.sun.star.table.CellProperties, le cui proprietà principali sono descritte nelle sezioni seguenti.

Tutte le proprietà si possono applicare sia a singole celle che a intervalli di celle.

Template:Documentation/Note

Colore di sfondo e ombre

Il servizio com.sun.star.table.CellProperties fornisce le seguenti proprietà per definire i colori di sfondo e le ombre:

CellBackColor (Long)
Colore di sfondo della cella di tabella
IsCellBackgroundTransparent (Boolean)
Imposta il colore di sfondo su trasparente
ShadowFormat (struct)
Specifica l'ombra per le celle (struttura conforme a com.sun.star.table.ShadowFormat)

La struttura com.sun.star.table.ShadowFormat e le specifiche dettagliate per le ombre delle celle hanno la struttura seguente:

Location (enum)
Posizione dell'ombra (valore della struttura com.sun.star.table.ShadowLocation)
ShadowWidth (Short)
Dimensioni dell'ombra in centesimi di millimetro
IsTransparent (Boolean)
Imposta l'ombra su trasparente
Color (Long)
Colore dell'ombra

L'esempio seguente scrive il numero 1000 nella cella B2, cambia in rosso il colore dello sfondo avvalendosi della proprietà CellBackColor e quindi crea per la cella un'ombra di colore grigio chiaro, spostata di 1 mm verso sinistra e verso il basso. 

Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object
Dim ShadowFormat As New com.sun.star.table.ShadowFormat
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)
 
Cell.Value = 1000
 
Cell.CellBackColor = RGB(255, 0, 0)
 
ShadowFormat.Location = com.sun.star.table.ShadowLocation.BOTTOM_RIGHT
ShadowFormat.ShadowWidth = 100
ShadowFormat.Color = RGB(160, 160, 160)
 
Cell.ShadowFormat = ShadowFormat

Giustificazione

Apache OpenOffice offre varie funzioni che permettono di modificare la giustificazione del testo nella cella di una tabella.

Le proprietà seguenti definiscono la giustificazione orizzontale e verticale di un testo:

HoriJustify (enum)
Giustificazione orizzontale del testo (valore da com.sun.star.table.CellHoriJustify)
VertJustify (enum)
Giustificazione verticale del testo (valore da com.sun.star.table.CellVertJustify)
Orientation (enum)
Orientamento del testo (valore conforme a com.sun.star.table.CellOrientation)
IsTextWrapped (Boolean)
Consente interruzioni di riga automatiche all'interno della cella
RotateAngle (Long)
Angolo di rotazione del testo in centesimi di grado

L'esempio seguente mostra come "impilare" i contenuti di una cella in modo che i singoli caratteri vengano visualizzati uno sotto l'altro nell'angolo superiore sinistro della cella. I caratteri non vengono ruotati. 

Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)
 
Cell.Value = 1000
 
Cell.HoriJustify = com.sun.star.table.CellHoriJustify.LEFT
Cell.VertJustify = com.sun.star.table.CellVertJustify.TOP
Cell.Orientation = com.sun.star.table.CellOrientation.STACKED

Formati di numeri, data e testo

Apache OpenOffice fornisce una serie completa di formati di data e ora predefiniti. Ciascuno di tali formati ha un numero interno utilizzato per assegnare il formato alle celle con la proprietà NumberFormat. Apache OpenOffice dispone dei metodi queryKey e addNew che consentono di accedere ai formati numerici esistenti nonché crearne di personalizzati. I metodi sono accessibili tramite la seguente chiamata: 

NumberFormats = Doc.NumberFormats

Il formato viene specificato utilizzando una stringa di formattazione strutturata in modo analogo alla funzione di formattazione di Apache OpenOffice Basic. Va tuttavia segnalata un'importante differenza: mentre quest'ultima richiede l'uso delle abbreviazioni inglesi e del punto decimale o dei caratteri come separatori delle migliaia, per la struttura di un comando di formattazione per l'oggetto NumberFormats dovete utilizzare le abbreviazioni specifiche del paese.

L'esempio seguente formatta la cella B2 in modo che i numeri vengano visualizzati con tre posizioni decimali e utilizzino le virgole come separatore delle migliaia. 

Dim Doc As Object
Dim Sheet As Object
Dim Cell As Object
Dim NumberFormats As Object
Dim NumberFormatString As String
Dim NumberFormatId As Long
Dim LocalSettings As New com.sun.star.lang.Locale
 
Doc = StarDesktop.CurrentComponent
Sheet = Doc.Sheets(0)
Cell = Sheet.getCellByPosition(1,1)
 
Cell.Value = 23400.3523565
 
LocalSettings.Language = "en"
LocalSettings.Country = "us"
 
NumberFormats = Doc.NumberFormats
NumberFormatString = "#,##0.000"
 
NumberFormatId = NumberFormats.queryKey(NumberFormatString, LocalSettings, True)
If NumberFormatId = -1 Then
   NumberFormatId = NumberFormats.addNew(NumberFormatString, LocalSettings)
End If
 
MsgBox NumberFormatId
Cell.NumberFormat = NumberFormatId

La finestra di dialogo Formatta celle di Apache OpenOffice Calc offre una panoramica delle diverse opzioni di formattazione per le celle.

Proprietà delle pagine

Le proprietà delle pagine sono le opzioni di formattazione che posizionano il contenuto del documento su una pagina, nonché gli elementi visivi che vengono ripetuti pagina dopo pagina. Includono

  • Formati dei fogli
  • Margini
  • Intestazioni e piè di pagina

La procedura per definire i formati pagina differisce da quella di altre modalità di formattazione. Infatti, mentre gli elementi di celle, paragrafi e caratteri possono essere formattati direttamente, i formati pagina possono essere anche definiti e applicati in modo indiretto utilizzando i modelli di pagina. Intestazioni e piè di pagina, ad esempio, vengono aggiunti al modello di pagina.

Le sezioni seguenti descrivono le principali opzioni di formattazione per le pagine dei fogli elettronici. Molti degli stili descritti sono disponibili anche per i documenti di testo. Le proprietà di pagina valide per entrambi i tipi di documenti sono definite nel servizio com.sun.star.style.PageProperties. Le proprietà di pagina che si applicano invece solo ai fogli elettronici sono definite nel servizio com.sun.star.sheet.TablePageStyle.

Template:Documentation/Note

Sfondo pagina

Il servizio com.sun.star.style.PageProperties definisce le seguenti proprietà dello sfondo delle pagine:

BackColor (long)
Colore di sfondo
BackGraphicURL (String)
URL dell'immagine di sfondo da usare
BackGraphicFilter (String)
Nome del filtro che interpreta le immagini di sfondo
BackGraphicLocation (Enum)
Posizione delle immagini di sfondo (valore conforme all'enumerazione)
BackTransparent (Boolean)
Rende lo sfondo trasparente

Formato della pagina

Il formato della pagina viene definito utilizzando le seguenti proprietà del servizio com.sun.star.style.PageProperties:

IsLandscape (Boolean)
Formato orizzontale
Width (long)
Larghezza della pagina in centesimi di millimetro
Height (long)
Altezza della pagina in centesimi di millimetro
PrinterPaperTray (String)
Nome del cassetto della stampante da usare

L'esempio seguente imposta le dimensioni della pagina del modello di pagina "Default" sul formato orizzontale DIN A5 (altezza 14,8 cm, larghezza 21 cm): 

Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object 
Dim PageStyles As Object
Dim DefPage As Object
 
Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")
 
DefPage.IsLandscape = True
DefPage.Width = 21000
DefPage.Height = 14800

Margine, bordo e ombra della pagina

Il servizio com.sun.star.style.PageProperties fornisce le seguenti proprietà per regolare i margini della pagina, i bordi e le ombre:

LeftMargin (long)
Larghezza del margine sinistro della pagina in centesimi di millimetro
RightMargin (long)
Larghezza del margine destro della pagina in centesimi di millimetro
TopMargin (long)
Larghezza del margine superiore della pagina in centesimi di millimetro
BottomMargin (long)
Larghezza del margine inferiore della pagina in centesimi di millimetro
LeftBorder (struct)
Specifiche per il bordo della linea sinistra della pagina (struttura com.sun.star.table.BorderLine)
RightBorder (struct)
Specifiche per il bordo della linea destra della pagina (struttura com.sun.star.table.BorderLine)
TopBorder (struct)
Specifiche per il bordo della linea superiore della pagina (struttura com.sun.star.table.BorderLine)
BottomBorder (struct)
Specifiche per il bordo della linea inferiore della pagina (strutturacom.sun.star.table.BorderLine)
LeftBorderDistance (long)
Distanza tra il bordo sinistro e il contenuto della pagina in centesimi di millimetro
RightBorderDistance (long)
Distanza tra il bordo destro e i contenuti della pagina in centesimi di millimetro
TopBorderDistance (long)
Distanza tra il bordo superiore e il contenuto della pagina in centesimi di millimetro
BottomBorderDistance (long)
Distanza tra il bordo inferiore e il contenuto della pagina in centesimi di millimetro
ShadowFormat (struct)
Specifiche per l'ombra dell'area del contenuto di una pagina (struttura com.sun.star.table.ShadowFormat)

L'esempio seguente imposta i bordi sinistro e destro del modello di pagina "Default" su 1 centimetro. 

Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object 
Dim PageStyles As Object
Dim DefPage As Object
 
Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")
 
DefPage.LeftMargin = 1000
DefPage.RightMargin = 1000

Intestazioni e piè di pagina

Le intestazioni e i piè di pagina di un documento fanno parte delle proprietà della pagina e vengono definiti mediante il servizio com.sun.star.style.PageProperties. Le proprietà per la formattazione delle intestazioni sono le seguenti:

HeaderIsOn (Boolean)
L'intestazione è attivata
HeaderLeftMargin (long)
Distanza tra intestazione e margine sinistro della pagina, espressa in centesimi di millimetro
HeaderRightMargin (long)
Distanza tra intestazione e margine destro della pagina, espressa in centesimi di millimetro
HeaderBodyDistance (long)
Distanza tra intestazione e corpo principale del documento, espressa in centesimi di millimetro
HeaderHeight (long)
Altezza dell'intestazione in centesimi di millimetro
HeaderIsDynamicHeight (Boolean)
L'altezza dell'intestazione viene automaticamente adattata al contenuto
HeaderLeftBorder (struct)
Dettagli del bordo sinistro della cornice attorno all'intestazione (struttura com.sun.star.table.BorderLine)
HeaderRightBorder (struct)
Dettagli del bordo destro della cornice attorno all'intestazione (struttura com.sun.star.table.BorderLine)
HeaderTopBorder (struct)
Dettagli del bordo superiore della cornice attorno all'intestazione (struttura com.sun.star.table.BorderLine)
HeaderBottomBorder (struct)
Dettagli del bordo inferiore della cornice attorno all'intestazione (struttura com.sun.star.table.BorderLine)
HeaderLeftBorderDistance (long)
Distanza tra il bordo sinistro e il contenuto dell'intestazione, espressa in centesimi di millimetro
HeaderRightBorderDistance (long)
Distanza tra il bordo destro e il contenuto dell'intestazione, espressa in centesimi di millimetro
HeaderTopBorderDistance (long)
Distanza tra il bordo superiore e il contenuto dell'intestazione, espressa in centesimi di millimetro
HeaderBottomBorderDistance (long)
Distanza tra il bordo inferiore e il contenuto dell'intestazione, espressa in centesimi di millimetro
HeaderIsShared (Boolean)
Le intestazioni delle pagine pari e delle pagine dispari hanno lo stesso contenuto (vedere HeaderText, HeaderTextLeft e HeaderTextRight)
HeaderBackColor (long)
Colore di sfondo dell'intestazione
HeaderBackGraphicURL (String)
URL dell'immagine di sfondo da usare
HeaderBackGraphicFilter (String)
Nome del filtro che interpreta le immagini di sfondo per l'intestazione
HeaderBackGraphicLocation (Enum)
Posizione delle immagini di sfondo per l'intestazione (valore conforme all'enumerazione com.sun.star.style.GraphicLocation)
HeaderBackTransparent (Boolean)
Mostra lo sfondo dell'intestazione come trasparente
HeaderShadowFormat (struct)
Dettagli dell'ombra dell'intestazione (struttura com.sun.star.table.ShadowFormat)

Le proprietà per la formattazione dei piè di pagina sono le seguenti:

FooterIsOn (Boolean)
Il piè di pagina è attivato
FooterLeftMargin (long)
Distanza tra piè di pagina e margine sinistro della pagina, espressa in centesimi di millimetro
FooterRightMargin (long)
Distanza tra piè di pagina e margine destro della pagina, espressa in centesimi di millimetro
FooterBodyDistance (long)
Distanza tra piè di pagina e corpo principale del documento, espressa in centesimi di millimetro
FooterHeight (long)
Altezza del piè di pagina in centesimi di millimetro
FooterIsDynamicHeight (Boolean)
L'altezza del piè di pagina viene automaticamente adattata al contenuto
FooterLeftBorder (struct)
Dettagli del bordo sinistro della cornice attorno al piè di pagina (struttura com.sun.star.table.BorderLine)
FooterRightBorder (struct)
Dettagli del bordo destro della cornice attorno al piè di pagina (struttura com.sun.star.table.BorderLine)
FooterTopBorder (struct)
Dettagli del bordo superiore della cornice attorno al piè di pagina (struttura com.sun.star.table.BorderLine)
FooterBottomBorder (struct)
Dettagli del bordo inferiore della cornice attorno al piè di pagina (struttura com.sun.star.table.BorderLine)
FooterLeftBorderDistance (long)
Distanza tra il bordo sinistro e il contenuto del piè di pagina, espressa in centesimi di millimetro
FooterRightBorderDistance (long)
Distanza tra il bordo destro e il contenuto del piè di pagina, espressa in centesimi di millimetro
FooterTopBorderDistance (long)
Distanza tra il bordo superiore e il contenuto del piè di pagina, espressa in centesimi di millimetro
FooterBottomBorderDistance (long)
Distanza tra il bordo inferiore e il contenuto del piè di pagina, espressa in centesimi di millimetro
FooterIsShared (Boolean)
I piè di pagina delle pagine pari e delle pagine dispari hanno lo stesso contenuto (vedere FooterText, FooterTextLeft e FooterTextRight)
FooterBackColor (long)
Colore di sfondo del piè di pagina
FooterBackGraphicURL (String)
URL dell'immagine di sfondo da usare
FooterBackGraphicFilter (String)
Nome del filtro che interpreta le immagini di sfondo per il piè di pagina
FooterBackGraphicLocation (Enum)
Posizione delle immagini di sfondo per il piè di pagina (valore conforme all'enumerazione com.sun.star.style.GraphicLocation)
FooterBackTransparent (Boolean)
Mostra lo sfondo del piè di pagina come trasparente
FooterShadowFormat (struct)
Dettagli dell'ombra del piè di pagina (struttura com.sun.star.table.ShadowFormat)

Modifica del testo di intestazioni e piè di pagina

Si accede al contenuto di intestazioni e piè di pagina di un foglio elettronico per mezzo delle seguenti proprietà:

LeftPageHeaderContent (Object)
Contenuto delle intestazioni delle pagine pari (servizio com.sun.star.sheet.HeaderFooterContent)
RightPageHeaderContent (Object)
Contenuto delle intestazioni delle pagine dispari (servizio com.sun.star.sheet.HeaderFooterContent)
LeftPageFooterContent (Object)
Contenuto dei piè di pagina delle pagine pari (servizio com.sun.star.sheet.HeaderFooterContent)
RightPageFooterContent (Object)
Contenuto dei piè di pagina delle pagine dispari (servizio com.sun.star.sheet.HeaderFooterContent)

Se non è necessario distinguere tra intestazioni e piè di pagina di pagine pari e dispari (ovvero la proprietà FooterIsShared è False), impostare le proprietà delle intestazioni e dei piè di pagina sulle pagine dispari.

Tutti gli oggetti citati restituiscono un oggetto che supporta il servizio com.sun.star.sheet.HeaderFooterContent. Per mezzo delle proprietà (non originali) LeftText, CenterText e RightText, questo servizio mette a disposizione tre elementi di testo per le intestazioni e i piè di pagina di Apache OpenOffice Calc.

L'esempio seguente scrive il valore "Just a Test" nel campo di testo di sinistra dell'intestazione del modello "Default". 

Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object 
Dim PageStyles As Object
Dim DefPage As Object
Dim HText As Object
Dim HContent As Object
Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")
 
DefPage.HeaderIsOn = True
HContent = DefPage.RightPageHeaderContent
HText = HContent.LeftText
HText.String = "Just a Test."
DefPage.RightPageHeaderContent = HContent

Osservare l'ultima riga dell'esempio: una volta modificato il testo, per rendere effettiva la modifica l'oggetto TextContent deve essere di nuovo assegnato all'intestazione.

Per i documenti di testo (Apache OpenOffice Writer) è disponibile un altro meccanismo di modifica del testo di intestazioni e piè di pagina, perché in questo contesto sono formati da un singolo blocco di testo. Le proprietà seguenti sono definite nel servizio com.sun.star.style.PageProperties:

HeaderText (Object)
Oggetto testo con i contenuti dell'intestazione (servizio com.sun.star.text.XText)
HeaderTextLeft (Object)
Oggetto testo con i contenuti dell'intestazione delle pagine di sinistra (servizio com.sun.star.text.XText)
HeaderTextRight (Object)
Oggetto testo con i contenuti dell'intestazione delle pagine di destra (servizio com.sun.star.text.XText)
FooterText (Object)
Oggetto testo con i contenuti del piè di pagina (servizio com.sun.star.text.XText)
FooterTextLeft (Object)
Oggetto testo con i contenuti dei piè di pagina delle pagine di sinistra (servizio com.sun.star.text.XText)
FooterTextRight (Object)
Oggetto testo con i contenuti dei piè di pagina delle pagine di destra (servizio com.sun.star.text.XText)

L'esempio seguente crea un'intestazione nel modello di pagina "Default" per i documenti di testo e aggiunge il testo "Just a Test" all'intestazione. 

Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object 
Dim PageStyles As Object
Dim DefPage As Object
Dim HText As Object
 
Doc = StarDesktop.CurrentComponent
StyleFamilies = Doc.StyleFamilies
PageStyles = StyleFamilies.getByName("PageStyles")
DefPage = PageStyles.getByName("Default")
 
DefPage.HeaderIsOn = True
HText = DefPage.HeaderText 
 
HText.String = "Just a Test."

In questo caso, l'accesso viene fornito direttamente tramite la proprietà HeaderText del modello di pagina anziché dall'oggetto HeaderFooterContent.

Centratura (solo fogli elettronici)

Il servizio com.sun.star.sheet.TablePageStyle è utilizzato solo nei modelli di pagina di Apache OpenOffice Calc e permette di centrare sulla pagina gli intervalli di celle da stampare. Questo servizio dispone delle proprietà seguenti:

CenterHorizontally (Boolean)
I contenuti della tabella vengono centrati orizzontalmente
CenterVertically (Boolean)
I contenuti della tabella vengono centrati verticalmente

Definizione degli elementi da stampare (solo fogli elettronici)

Durante la formattazione dei fogli è possibile definire gli elementi della pagina da rendere visibili. A tal fine, il servizio com.sun.star.sheet.TablePageStyle fornisce le proprietà seguenti:

PrintAnnotations (Boolean)
Stampa i commenti delle celle
PrintGrid (Boolean)
Stampa la griglia delle celle
PrintHeaders (Boolean)
Stampa le intestazioni di righe e colonne
PrintCharts (Boolean)
Stampa i diagrammi contenuti in un foglio
PrintObjects (Boolean)
Stampa gli oggetti incorporati
PrintDrawing (Boolean)
Stampa gli oggetti di disegno
PrintDownFirst (Boolean)
Se i contenuti di un foglio si estendono su diverse pagine, vengono prima stampati in ordine decrescente verticale, procedendo in direzione inferiore destra
PrintFormulas (Boolean)
Stampa le formule anziché i valori calcolati
PrintZeroValues (Boolean)
Stampa gli zeri
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/Formatting_Spreadsheet_Documents&oldid=133092"
Personal tools