Difference between revisions of "EN/Documentation/BASIC Guide/Control Elements"

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{EN/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Events |NextPage=Documentation/BASIC Guide/Forms |dial=block }} {{DISPLAYTIT...)
 
Line 6: Line 6:
 
|dial=block
 
|dial=block
 
}}
 
}}
−
{{DISPLAYTITLE:▼ダイアログコントロールの詳細}}
+
{{DISPLAYTITLE:Elementi di controllo delle finestre di dialogo in dettaglio}}
 
   
 
   
−
{{OOo}} Basic には各種のコントロール要素が用意されていますが、これらは以下の 4 つのグループに分類できます。
+
{{OOo}} Basic riconosce una serie di elementi di controllo che si possono suddividere nei seguenti gruppi:
  
 
{| class="wikitable"
 
{| class="wikitable"
−
!入力フィールド!!ボタン!!選択リスト!!その他
+
!Campi di immissione!!Pulsanti!!Caselle di selezione!!Altri elementi di controllo
 
|-valign=top
 
|-valign=top
 
|
 
|
−
*▼テキストフィールド (テキスト\'83\'7bックス)
+
* Campi di testo
−
*▼日付フィールド
+
* Campi per la data
−
*▼時刻フィールド
+
* Campi per l'ora
−
*▼番号フィールド
+
* Campi numerici
−
*▼通貨フィールド
+
* Campi di valuta
−
*▼その他の書式設定可\'94\'5cなフィールド
+
* Campi che adottano qualsiasi formato
 
|
 
|
−
*▼標準\'83\'7bタン (コ\'83\'7dンド\'83\'7bタン)
+
* Pulsanti standard
−
*▼チェック\'83\'7bックス
+
* Caselle di controllo
−
*▼ラジオ\'83\'7bタン
+
* Pulsanti di scelta
 
|
 
|
−
*▼リスト\'83\'7bックス
+
* Caselle di riepilogo
−
*▼コン\'83\'7b\'83\'7bックス
+
* Caselle combinate
 
|
 
|
−
*▼スクロールバー (水平および垂直スクロールバー)
+
* Barre di scorrimento (orizzontali e verticali)
−
*▼グループ枠
+
* Campi di gruppi
−
*▼進行グラフ
+
* Barre di avanzamento
−
*▼分割線 (横線および縦線)
+
* Linee di divisione (orizzontali e verticali)
−
*▼\'90\'7dオブジェクト
+
* Immagini
−
*▼ファイルの選択
+
* Campi di selezione file
 
|}
 
|}
  
−
== ボタン ==
+
== Pulsanti ==
  
−
▼\'83\'7bタンは、ユーザーによるクリックに応じて、特定のアクションを実行させる際に使用します。
+
Un pulsante esegue un'azione quando si fa clic su di esso.
  
−
<tt>最も単純な使用法は、ユーザーのクリックで発生する「When Initiating</tt>」イベントをトリガーとして、ボタンのアクションを実行させるという使い方です。▼また\'83\'7bタンに他のアクションを割り当てて <tt>PushButtonType 属性を利用し、別のダイアログを開くという処理も可\'94\'5cです。</tt>▼この属性値を 0 とした\'83\'7bタンをクリックしても、ダイアログはそのまま残されます。▼この属性値を 1 とした\'83\'7bタンをクリックした場合、ダイアログは閉じられ、ダイアログを\'95\'5c示していた <tt>Execute メ\'83\'5cッドは戻り値として 1 を返します (ダイアログの処理は正常終了)。</tt><tt>PushButtonType</tt> の属性値を 2 としたボタンをクリックした場合、ダイアログは閉じられ、ダイアログを表示していた <tt>Execute</tt> メソッドは戻り値として 0 を返します。
+
Lo scenario più semplice è quello dell'attivazione di un evento <tt>When Initiating</tt> alla pressione del pulsante da parte dell'utente. È inoltre possibile collegare un'altra azione al pulsante per aprire una finestra di dialogo utilizzando la proprietà <tt>PushButtonType</tt>. Quando si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 0, la finestra di dialogo rimarrà invariata. Se si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 1, la finestra di dialogo viene chiusa e il metodo <tt>Execute</tt> della finestra di dialogo restituisce il valore 1 (la sequenza è stata terminata correttamente). Se il valore di <tt>PushButtonType</tt> è 2,
 +
la finestra di dialogo viene chiusa e il metodo <tt>Execute</tt> della finestra di dialogo restituisce 0 (finestra di dialogo chiusa).
  
−
▼以下に、\'83\'7bタンモデルで利用可\'94\'5cなすべての属性を示します。
+
Di seguito sono riportate tutte le proprietà disponibili tramite il modello del pulsante:
  
−
;<tt>Model.BackgroundColor (long)</tt>: 背景の色。
+
;<tt>Model.BackgroundColor (long)</tt>:Colore dello sfondo
−
;<tt>Model.DefaultButton (Boolean)</tt>: フォーカスのない状態で Enter キーが押された場合に反応させる標準ボタンとする指定
+
;<tt>Model.DefaultButton (Boolean)</tt>:Il pulsante è utilizzato come valore predefinito e risponde al tasto Invio se non è attivato.
−
;<tt>Model.FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (<idl>com.sun.star.awt.FontDescriptor</idl> に定められた構造体)
+
;<tt>Model.FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>Model.Label (String)</tt>: ボタンに表示するラベル (タイトル)
+
;<tt>Model.Label (String)</tt>:Etichetta visualizzata sul pulsante
−
;<tt>Model.Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Model.Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Model.TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Model.TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>Model.HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示させるヘルプテキスト
+
;<tt>Model.HelpText (String)</tt>:Testo della guida in linea che viene visualizzato quando si porta il puntatore del mouse sull'elemento di controllo
−
;<tt>Model.HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>Model.HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
−
;<tt>PushButtonType (short)</tt>: ボタンアクションの指定 (0: なし、1: OK、2: キャンセル)
+
;<tt>PushButtonType (short)</tt>:Azione collegata al pulsante (0: nessuna azione, 1: OK, 2: Annulla)
  
−
==▼ラジオ\'83\'7bタン==
+
== Pulsanti di scelta ==
  
−
▼通常これらは複数の\'83\'7bタンをグループ化して、そのうち 1 つのオプションを選択することにより使用します。▼その際にオプションの 1 つが選択されると、残りのオプションは非選択状態になります。▼このように処理することで、選択状態にあるオプションは常に 1 つだけになります。
+
Questi pulsanti sono generalmente utilizzati in gruppi e permettono di selezionare un'opzione da una serie. Quando si seleziona un'opzione, tutte le altre opzioni del gruppo vengono disattivate. Ciò garantisce che in ogni momento sia impostato un
 +
solo pulsante di scelta.
  
−
▼ラジオ\'83\'7bタンのコントロール要素には、以下の 2 つの属性があります。
+
L'elemento di controllo di un pulsante di scelta fornisce due proprietà:
  
−
;<tt>State (Boolean)</tt>: ボタンの有効化。
+
;<tt>State (Boolean)</tt>:Attiva il pulsante
−
;<tt>Label (String)</tt>: ボタンに表示するラベル (タイトル)
+
;<tt>Label (String)</tt>:Etichetta visualizzata sul pulsante
  
−
▼ラジオ\'83\'7bタンのモデルからは、以下の属性も使用できます。
+
Potete utilizzare le seguenti proprietà del modello dei pulsanti di scelta:
  
−
;<tt>Model.FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (<idl>com.sun.star.awt.FontDescriptor</idl> に定められた構造体)。
+
;<tt>Model.FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>Model.Label (String)</tt>: コントロール要素に表示するラベル (タイトル)
+
;<tt>Model.Label (String)</tt>:Etichetta visualizzata sull'elemento di controllo
−
;<tt>Model.Printable (Boolean)</tt>: コントロール要素が印刷できると指定。
+
;<tt>Model.Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Model.State (Short)</tt>: オプションをアクティブとするか (属性値を 1 とした場合)、非アクティブとするかの指定 (その他の値の場合)。
+
;<tt>Model.State (Short)</tt>:Se questa proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
−
;<tt>Model.TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Model.TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>Model.HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>Model.HelpText (String)</tt>:Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
−
;<tt>Model.HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>Model.HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
複数のラジオボタンをグループ化する場合は、これらをアクティブ化する順序の設定値 (<tt>Model.TabIndex</tt> 属性の指定値で、ダイアログエディタ上では順序の指定に該当) に連続した値を指定しておく必要があります。''''''▼アクティブ化する順序の途中に他のコントロール要素が入っていると、{{OOo}} は新規のコントロール要素グループが始まるものと判断するため、\'96\'7b来のグループ内部での切り替えが想定通りに行えなくなります。
+
Per combinare diversi pulsanti di scelta in un gruppo, occorre posizionarli uno dopo l'altro nella sequenza di attivazione senza spazi (proprietà <tt>Model.TabIndex</tt>''',''' descritta come sequenza nel Dialog Editor). Se la sequenza di attivazione viene interrotta da un altro elemento di controllo, {{OOo}} è avviato automaticamente con un nuovo gruppo di elementi di controllo attivabile indipendentemente dal primo gruppo di elementi di controllo.
  
−
{{Documentation/Note|VBA とは異なり {{OOo}} Basic では、グループ枠の中にラジオボタンを挿入するということはできません。{{OOo}} Basic に用意されているグループ枠というコントロール要素は、グループ化するコントロール要素を目で見て区別できるように、これらを囲む枠線を引くだけのものです。}}
+
{{Documentation/Note|Diversamente che in VBA, in {{OOo}} Basic non è possibile inserire i pulsanti di scelta in un gruppo di elementi di controllo. Il raggruppamento degli elementi di controllo è utilizzato in {{OOo}} Basic solo per garantire una suddivisione visiva rappresentata da una cornice intorno agli elementi di controllo.}}
  
−
==チェックボックス==
+
== Caselle di controllo ==
  
−
▼チェック\'83\'7bックスは基\'96\'7b的に Yes または No の形式の情報を入力するために使用しますが、モード設定によっては、このような 2 つのステータス間だけでなく、3 つのステータス間で選択することもできます。▼通常使用するのは Yes か No かの選択肢ですが、どちらともつかない中間状態が選択肢としてあり得る場合は、それを示すステータスも\'95\'5c示できます。
+
Le caselle di controllo vengono utilizzate per registrare un valore Sì o No e, a seconda della modalità, possono adottare due o tre stati. Oltre agli stati Sì e No, una casella di controllo può disporre di uno stato intermedio se lo stato Sì o No corrispondente ha più di un significato o non è chiaro.
  
−
▼チェック\'83\'7bックスには、以下の属性を指定できます。
+
Le caselle di controllo forniscono le proprietà seguenti:
  
−
;<tt>State (Short)</tt>: チェックボックスの状態 (0: No、1: Yes、2: 中間状態)
+
;<tt>State (Short)</tt>:Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
−
;<tt>Label (String)</tt>: コントロール要素のラベル。
+
;<tt>Label (String)</tt>:Etichetta dell'elemento di controllo
−
;<tt>enableTriState (Boolean)</tt>: 選択状態と非選択状態の他に、中間状態を表示する指定
+
;<tt>enableTriState (Boolean)</tt>:Oltre agli stati attivati e disattivati, potete utilizzare anche lo stato intermedio
  
−
▼チェック\'83\'7bックスのモデルオブジェクトでは、以下の属性を使用できます。
+
L'oggetto modello di una casella di controllo fornisce le seguenti proprietà:
  
−
;<tt>Model.FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (<idl>com.sun.star.awt.FontDescriptor</idl> に定められた構造体)。
+
;<tt>Model.FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>Model.Label (String)</tt>: コントロール要素のラベル。
+
;<tt>Model.Label (String)</tt>:Etichetta dell'elemento di controllo
−
;<tt>Model.Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Model.Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Model.State (Short)</tt>: チェックボックスの状態 (0: No、1: Yes、2: 中間状態)
+
;<tt>Model.State (Short)</tt>:Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
−
;<tt>Model.Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Model.Tabstop (Boolean)</tt>:Consente di selezionare l'elemento di controllo con il tasto Tab
−
;<tt>Model.TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Model.TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>Model.HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示させるヘルプテキスト。
+
;<tt>Model.HelpText (String)</tt>:Testo della guida in linea che viene visualizzato quando si posiziona il puntatore del mouse sull'elemento di controllo
−
;<tt>Model.HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>Model.HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
==テキストボックス (テキストフィールド) ==
+
== Campi di testo ==
  
−
▼テキスト\'83\'7bックスは、ユーザーによる数値およびテキストの入力に使用できます。<idl>com.sun.star.awt.UnoControlEdit.サービスにより、テキストボックスの機能が主として提供されています。
+
I campi di testo consentono agli utenti di inserire numeri e testo. Il servizio <idl>com.sun.star.awt.UnoControlEdit.</idl> costituisce la base per i campi di testo.
  
−
▼テキスト\'83\'7bックスの\'95\'5c示は 1 行に制限することもできれば、複数行\'95\'5c示を許可することも可\'94\'5cで、またユーザーからの入力内容を編集することも、読み取り専用とすることもできます。▼またテキスト\'83\'7bックスは、通常の通貨フィールドや番号フィールドまたはパターンフィールドでは処理しきれない場合の代用フィールドとしても利用できます。▼そもそも、これらのコントロール要素はどれも Uno サービスの <tt>UnoControlEdit</tt> をベースとしているので、基\'96\'7b的に共通した手法でプログラム制御をすることができます。
+
Un campo di testo può contenere una o più righe e può essere modificato o bloccato per le immissioni degli utenti. I campi di testo possono essere utilizzati anche come campi numerici e di valuta speciali nonché per attività speciali. Poiché questi elementi di controllo sono basati sul servizio <tt>UnoControlEdit</tt> Uno, la loro gestione controllata da programma è analoga.
  
−
▼テキスト\'83\'7bックスには、以下の属性が用意されています。
+
I campi di testo forniscono le proprietà seguenti:
  
−
;<tt>Text (String)</tt>: 現在のテキスト
+
;<tt>Text (String)</tt>:Testo corrente
−
;<tt>SelectedText (String)</tt>: 現在強調表示されているテキスト。
+
;<tt>SelectedText (String)</tt>:Testo attualmente evidenziato
−
;<tt>Selection (Struct)</tt>; 読み取りの強調表示設定 (<idl>com.sun.star.awt.Selection</idl> に定められた構造体で、<tt>Min</tt> および <tt>Max</tt> 属性により強調表示の開始と終了箇所を指定)
+
;<tt>Selection (Struct)</tt>:Evidenziazione in sola lettura dei dettagli (struttura conforme a <idl>com.sun.star.awt.Selection</idl>, con le proprietà <tt>Min</tt> e <tt>Max</tt> per specificare
−
;<tt>MaxTextLen (short)</tt>: フィールド内に入力可能な最大文字数。
+
l'inizio e la fine dell'evidenziazione)
−
<tt>Editable (Boolean)</tt>: テキスト入力が許可されるか (<tt>True</tt>)、拒否されるか (<tt>False</tt>) の設定 (この属性は <tt>IsEditable</tt> を介した間接的な利用のみが可能)
+
;<tt>MaxTextLen (short)</tt>:Numero massimo di caratteri che si possono inserire nel campo
−
;<tt>IsEditable (Boolean)</tt>: コントロール要素の内容の変更を許可するか、読み取り専用とするかの指定。
+
;<tt>Editable (Boolean)</tt>:<tt>True</tt> attiva l'opzione per l'inserimento del testo, <tt>False</tt> blocca l'opzione di inserimento (la proprietà non può essere richiamata direttamente, ma solo tramite <tt>IsEditable</tt>)
 +
;<tt>IsEditable (Boolean)</tt>:Il contenuto dell'elemento di controllo può essere modificato in sola lettura.
  
−
モデルオブジェクトからは、以下の属性を利用できます。
+
Inoltre, sono fornite le seguenti proprietà tramite l'oggetto del modello associato:
  
−
;<tt>Model.Align (short)</tt>: テキストの配置 (0: 左揃え、1: 中央揃え、2: 右揃え)。
+
;<tt>Model.Align (short)</tt>:Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
−
;<tt>Model.BackgroundColor (long)</tt>: コントロール要素の背景色。
+
;<tt>Model.BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo
−
;<tt>Model.Border (short)</tt>: 外枠の種類 (0: なし、1: 3D 表示、2: 平坦な線)。
+
;<tt>Model.Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
−
;<tt>Model.EchoChar (String)</tt>: パスワードフィールドのエコー文字。
+
;<tt>Model.EchoChar (String)</tt>:Carattere eco per i campi delle password
−
;<tt>Model.FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (<idl>com.sun.star.awt.FontDescriptor</idl> に定められた構造体)。
+
;<tt>Model.FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>Model.HardLineBreaks (Boolean)</tt>: コントロール要素のテキスト内で改行する指定。
+
;<tt>Model.HardLineBreaks (Boolean)</tt>:Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
−
;<tt>Model.HScroll (Boolean)</tt>: テキストに横スクロールバーを使用する指定。
+
;<tt>Model.HScroll (Boolean)</tt>:Il testo ha una barra di scorrimento orizzontale
−
;<tt>Model.MaxTextLen (Short)</tt>: 表示テキストの最大数で、0 の指定は制限無しに対応。
+
;<tt>Model.MaxTextLen (Short)</tt>:Lunghezza massima del testo, dove 0 corrisponde a nessun limite di lunghezza
−
;<tt>Model.MultiLine (Boolean)</tt>: 数行に渡る項目を許可。
+
;<tt>Model.MultiLine (Boolean)</tt>:Consente alla voce di occupare diverse righe
−
;<tt>Model.Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Model.Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Model.ReadOnly (Boolean)</tt>: コントロール要素を読み取り専用とする指定。
+
;<tt>Model.ReadOnly (Boolean)</tt>:Il contenuto dell'elemento di controllo è in sola lettura
−
;<tt>Model.Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Model.Tabstop (Boolean)</tt>:Consente di raggiungere l'elemento di controllo con il tasto Tab
−
;<tt>Model.Text (String)</tt>: コントロール要素に関連するテキスト。
+
;<tt>Model.Text (String)</tt>:Testo associato all'elemento di controllo
−
;<tt>Model.TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Model.TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>Model.VScroll (Boolean)</tt>: テキストに縦スクロールバーを使用する指定。
+
;<tt>Model.VScroll (Boolean)</tt>:Il testo ha una barra di scorrimento verticale
−
;<tt>Model.HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>Model.HelpText (String)</tt>:Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
−
;<tt>Model.HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>Model.HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
==リストボックス==
+
== Caselle di riepilogo ==
  
−
リストボックス (<idl>com.sun.star.awt.UnoControlListBox</idl> サービス) は、以下の属性をサポートしています。
+
Le caselle di riepilogo (servizio <idl>com.sun.star.awt.UnoControlListBox</idl>) supportano le seguenti proprietà:
  
−
;<tt>ItemCount (Short)</tt>要素数 (読み取り専用)。
+
;<tt>ItemCount (Short)</tt>:Numero di elementi, sola lettura
−
;<tt>SelectedItem (String)</tt>: 強調表示された項目のテキスト (読み取り専用)。
+
;<tt>SelectedItem (String)</tt>:Testo della voce evidenziata, sola lettura
−
;<tt>SelectedItems (Array Of Strings)</tt>: 強調表示された項目のデータフィールド (読み取り専用)。
+
;<tt>SelectedItems (Array Of Strings)</tt>:Campo di dati con voci evidenziate, sola lettura
−
;<tt>SelectItemPos (Short)</tt>: 強調表示中の項目の数 (読み取り専用)。
+
;<tt>SelectItemPos (Short)</tt>:Numero della voce attualmente evidenziata, sola lettura
−
;<tt>SelectItemsPos (Array of Short)</tt> 強調表示中の項目の数を格納したデータフィールド (複数選択可能なリストボックスのみ。読み取り専用)。
+
;<tt>SelectItemsPos (Array of Short)</tt>:Campo di dati con il numero di voci evidenziate (per gli elenchi che supportano la selezione multipla), sola lettura
−
;<tt>MultipleMode (Boolean)</tt>: 複数選択が許可されるか (<tt>True</tt>)、拒否されるか (<tt>False</tt>) の設定 (この属性は <tt>IsMultipleMode</tt> を介した間接的な利用のみが可能)
+
;<tt>MultipleMode (Boolean)</tt>:<tt>True</tt> attiva l'opzione per la selezione di più elementi, <tt>False</tt> blocca la selezione multipla (la proprietà non può essere richiamata direttamente, ma solo tramite<tt>IsMultipleMode</tt>)
−
;<tt>IsMultipleMode (Boolean)</tt>: リスト内の複数選択を許可する指定 (読み取り専用)。
+
;<tt>IsMultipleMode (Boolean)</tt>:Consente la selezione multipla all'interno degli elenchi, sola lettura
  
−
▼リスト\'83\'7bックスには、以下のメ\'83\'5cッドが用意されています。
+
Le caselle di riepilogo forniscono 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 nell'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> della 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 booleana <tt>SelectMode</tt>
−
;<tt>makeVisible (Pos)</tt>: <tt>Pos</tt> の指定位置にある項目を表示するよう、リストフィールドをスクロールします。
+
;<tt>makeVisible (Pos)</tt>:Scorre il campo in modo che risulti visibile la voce specificata con <tt>Pos</tt>
  
−
▼リスト\'83\'7bックスのモデルオブジェクトには、以下の属性が用意されています。
+
L'oggetto modello delle caselle di riepilogo fornisce le seguenti proprietà:
  
−
;<tt>Model.BackgroundColor (long)</tt>: コントロール要素の背景色。
+
;<tt>Model.BackgroundColor (long)</tt>:Colore di sfondo dell'elemento di controllo
−
;<tt>Model.Border (short)</tt>: 外枠の種類 (0: なし、1: 3D 表示、2: 平坦な線)。
+
;<tt>Model.Border (short)</tt>:Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
−
;<tt>Model.FontDescriptor (struct)</tt>: 表示フォントの詳細指定用の構造体 (<idl>com.sun.star.awt.FontDescriptor</idl> に定められた構造体)。
+
;<tt>Model.FontDescriptor (struct)</tt>:Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura <idl>com.sun.star.awt.FontDescriptor</idl>)
−
;<tt>Model.LineCount (Short)</tt>: コントロール要素の行数。
+
;<tt>Model.LineCount (Short)</tt>:Numero di righe nell'elemento di controllo
−
;<tt>Model.MultiSelection (Boolean)</tt>: 項目の複数選択を許可する指定。
+
;<tt>Model.MultiSelection (Boolean)</tt>:Consente la selezione multipla delle voci
−
;<tt>Model.SelectedItems (Array of Strings)</tt>: 強調表示された項目のリスト。
+
;<tt>Model.SelectedItems (Array of Strings)</tt>:Elenco delle voci evidenziate
−
;<tt>Model.StringItemList (Array of Strings)</tt>: すべての項目のリスト。
+
;<tt>Model.StringItemList (Array of Strings)</tt>:Elenco di tutte le voci
−
;<tt>Model.Printable (Boolean)</tt>: コントロール要素を印刷する指定。
+
;<tt>Model.Printable (Boolean)</tt>:L'elemento di controllo può essere stampato
−
;<tt>Model.ReadOnly (Boolean)</tt>: コントロール要素を読み取り専用とする指定。
+
;<tt>Model.ReadOnly (Boolean)</tt>:Il contenuto dell'elemento di controllo è in sola lettura
−
;<tt>Model.Tabstop (Boolean)</tt>: コントロール要素を Tab キーによるフォーカス移動の対象にする指定。
+
;<tt>Model.Tabstop (Boolean)</tt>:Consente di selezionare l'elemento di controllo con il tasto Tab
−
;<tt>Model.TextColor (Long)</tt>: コントロール要素のテキストの色。
+
;<tt>Model.TextColor (Long)</tt>:Colore del testo dell'elemento di controllo
−
;<tt>Model.HelpText (String)</tt>: コントロール要素にマウスポインタを重ねた際に表示するヘルプテキスト。
+
;<tt>Model.HelpText (String)</tt>:Visualizza automaticamente il testo della guida in linea quando il puntatore del mouse è posizionato sull'elemento di controllo
−
;<tt>Model.HelpURL (String)</tt>: コントロール要素で使用するオンラインヘルプの URL。
+
;<tt>Model.HelpURL (String)</tt>:URL della guida in linea per l'elemento di controllo corrispondente
  
−
{{Documentation/Note|VBA に用意されているリスト項目への数値付加オプション (<tt>ItemData</tt>) は、{{OOo}} Basic では利用できません。▼リスト\'83\'7bックスの項目に数値 (データベース ID など) を割り当てるのであれば、追加のデータフィールドを用意して、両者のデータを格納するようにします。}}
+
{{Documentation/Note|L'opzione di VBA per l'emissione delle voci di elenco con un valore numerico addizionale (<tt>ItemData</tt>) non esiste in {{OOo}} Basic. Per gestire un valore numerico (ad esempio un ID di database) oltre al testo in linguaggio naturale, occorre creare un campo di dati ausiliario di gestione parallela alla casella di riepilogo.}}
  
 
{{PDL1}}
 
{{PDL1}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Elements}}
 
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Elements}}

Revision as of 18:21, 25 June 2009

Template:EN/Documentation/BASICGuideTOC/v2


Apache OpenOffice Basic riconosce una serie di elementi di controllo che si possono suddividere nei seguenti gruppi:

Campi di immissione Pulsanti Caselle di selezione Altri elementi di controllo
  • Campi di testo
  • Campi per la data
  • Campi per l'ora
  • Campi numerici
  • Campi di valuta
  • Campi che adottano qualsiasi formato
  • Pulsanti standard
  • Caselle di controllo
  • Pulsanti di scelta
  • Caselle di riepilogo
  • Caselle combinate
  • Barre di scorrimento (orizzontali e verticali)
  • Campi di gruppi
  • Barre di avanzamento
  • Linee di divisione (orizzontali e verticali)
  • Immagini
  • Campi di selezione file

Pulsanti

Un pulsante esegue un'azione quando si fa clic su di esso.

Lo scenario più semplice è quello dell'attivazione di un evento When Initiating alla pressione del pulsante da parte dell'utente. È inoltre possibile collegare un'altra azione al pulsante per aprire una finestra di dialogo utilizzando la proprietà PushButtonType. Quando si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 0, la finestra di dialogo rimarrà invariata. Se si fa clic su un pulsante per il quale questa proprietà è stata impostata sul valore 1, la finestra di dialogo viene chiusa e il metodo Execute della finestra di dialogo restituisce il valore 1 (la sequenza è stata terminata correttamente). Se il valore di PushButtonType è 2, la finestra di dialogo viene chiusa e il metodo Execute della finestra di dialogo restituisce 0 (finestra di dialogo chiusa).

Di seguito sono riportate tutte le proprietà disponibili tramite il modello del pulsante:

Model.BackgroundColor (long)
Colore dello sfondo
Model.DefaultButton (Boolean)
Il pulsante è utilizzato come valore predefinito e risponde al tasto Invio se non è attivato.
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta visualizzata sul pulsante
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando si porta il puntatore del mouse sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente
PushButtonType (short)
Azione collegata al pulsante (0: nessuna azione, 1: OK, 2: Annulla)

Pulsanti di scelta

Questi pulsanti sono generalmente utilizzati in gruppi e permettono di selezionare un'opzione da una serie. Quando si seleziona un'opzione, tutte le altre opzioni del gruppo vengono disattivate. Ciò garantisce che in ogni momento sia impostato un solo pulsante di scelta.

L'elemento di controllo di un pulsante di scelta fornisce due proprietà:

State (Boolean)
Attiva il pulsante
Label (String)
Etichetta visualizzata sul pulsante

Potete utilizzare le seguenti proprietà del modello dei pulsanti di scelta:

Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta visualizzata sull'elemento di controllo
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.State (Short)
Se questa proprietà è uguale a 1, l'opzione è attivata, altrimenti è disattivata
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Per combinare diversi pulsanti di scelta in un gruppo, occorre posizionarli uno dopo l'altro nella sequenza di attivazione senza spazi (proprietà Model.TabIndex, descritta come sequenza nel Dialog Editor). Se la sequenza di attivazione viene interrotta da un altro elemento di controllo, Apache OpenOffice è avviato automaticamente con un nuovo gruppo di elementi di controllo attivabile indipendentemente dal primo gruppo di elementi di controllo.

Template:Documentation/Note

Caselle di controllo

Le caselle di controllo vengono utilizzate per registrare un valore Sì o No e, a seconda della modalità, possono adottare due o tre stati. Oltre agli stati Sì e No, una casella di controllo può disporre di uno stato intermedio se lo stato Sì o No corrispondente ha più di un significato o non è chiaro.

Le caselle di controllo forniscono le proprietà seguenti:

State (Short)
Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
Label (String)
Etichetta dell'elemento di controllo
enableTriState (Boolean)
Oltre agli stati attivati e disattivati, potete utilizzare anche lo stato intermedio

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

Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.Label (String)
Etichetta dell'elemento di controllo
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.State (Short)
Stato della casella di controllo (0: no, 1: sì, 2: stato intermedio)
Model.Tabstop (Boolean)
Consente di selezionare l'elemento di controllo con il tasto Tab
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando si posiziona il puntatore del mouse sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Campi di testo

I campi di testo consentono agli utenti di inserire numeri e testo. Il servizio com.sun.star.awt.UnoControlEdit. costituisce la base per i campi di testo.

Un campo di testo può contenere una o più righe e può essere modificato o bloccato per le immissioni degli utenti. I campi di testo possono essere utilizzati anche come campi numerici e di valuta speciali nonché per attività speciali. Poiché questi elementi di controllo sono basati sul servizio UnoControlEdit Uno, la loro gestione controllata da programma è analoga.

I campi di testo forniscono le proprietà seguenti:

Text (String)
Testo corrente
SelectedText (String)
Testo attualmente evidenziato
Selection (Struct)
Evidenziazione in sola lettura dei dettagli (struttura conforme a com.sun.star.awt.Selection, con le proprietà Min e Max per specificare

l'inizio e la fine dell'evidenziazione)

MaxTextLen (short)
Numero massimo di caratteri che si possono inserire nel campo
Editable (Boolean)
True attiva l'opzione per l'inserimento del testo, False blocca l'opzione di inserimento (la proprietà non può essere richiamata direttamente, ma solo tramite IsEditable)
IsEditable (Boolean)
Il contenuto dell'elemento di controllo può essere modificato in sola lettura.

Inoltre, sono fornite le seguenti proprietà tramite l'oggetto del modello associato:

Model.Align (short)
Orientamento del testo (0: allineato a sinistra, 1: centrato, 2: allineato a destra)
Model.BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Model.Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
Model.EchoChar (String)
Carattere eco per i campi delle password
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.HardLineBreaks (Boolean)
Interruzioni di riga automatiche inserite in modo permanente nel testo dell'elemento di controllo
Model.HScroll (Boolean)
Il testo ha una barra di scorrimento orizzontale
Model.MaxTextLen (Short)
Lunghezza massima del testo, dove 0 corrisponde a nessun limite di lunghezza
Model.MultiLine (Boolean)
Consente alla voce di occupare diverse righe
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è in sola lettura
Model.Tabstop (Boolean)
Consente di raggiungere l'elemento di controllo con il tasto Tab
Model.Text (String)
Testo associato all'elemento di controllo
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.VScroll (Boolean)
Il testo ha una barra di scorrimento verticale
Model.HelpText (String)
Testo della guida in linea che viene visualizzato quando il puntatore del mouse si trova sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Le caselle di riepilogo (servizio com.sun.star.awt.UnoControlListBox) supportano le seguenti proprietà:

ItemCount (Short)
Numero di elementi, sola lettura
SelectedItem (String)
Testo della voce evidenziata, sola lettura
SelectedItems (Array Of Strings)
Campo di dati con voci evidenziate, sola lettura
SelectItemPos (Short)
Numero della voce attualmente evidenziata, sola lettura
SelectItemsPos (Array of Short)
Campo di dati con il numero di voci evidenziate (per gli elenchi che supportano la selezione multipla), sola lettura
MultipleMode (Boolean)
True attiva l'opzione per la selezione di più elementi, False blocca la selezione multipla (la proprietà non può essere richiamata direttamente, ma solo tramiteIsMultipleMode)
IsMultipleMode (Boolean)
Consente la selezione multipla all'interno degli elenchi, sola lettura

Le caselle di riepilogo forniscono 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 nell'elenco nella posizione Pos
removeItems (Pos, Count)
Rimuove le voci Count della posizione Pos
selectItem (Item, SelectMode)
Attiva o disattiva l'evidenziazione dell'elemento specificato nella stringaItem in base alla variabile booleana SelectMode
makeVisible (Pos)
Scorre il campo in modo che risulti visibile la voce specificata con Pos

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

Model.BackgroundColor (long)
Colore di sfondo dell'elemento di controllo
Model.Border (short)
Tipo di bordo (0: nessun bordo, 1: bordo 3D, 2: bordo semplice)
Model.FontDescriptor (struct)
Struttura che specifica i dettagli del carattere da utilizzare (in conformità alla struttura com.sun.star.awt.FontDescriptor)
Model.LineCount (Short)
Numero di righe nell'elemento di controllo
Model.MultiSelection (Boolean)
Consente la selezione multipla delle voci
Model.SelectedItems (Array of Strings)
Elenco delle voci evidenziate
Model.StringItemList (Array of Strings)
Elenco di tutte le voci
Model.Printable (Boolean)
L'elemento di controllo può essere stampato
Model.ReadOnly (Boolean)
Il contenuto dell'elemento di controllo è in sola lettura
Model.Tabstop (Boolean)
Consente di selezionare l'elemento di controllo con il tasto Tab
Model.TextColor (Long)
Colore del testo dell'elemento di controllo
Model.HelpText (String)
Visualizza automaticamente il testo della guida in linea quando il puntatore del mouse è posizionato sull'elemento di controllo
Model.HelpURL (String)
URL della guida in linea per l'elemento di controllo corrispondente

Template:Documentation/Note

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_Elements&oldid=133078"
Personal tools