Difference between revisions of "EN/Documentation/BASIC Guide/Control Element Forms"

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{EN/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Working With Forms |NextPage=Documentation/BASIC Guide/Database Forms |form=...)
 
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:
 
|form=block
 
|form=block
 
}}
 
}}
−
{{DISPLAYTITLE:▼フォーム用コントロール要素の詳細}}
+
{{DISPLAYTITLE:Elementi di controllo dei formulari in dettaglio}}
 
   
 
   
−
▼フォームの作成に用いるコントロール要素は、ダイアログ用のコントロール要素と多くの共通点があります。▼ここでは、テキスト\'83\'7bックスをはじめ、リスト\'83\'7bックスとコン\'83\'7b\'83\'7bックスおよび各種の\'83\'7bタンについて説明します。
+
Gli elementi di controllo disponibili nei formulari sono simili a quelli disponibili nelle finestre di dialogo. Gli elementi a disposizione variano da semplici campi di testo a elenchi, caselle combinate e diversi pulsanti.
  
−
▼以下に、フォーム用コントロール要素の属性のうち、重要度の高いものをまとめます。▼これらの属性は、対応するモデルオブジェクトにも関係します。
+
Di seguito viene fornito un elenco delle proprietà principali degli elementi di controllo dei formulari. Tutte le proprietà formano parte degli oggetti modello associati.
  
−
▼フォームの場合、通常のコントロール要素に加えて、テーブルコントロール要素が使用でき、これを配置することでデータベーステーブル内のデータを直接\'95\'5c示することができます。これは[[Documentation/BASIC Guide/Database Forms|「データベースフォーム」]]の章で説明されています。
+
Oltre agli elementi di controllo standard, per i formulari è disponibile anche un elemento di controllo delle tabelle, che permette di incorporare tabelle di database.  Questo argomento è descritto nel capitolo [[Documentation/BASIC Guide/Database Forms|Formulari basati su database]].
  
−
== ボタン ==
+
== Pulsanti ==
  
−
フォーム用ボタンのモデルオブジェクトには、以下の属性が用意されています。
+
L'oggetto modello di un pulsante di formulario fornisce le seguenti proprietà:
  
−
;<tt>BackgroundColor (long)</tt>: 背景色
+
;<tt>BackgroundColor (long)</tt>:Colore dello sfondo
−
;<tt>DefaultButton (Boolean)</tt>: 標準ボタンとする指定。True を指定した場合、フォーカスのない状態で Enter キーを押した場合に反応します。
+
;<tt>DefaultButton (Boolean)</tt>:Il pulsante funge da valore predefinito; in questo caso, risponde anche al pulsante di immissione se non è attivato
−
;<tt>Enabled (Boolean)</tt>: コントロール要素を有効化する指定。
+
;<tt>Enabled (Boolean)</tt>:L'elemento di controllo può essere attivato
−
;<tt>Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Tabstop (Boolean)</tt>:L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
−
;<tt>TabIndex (Long)</tt>: Tab キーによるフォーカス移動の順序の指定。
+
;<tt>TabIndex (Long)</tt>:Posizione dell'elemento di controllo nella sequenza di attivazione
−
;<tt>FontName (String)</tt>フォントの種類の名前。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>Tag (String)</tt>: プログラム制御によるアクセス用にボタンに格納しておく追加情報用の文字列。
+
;<tt>Tag (String)</tt>:Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
−
;<tt>TargetURL (String)</tt>: ボタンを URL にリンクさせる場合のターゲット URL。
+
;<tt>TargetURL (String)</tt>:URL di destinazione per i pulsanti di tipo URL
−
;<tt>TargetFrame (String)</tt>: <tt>TargetURL</tt> の内容を開くウィンドウ (またはフレーム) の名前 (<tt>URL</tt> 型のボタンをクリックした場合)。
+
;<tt>TargetFrame (String)</tt>:Nome della finestra (o cornice) in cui aprire <tt>TargetURL</tt> all'attivazione del pulsante (per i pulsanti di tipo <tt>URL</tt>)
−
;<tt>Label (String)</tt>: ボタンのラベル。
+
;<tt>Label (String)</tt>:Etichetta del pulsante
−
;<tt>TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>HelpText (String)</tt>:Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo.
−
;<tt>HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
−
;<tt>ButtonType (Enum)</tt>: ボタンアクションの指定 (<idl>com.sun.star.form.FormButtonType</idl> のデフォルト値)。
+
;<tt>ButtonType (Enum)</tt>:Azione collegata al pulsante (valore predefinito di <idl>com.sun.star.form.FormButtonType</idl>)
  
−
<tt>ButtonType</tt> 属性の指定値は、ボタンをクリックした際に実行するアクションを規定します。<idl>com.sun.star.form.FormButtonType</idl> には、この属性指定用に以下の定数値が定められています。
+
Tramite la proprietà <tt>ButtonType</tt> è possibile definire un'azione che viene eseguita automaticamente alla pressione del pulsante. Il gruppo di costanti associato <idl>com.sun.star.form.FormButtonType</idl> fornisce i seguenti valori:
  
−
;<tt>PUSH</tt>: 標準のプッシュ式ボタン。
+
;<tt>PUSH</tt>:Pulsante standard
−
;<tt>SUBMIT</tt>: フォーム入力の終了用 (主として HTML フォームで使用)。
+
;<tt>SUBMIT</tt>:Fine dell'immissione del formulario (di particolare rilevanza per i formulari HTML)
−
;<tt>RESET</tt>: すべてのフォーム入力値の初期状態へのリセット用。
+
;<tt>RESET</tt>:Ripristina tutti i valori del formulario sui valori originali
−
;<tt>URL</tt>: <tt>TargetURL</tt> に指定した URL の呼び出し用 (表示先は <tt>TargetFrame</tt> の指定ウィンドウ)。
+
;<tt>URL</tt>:Chiamata dell'URL definito in <tt>TargetURL</tt> (è aperto nella finestra specificata tramite <tt>TargetFrame</tt>)
  
−
▼ダイアログの場合の '''OK''' および '''キャンセル''' の\'83\'7bタンは、フォームでは用意されていません。
+
I tipi di pulsanti '''OK''' e '''Annulla''' disponibili nelle finestre di dialogo non sono supportati nei formulari.
  
−
==▼ラジオ\'83\'7bタン==
+
== Pulsanti di scelta ==
  
−
オプションボタンの次の属性は、モデルオブジェクトを通じて使用します。
+
Tramite l'oggetto del modello di un pulsante di scelta sono disponibili le proprietà seguenti:
  
−
;<tt>Enabled (Boolean)</tt>: コントロール要素を有効化する指定。
+
;<tt>Enabled (Boolean)</tt>:L'elemento di controllo può essere attivato
−
;<tt>Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Tabstop (Boolean)</tt>:L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
−
;<tt>TabIndex (Long)</tt>: Tab キーによるフォーカス移動の順序の指定。
+
;<tt>TabIndex (Long)</tt>:Posizione dell'elemento di controllo nella sequenza di attivazione
−
;<tt>FontName (String)</tt>フォントの種類の名前。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>Tag (String)</tt>: プログラム制御によるアクセス用にボタンに格納しておく追加情報用の文字列。
+
;<tt>Tag (String)</tt>:Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
−
;<tt>Label (String)</tt>: ボタンの表書き。
+
;<tt>Label (String)</tt>:Etichetta del pulsante
−
;<tt>Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
<tt>State (Short)</tt>: オプションをアクティブとするか (属性値を 1 とした場合)、非アクティブとするかの指定 (その他の値の場合)。
+
;<tt>State (Short)</tt>:Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
−
<tt>RefValue (String)</tt>: 追加情報用の文字列 (データレコード ID の管理用などに使用)。
+
;<tt>RefValue (String)</tt>:Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
−
;<tt>TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>HelpText (String)</tt>:Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
−
;<tt>HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
▼ラジオ\'83\'7bタンをグループ化する方法は、ダイアログとフォームとで異なります。▼ダイアログの場合は、タブストップの順番が連続したものは自動的にグループ化されますが、フォームの場合は、コントロール要素の名前を基準にしてグループ化が行われます。▼つまりグループ化するラジオ\'83\'7bタンには、すべて同じ名前をつけます。{{OOo}}その際には、グループ内の全コントロール要素を 1 つの配列として管理するため、{{OOo}} Basic によるボタン制御はこれまでと同様の方式で実行できます。
+
Il meccanismo di raggruppamento dei pulsanti di scelta opera una distinzione tra gli elementi di controllo delle finestre di dialogo e dei formulari. Mentre gli elementi di controllo visualizzati uno dopo l'altro nelle finestre di dialogo vengono combinati
 +
automaticamente per formare un gruppo, il raggruppamento nei formulari avviene in
 +
base ai nomi. Per procedere in tal senso, tutti i pulsanti di scelta di un gruppo devono contenere lo stesso nome. {{OOo}} combina gli elementi di controllo raggruppati in una matrice, in modo che i singoli pulsanti di un programma in {{OOo}} Basic si possano raggiungere secondo le modalità utilizzate in precedenza.
  
−
▼以下のサンプルコードでは、グループ化したコントロール要素へのアクセス法を示します。
+
L'esempio seguente mostra come determinare il modello di un gruppo di elementi di controllo.
  
 
<source lang="oobas">
 
<source lang="oobas">
Line 84: Line 86:
 
</source>
 
</source>
  
−
▼上記のサンプルコードの処理の流れは、グループ化しない単独のコントロール要素へのアクセス法を説明した、先のサンプルコードのものと基\'96\'7b的に同じです。▼ここでは、現在の文書ドキュメントにあるすべてのフォームを取得してから、ループと <tt>HasByName</tt> メ\'83\'5cッドを用いて、<tt>MyOptions という名前のコントロール要素が配置されたフォームがあるかをチェックしています。</tt>▼そして該当するフォームを検出した時点で、目的とするモデル配列への参照情報を <tt>GetGroupByName</tt> メ\'83\'5cッドにより取得します (グループ化していないモデルの場合に使用したメ\'83\'5cッドは <tt>GetByName</tt>)。
+
Il codice corrisponde all'esempio precedente per la determinazione di un modello di elemento di controllo semplice. Esegue una ricerca in tutti i formulari del documento di testo corrente in un ciclo e utilizza il metodo <tt>HasByName</tt> per controllare se il formulario
 +
corrispondente contiene un elemento con il nome <tt>MyOptions</tt> ricercato. Se l'elemento viene individuato, l'accesso alla matrice del modello viene eseguito tramite il metodo <tt>GetGroupByName</tt> anziché tramite il metodo <tt>GetByName</tt>, utilizzato per determinare i modelli semplici.
  
−
==チェックボックス==
+
== Caselle di controllo ==
  
−
チェックボックスのモデルオブジェクトでは、以下の属性を使用できます。
+
L'oggetto modello di una casella di controllo fornisce le seguenti proprietà:
  
−
;<tt>Enabled (Boolean)</tt>: コントロール要素を有効化する指定。
+
;<tt>Enabled (Boolean)</tt>:L'elemento di controllo può essere attivato
−
;<tt>Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Tabstop (Boolean)</tt>:L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
−
;<tt>TabIndex (Long)</tt>: Tab キーによるフォーカス移動の順序の指定。
+
;<tt>TabIndex (Long)</tt>:Posizione dell'elemento di controllo nella sequenza di attivazione
−
;<tt>FontName (String)</tt>: フォントの種類の名前。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>Tag (String)</tt>: プログラム制御によるアクセス用にボタンに格納しておく追加情報用の文字列。
+
;<tt>Tag (String)</tt>:Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
−
;<tt>Label (String)</tt>: ボタンのラベル。
+
;<tt>Label (String)</tt>:Etichetta del pulsante
−
;<tt>Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>State (Short)</tt>: オプションをアクティブとするか (属性値を 1 とした場合)、非アクティブとするかの指定 (その他の値の場合)。
+
;<tt>State (Short)</tt>:Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
−
;<tt>RefValue (String)</tt>: 追加情報用の文字列 (データレコード ID の管理用などに使用)。
+
;<tt>RefValue (String)</tt>:Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
−
;<tt>TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>HelpText (String)</tt>:Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
−
;<tt>HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
==テキストボックス (テキストフィールド) ==
+
== Campi di testo ==
  
−
テキストフィールドフォームのモデルオブジェクトでは、以下の属性を使用できます。
+
L'oggetto modello di un campo di testo fornisce le seguenti proprietà:
  
−
;<tt>Align (short)</tt>: テキストの配置 (0: 左揃え、1: 中央揃え、2: 右揃え)。
+
;<tt>Align (short)</tt>:Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
−
;<tt>BackgroundColor (long)</tt>: コントロール要素の背景色。
+
;<tt>BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo
−
;<tt>Border (short)</tt>: 外枠の種類 (0: なし、1: 3D 表示、2: 平坦な線)。
+
;<tt>Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
−
;<tt>EchoChar (String)</tt>: パスワードフィールドのエコー文字。
+
;<tt>EchoChar (String)</tt>:Carattere eco per i campi delle password
−
;<tt>FontName (String)</tt>: フォントの種類の名前。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>HardLineBreaks (Boolean)</tt>: コントロール要素のテキスト内で改行する指定。
+
;<tt>HardLineBreaks (Boolean)</tt>:Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
−
;<tt>HScroll (Boolean)</tt>: テキストに横スクロールバーを使用する指定。
+
;<tt>HScroll (Boolean)</tt>:Il testo presenta una barra di scorrimento orizzontale
−
;<tt>MaxTextLen (Short)</tt>: 表示テキストの最大数で、0 の指定は制限無しに対応。
+
;<tt>MaxTextLen (Short)</tt>:Lunghezza massima del testo; se è pari a 0, non sono presenti limiti
−
;<tt>MultiLine (Boolean)</tt>: 複数行項目を許可する指定。
+
;<tt>MultiLine (Boolean)</tt>:Consente voci su più righe
−
;<tt>Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>ReadOnly (Boolean)</tt>: コントロール要素を読み取り専用とする指定。
+
;<tt>ReadOnly (Boolean)</tt>:Il contenuto dell'elemento di controllo è di sola lettura.
−
;<tt>Enabled (Boolean)</tt>: コントロール要素を有効化する指定。
+
;<tt>Enabled (Boolean)</tt>:L'elemento di controllo può essere attivato
−
;<tt>Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Tabstop (Boolean)</tt>:L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
−
<tt>TabIndex (Long)</tt>: Tab キーによるフォーカス移動の順序の指定。
+
;<tt>TabIndex (Long)</tt>:Posizione dell'elemento di controllo nella sequenza di attivazione
−
;<tt>FontName (String)</tt>: フォントの種類の名前。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>Text (String)</tt>: コントロール要素のテキスト。
+
;<tt>Text (String)</tt>:Testo dell'elemento di controllo
−
;<tt>TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>VScroll (Boolean)</tt>: テキストに縦スクロールバーを使用する指定。
+
;<tt>VScroll (Boolean)</tt>:Il testo presenta una barra di scorrimento verticale
−
;<tt>HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>HelpText (String)</tt>:Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
−
;<tt>HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
==リストボックス==
+
== Caselle di riepilogo ==
  
−
ボックスのモデルオブジェクトには、以下の属性が用意されています。
+
L'oggetto modello delle caselle di riepilogo fornisce le seguenti proprietà:
  
−
;<tt>BackgroundColor (long)</tt>: コントロール要素の背景色。
+
;<tt>BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo
−
;<tt>Border (short)</tt>: 外枠の種類 (0: なし、1: 3D 表示、2: 平坦な線)。
+
;<tt>Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
−
;<tt>FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (com.sun.star.awt.FontDescriptor に定められた構造体)。
+
;<tt>FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere utilizzato (in
−
;<tt>LineCount (Short)</tt>: コントロール要素の行数。
+
conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>MultiSelection (Boolean)</tt>: 項目の複数選択を許可する指定。
+
;<tt>LineCount (Short)</tt>:Numero di righe nell'elemento di controllo
−
;<tt>SelectedItems (Array of Strings)</tt>: 強調表示された項目のリスト。
+
;<tt>MultiSelection (Boolean)</tt>:Consente la selezione multipla delle voci
−
;<tt>StringItemList (Array of Strings)</tt>: すべての項目のリスト。
+
;<tt>SelectedItems (Array of Strings)</tt>:Elenco delle voci evidenziate
−
<tt>ValueItemList (Array of Variant)</tt>: 個々の項目に付加する追加情報のリスト (データレコード ID の管理用などに使用)。
+
;<tt>StringItemList (Array of Strings)</tt>:Elenco di tutte le voci
−
;<tt>Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>ValueItemList (Array of Variant)</tt>:Elenco contenente informazioni aggiuntive per ogni voce, ad esempio per la gestione degli ID dei record di dati
−
;<tt>ReadOnly (Boolean)</tt>: コントロール要素を読み取り専用とする指定。
+
;<tt>Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Enabled (Boolean)</tt>: コントロール要素を有効化する指定。
+
;<tt>ReadOnly (Boolean)</tt>:Il contenuto dell'elemento di controllo è di sola lettura.
−
;<tt>Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Enabled (Boolean)</tt>:L'elemento di controllo può essere attivato
−
;<tt>TabIndex (Long)</tt>: Tab キーによるフォーカス移動の順序の指定。
+
;<tt>Tabstop (Boolean)</tt>:L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
−
;<tt>FontName (String)</tt>: フォントの種類の名前。
+
;<tt>TabIndex (Long)</tt>:Posizione dell'elemento di controllo nella sequenza di attivazione
−
;<tt>FontHeight (Single)</tt>: 文字の高さ (ポイント)。
+
;<tt>FontName (String)</tt>:Nome del tipo di carattere
−
;<tt>Tag (String)</tt>: プログラム制御によるアクセス用にボタンに格納しておく追加情報用の文字列。
+
;<tt>FontHeight (Single)</tt>:Altezza del carattere espressa in punti (pt)
−
;<tt>TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Tag (String)</tt>:Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
−
;<tt>HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>HelpText (String)</tt>:Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
 +
;<tt>HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
{{Documentation/Note|▼フォーム用のリスト\'83\'7bックスに用意された <tt>ValueItemList</tt> 属性は、VBA の <tt>ItemData</tt> 属性に相当するもので、リストの各項目に追加情報を付加する際に利用できます。}}
+
{{Note|Attraverso la proprietà  <tt>ValueItemList</tt>, i formulari con caselle di riepilogo forniscono una controparte alla proprietà <tt>ItemData</tt> di VBA attraverso la quale gestire informazioni aggiuntive per le singole voci dell'elenco.}}
  
−
▼リスト\'83\'7bックスの場合、ビューオブジェクトに対して以下の属性が用意されています。
+
Inoltre, tramite l'oggetto vista della casella di
 +
riepilogo sono disponibili i metodi seguenti:
  
−
;<tt>addItem (Item, Pos)</tt>: <tt>Item</tt> として渡された文字列を、<tt>Pos</tt> で指定するリスト位置に挿入します。
+
;<tt>addItem (Item, Pos)</tt>:Inserisce la stringa specificata in <tt>Item</tt> nell'elenco, nella posizione <tt>Pos</tt>
−
;<tt>addItems (ItemArray, Pos)</tt>: 文字列データフィールド <tt>ItemArray</tt> の形で渡された複数の項目を、<tt>Pos</tt> で指定するリスト位置に挿入します。
+
;<tt>addItems (ItemArray, Pos)</tt>:Inserisce le voci elencate nel campo dati <tt>ItemArray</tt> della stringa all'interno dell'elenco, nella posizione <tt>Pos</tt>
−
;<tt>removeItems (Pos, Count)</tt>: <tt>Count</tt> で指定するリスト位置から、<tt>Pos</tt> 個の項目を削除します。
+
;<tt>removeItems (Pos, Count)</tt>:Rimuove le voci <tt>Count</tt> dalla posizione <tt>Pos</tt>
−
;<tt>selectItem (Item, SelectMode)</tt>: 文字列 <tt>Item</tt> に指定された項目の強調表示を、ブール値 <tt>SelectMode</tt> の指定に応じて切り換えます。
+
;<tt>selectItem (Item, SelectMode)</tt>:Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringa <tt>Item</tt> in base alla variabile <tt>SelectMode</tt>
−
;<tt>makeVisible (Pos)</tt>: <tt>Pos</tt> の指定位置にある項目を表示するよう、リストフィールドをスクロールします。
+
;<tt>makeVisible (Pos)</tt>:Scorre il campo in modo che la voce specificata con <tt>Pos</tt> sia
 +
visibile
  
 
{{PDL1}}
 
{{PDL1}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Element Forms}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Element Forms}}

Latest revision as of 14:43, 6 July 2018

Template:EN/Documentation/BASICGuideTOC/v2


Gli elementi di controllo disponibili nei formulari sono simili a quelli disponibili nelle finestre di dialogo. Gli elementi a disposizione variano da semplici campi di testo a elenchi, caselle combinate e diversi pulsanti.

Di seguito viene fornito un elenco delle proprietà principali degli elementi di controllo dei formulari. Tutte le proprietà formano parte degli oggetti modello associati.

Oltre agli elementi di controllo standard, per i formulari è disponibile anche un elemento di controllo delle tabelle, che permette di incorporare tabelle di database. Questo argomento è descritto nel capitolo Formulari basati su database.

Pulsanti

L'oggetto modello di un pulsante di formulario fornisce le seguenti proprietà:

BackgroundColor (long)
Colore dello sfondo
DefaultButton (Boolean)
Il pulsante funge da valore predefinito; in questo caso, risponde anche al pulsante di immissione se non è attivato
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
TargetURL (String)
URL di destinazione per i pulsanti di tipo URL
TargetFrame (String)
Nome della finestra (o cornice) in cui aprire TargetURL all'attivazione del pulsante (per i pulsanti di tipo URL)
Label (String)
Etichetta del pulsante
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo.
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
ButtonType (Enum)
Azione collegata al pulsante (valore predefinito di com.sun.star.form.FormButtonType)

Tramite la proprietà ButtonType è possibile definire un'azione che viene eseguita automaticamente alla pressione del pulsante. Il gruppo di costanti associato com.sun.star.form.FormButtonType fornisce i seguenti valori:

PUSH
Pulsante standard
SUBMIT
Fine dell'immissione del formulario (di particolare rilevanza per i formulari HTML)
RESET
Ripristina tutti i valori del formulario sui valori originali
URL
Chiamata dell'URL definito in TargetURL (è aperto nella finestra specificata tramite TargetFrame)

I tipi di pulsanti OK e Annulla disponibili nelle finestre di dialogo non sono supportati nei formulari.

Pulsanti di scelta

Tramite l'oggetto del modello di un pulsante di scelta sono disponibili le proprietà seguenti:

Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
Label (String)
Etichetta del pulsante
Printable (Boolean)
L'elemento di controllo può essere stampato
State (Short)
Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
RefValue (String)
Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Il meccanismo di raggruppamento dei pulsanti di scelta opera una distinzione tra gli elementi di controllo delle finestre di dialogo e dei formulari. Mentre gli elementi di controllo visualizzati uno dopo l'altro nelle finestre di dialogo vengono combinati automaticamente per formare un gruppo, il raggruppamento nei formulari avviene in base ai nomi. Per procedere in tal senso, tutti i pulsanti di scelta di un gruppo devono contenere lo stesso nome. Apache OpenOffice combina gli elementi di controllo raggruppati in una matrice, in modo che i singoli pulsanti di un programma in Apache OpenOffice Basic si possano raggiungere secondo le modalità utilizzate in precedenza.

L'esempio seguente mostra come determinare il modello di un gruppo di elementi di controllo. 

Dim Doc As Object
Dim Forms As Object
Dim Form As Object
Dim Ctl As Object
Dim I as Integer
 
Doc = StarDesktop.CurrentComponent
Forms = Doc.Drawpage.Forms
 
For I = 0 To Forms.Count - 1
  Form = Forms.GetbyIndex(I)
  If Form.HasByName("MyOptions") Then
    Ctl = Form. GetGroupbyName("MyOptions")
    Exit Function
  End If
Next I

Il codice corrisponde all'esempio precedente per la determinazione di un modello di elemento di controllo semplice. Esegue una ricerca in tutti i formulari del documento di testo corrente in un ciclo e utilizza il metodo HasByName per controllare se il formulario corrispondente contiene un elemento con il nome MyOptions ricercato. Se l'elemento viene individuato, l'accesso alla matrice del modello viene eseguito tramite il metodo GetGroupByName anziché tramite il metodo GetByName, utilizzato per determinare i modelli semplici.

Caselle di controllo

L'oggetto modello di una casella di controllo fornisce le seguenti proprietà:

Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
Label (String)
Etichetta del pulsante
Printable (Boolean)
L'elemento di controllo può essere stampato
State (Short)
Se la proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
RefValue (String)
Stringa per il salvataggio di informazioni aggiuntive, ad esempio per la gestione degli ID dei record di dati
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Campi di testo

L'oggetto modello di un campo di testo fornisce le seguenti proprietà:

Align (short)
Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
EchoChar (String)
Carattere eco per i campi delle password
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
HardLineBreaks (Boolean)
Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
HScroll (Boolean)
Il testo presenta una barra di scorrimento orizzontale
MaxTextLen (Short)
Lunghezza massima del testo; se è pari a 0, non sono presenti limiti
MultiLine (Boolean)
Consente voci su più righe
Printable (Boolean)
L'elemento di controllo può essere stampato
ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è di sola lettura.
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Text (String)
Testo dell'elemento di controllo
TextColor (Long)
Colore del testo dell'elemento di controllo
VScroll (Boolean)
Il testo presenta una barra di scorrimento verticale
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

L'oggetto modello delle caselle di riepilogo fornisce le seguenti proprietà:

BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
FontDescriptor (struct)
Struttura che specifica i dettagli del carattere utilizzato (in

conformità alla struttura com.sun.star.awt.FontDescriptor)

LineCount (Short)
Numero di righe nell'elemento di controllo
MultiSelection (Boolean)
Consente la selezione multipla delle voci
SelectedItems (Array of Strings)
Elenco delle voci evidenziate
StringItemList (Array of Strings)
Elenco di tutte le voci
ValueItemList (Array of Variant)
Elenco contenente informazioni aggiuntive per ogni voce, ad esempio per la gestione degli ID dei record di dati
Printable (Boolean)
L'elemento di controllo può essere stampato
ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è di sola lettura.
Enabled (Boolean)
L'elemento di controllo può essere attivato
Tabstop (Boolean)
L'elemento di controllo può essere raggiunto tramite il tasto di tabulazione
TabIndex (Long)
Posizione dell'elemento di controllo nella sequenza di attivazione
FontName (String)
Nome del tipo di carattere
FontHeight (Single)
Altezza del carattere espressa in punti (pt)
Tag (String)
Stringa contenente informazioni aggiuntive, che possono essere salvate con il pulsante per l'accesso controllato dal programma
TextColor (Long)
Colore del testo dell'elemento di controllo
HelpText (String)
Testo della guida in linea visualizzato automaticamente se il cursore del mouse si trova sull'elemento di controllo
HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
Documentation note.png Attraverso la proprietà ValueItemList, i formulari con caselle di riepilogo forniscono una controparte alla proprietà ItemData di VBA attraverso la quale gestire informazioni aggiuntive per le singole voci dell'elenco.

Inoltre, tramite l'oggetto vista della casella di riepilogo sono disponibili i metodi seguenti:

addItem (Item, Pos)
Inserisce la stringa specificata in Item nell'elenco, nella posizione Pos
addItems (ItemArray, Pos)
Inserisce le voci elencate nel campo dati ItemArray della stringa all'interno dell'elenco, nella posizione Pos
removeItems (Pos, Count)
Rimuove le voci Count dalla posizione Pos
selectItem (Item, SelectMode)
Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringa Item in base alla variabile SelectMode
makeVisible (Pos)
Scorre il campo in modo che la voce specificata con Pos sia

visibile

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/Control_Element_Forms&oldid=240438"
Personal tools