<!DOCTYPE html>
<html lang="es" dir="ltr">
<head>
<base href="../../../../../">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Servicio SFDocuments.FormControl</title>
<link rel="shortcut icon" href="media/navigation/favicon.ico">
<link type="text/css" href="normalize.css" rel="Stylesheet">
<link type="text/css" href="prism.css" rel="Stylesheet">
<link type="text/css" href="default.css" rel="Stylesheet">
<script type="text/javascript" src="polyfills.js"></script><script type="text/javascript" src="languages.js"></script><script type="text/javascript" src="es/langnames.js"></script><script type="text/javascript" src="flexsearch.debug.js"></script><script type="text/javascript" src="prism.js"></script><script type="text/javascript" src="help2.js" defer></script><script type="text/javascript" src="a11y-toggle.js" defer></script><script type="text/javascript" src="paginathing.js" defer></script><script type="text/javascript" src="es/bookmarks.js" defer></script><script type="text/javascript" src="es/contents.js" defer></script><script type="text/javascript" src="help.js" defer></script><meta name="viewport" content="width=device-width,initial-scale=1">
</head>
<body>
<header id="TopLeftHeader"><a class="symbol" href="es/text/shared/05/new_help.html"><div></div></a><a class="logo" href="es/text/shared/05/new_help.html"><p dir="auto">Ayuda de LibreOffice 25.2</p></a><div class="dropdowns"><div class="modules">
<button type="button" data-a11y-toggle="modules-nav" id="modules" aria-haspopup="true" aria-expanded="false" aria-controls="modules-nav">Módulo</button><nav id="modules-nav" hidden=""></nav>
</div></div></header><aside class="leftside"><input id="accordion-1" name="accordion-menu" type="checkbox"><label for="accordion-1" dir="auto">Contenido</label><div id="Contents" class="contents-treeview"></div></aside><div id="SearchFrame"><div id="Bookmarks">
<input id="search-bar" type="search" class="search" placeholder="Buscar en los marcadores del módulo elegido" dir="auto"><div class="nav-container" tabindex="0"><nav class="index" dir="auto"></nav></div>
</div></div>
<div id="DisplayArea" itemprop="softwareHelp" itemscope="true" itemtype="http://schema.org/SoftwareApplication">
<noscript><div id="WarnJS"><h1 dir="auto">Active JavaScript en el navegador para mostrar las páginas de ayuda de LibreOffice.</h1></div></noscript>
<a id="ScriptForge-sf_formcontrol"></a>
<a id="bm_id41582391760252"></a>
<meta itemprop="keywords" content="FormControl service">
<a id="abstract"></a>
<h1 id="bm_id781582391760253" dir="auto">
<a id="FormControlService"></a><span class="literal">SFDocuments</span>.<span class="literal">FormControl</span> service</h1>
<p id="par_id931583589764919" class="paragraph" dir="auto">The <span class="literal">FormControl</span> service provides access to the controls that belong to a form, a subform or a table control of a <span class="literal">FormDocument</span>. Each instance of the <span class="literal">FormControl</span> service refers to a single control in the form. This service allows users to:</p>
<ul itemprop="Unordered" itemscope="true" itemtype="http://schema.org/ItemList" dir="auto">
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id451618771561326" class="listitem" dir="auto">Get and set the properties of the control represented by the <span class="literal">FormControl</span> instance.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id601618771565183" class="listitem" dir="auto">Access the current value displayed by the control.</p>
</li>
<li itemprop="itemListElement" itemscope="true" itemtype="http://schema.org/ItemListUnordered" dir="auto">
<p id="par_id981618771567951" class="listitem" dir="auto">Set the focus on the desired control.</p>
</li>
</ul>
<p id="par_id301616939922857" class="paragraph" dir="auto">To use the <span class="literal">FormControl</span> service in a particular form, subform or table control, all controls must have unique names.</p>
<div class="warning">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/warning.svg" alt="warning" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id541618771629112" dir="auto">Radio buttons that share the same group name must also have unique control names.</p></div>
</div>
<br>
<p id="par_id51618771641273" class="paragraph" dir="auto">The main purpose of the <span class="literal">FormControl</span> service is setting and getting the properties and values displayed by the controls in a form.</p>
<p id="par_id81618774023346" class="paragraph" dir="auto">All controls have a <span class="literal">Value</span> property. However, its contents will vary according to the control type. For more information, read <a target="_top" href="es/text/sbasic/shared/03/sf_formcontrol.html#hd_id81598540704978">The <span class="literal">Value</span> Property</a> below.</p>
<p id="par_id881618771651907" class="paragraph" dir="auto">It is also possible to format the controls via the <span class="literal">XControlModel</span> and <span class="literal">XControlView</span> properties.</p>
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="tip" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id891598188164936" dir="auto">The <span class="literal">SFDocuments.FormControl</span> service is closely related to the <a target="_top" href="es/text/sbasic/shared/03/sf_form.html"><span class="literal">SFDocuments.Form</span></a> service.</p></div>
</div>
<br>
<a id="bm_id331612167249331"></a>
<meta itemprop="keywords" content="API,awt.XControl">
<meta itemprop="keywords" content="API,awt.XControlModel">
<h2 id="hd_id581582885621841" dir="auto">Invocación del servicio</h2>
<p id="par_id141609955500101" class="paragraph" dir="auto">Antes de utilizar el servicio <span class="literal">FormControl</span>, es necesario cargar o importar la biblioteca <span class="literal">ScriptForge</span>:</p>
<div class="embedded">
<a id="importLibs"></a>
<div class="note">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/note.svg" alt="note" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id901528999850603" dir="auto">• Para cargar la biblioteca <span class="literal">ScriptForge</span> que necesitan las macros de Basic se debe usar la siguiente declaración:<br><span class="literal">GlobalScope.BasicLibraries.loadLibrary("ScriptForge")</span><br><br>• Los scripts de Python necesitan importar el módulo <span class="literal">scriptforge</span>:<br><span class="literal">from scriptforge import CreateScriptService</span></p></div>
</div>
<br>
</div>
<p id="par_id361598174756160" class="paragraph" dir="auto">The <span class="literal">FormControl</span> service is invoked from an existing <span class="literal">Form</span> service instance through its <span class="literal">Controls</span> method.</p>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Dim oDoc as Object, myForm As Object, myControl As Object
Set oDoc = CreateScriptService("SFDocuments.Document", ThisDataBaseDocument)
Set myForm = oDoc.Forms("formDocumentName", "formName") ' SFDocuments.Form
Set myControl = myForm.Controls("myTextBox") ' SFDocuments.FormControl
myControl.Value = "Current time = " & Now()
</code></pre></div>
<div class="embedded">
<a id="In_Python"></a>
<h5 id="hd_id831620312769993" dir="auto">En Python</h5>
</div>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
<p id="par_id51622556288409" class="paragraph" dir="auto">from scriptforge import CreateScriptService</p>
from time import localtime, strftime
bas = CreateScriptService('ScriptForge.Basic')
<p id="par_id851622556289184" class="paragraph" dir="auto">doc = CreateScriptService('SFDocuments.Document', bas.ThisDatabaseDocument)</p>
<p id="par_id981622556289672" class="paragraph" dir="auto">form = doc.Forms('formDocumentName', 'formName') # SFDocuments.Form</p>
<p id="par_id291622556290144" class="paragraph" dir="auto">control = form.Controls('myTextBox') # SFDocuments.FormControl</p>
control.Value = 'Current Time = ' + strftime("%a, %d %b %Y %H:%M:%S", localtime())
</code></pre></div>
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="tip" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id781618772761258" dir="auto">To learn more about how to open a <span class="literal">FormDocument</span> and get access to its forms, refer to the <a target="_top" href="es/text/sbasic/shared/03/sf_form.html">SFDocuments.Form</a> service help page.</p></div>
</div>
<br>
<p id="par_id951598174966322" class="paragraph" dir="auto">Alternatively a <span class="literal">FormControl</span> instance can be retrieved via the <span class="literal">SFDocuments.FormEvent</span> service, which returns the <span class="literal">SFDocuments.FormControl</span> class instance that triggered the event.</p>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Sub OnEvent(ByRef poEvent As Object)
Dim oControl As Object
Set oControl = CreateScriptService("SFDocuments.FormEvent", poEvent)
' oControl now represents the instance of the FormControl class that triggered the current event
' ...
End Sub
</code></pre></div>
<div class="embedded">
<a id="In_Python"></a>
<h5 id="hd_id831620312769993" dir="auto">En Python</h5>
</div>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
def onEvent(event: uno):
control = CreateScriptService('SfDocuments.FormEvent', event)
</code></pre></div>
<p id="par_id251598176312571" class="paragraph" dir="auto">Note that in previous examples, the prefix <span class="literal">"SFDocuments."</span> may be omitted.</p>
<a id="bm_id541618773673421"></a>
<meta itemprop="keywords" content="FormEvent service">
<a id="FormEvent_Note"></a>
<div class="note">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/note.svg" alt="note" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id951618773412097" dir="auto">The <span class="literal">FormEvent</span> service is used exclusively to create instances of the <span class="literal">SFDocuments.Form</span> and <span class="literal">SFDocuments.FormControl</span> services when a form or control event takes place.</p></div>
</div>
<br>
<h2 id="hd_id71598455687512" dir="auto">Tipos de controles</h2>
<p id="par_id851598455863395" class="paragraph" dir="auto">El servicio <span class="literal">FormControl</span> está disponible para los tipos de control siguientes:</p>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id531709730484386" class="tablecontentintable" dir="auto">Button<br>CheckBox<br>ComboBox<br>CurrencyField<br>DateField<br>FileControl<br>FixedText<br>FormattedField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id591709730484386" class="tablecontentintable" dir="auto">GroupBox<br>HiddenControl<br>ImageButton<br>ImageControl<br>ListBox<br>NavigationBar<br>NumericField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id361709730484386" class="tablecontentintable" dir="auto">PatternField<br>RadioButton<br>ScrollBar<br>SpinButton<br>TableControl<br>TextField<br>TimeField</p>
</td>
</tr>
</table>
<br>
<h2 id="hd_id651583668365757" dir="auto">Propiedades</h2>
<a id="properties_toc"></a>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id871583668386455" class="tableheadintable" dir="auto">Nombre</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id491583668386455" class="tableheadintable" dir="auto">De solo lectura</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id271583668474014" class="tableheadintable" dir="auto">Tipo</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id291598538799794" class="tableheadintable" dir="auto">Se aplica a</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id401583668386455" class="tableheadintable" dir="auto">Descripción</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id151583668386455" class="tablecontentintable" dir="auto">Action</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id371583668519172" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id271583668386455" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id231598538847029" class="tablecontentintable" dir="auto">Button</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id771583668386455" class="tablecontentintable" dir="auto">Specifies the action triggered when the button is clicked. Accepted values are: <span class="literal">none</span>, <span class="literal">submitForm</span>, <span class="literal">resetForm</span>, <span class="literal">refreshForm</span>, <span class="literal">moveToFirst</span>, <span class="literal">moveToLast</span>, <span class="literal">moveToNext</span>, <span class="literal">moveToPrev</span>, <span class="literal">saveRecord</span>, <span class="literal">moveToNew</span>, <span class="literal">deleteRecord</span>, <span class="literal">undoRecord</span>.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id951583839708571" class="tablecontentintable" dir="auto">Caption</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id541583839708548" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id751583839708362" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id351598538934413" class="tablecontentintable" dir="auto">Button, CheckBox, FixedText, GroupBox, RadioButton</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id731583839708412" class="tablecontentintable" dir="auto">Especifica el texto que muestra el control.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id901616942306877" class="tablecontentintable" dir="auto">ControlSource</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id411616942306677" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id791616942306698" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id861616942306914" class="tablecontentintable" dir="auto">CheckBox, ComboBox, CurrencyField, DateField, FormattedField, ImageControl, ListBox, NumericField, PatternField, RadioButton, TextField, TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id461616942306745" class="tablecontentintable" dir="auto">Specifies the rowset field mapped onto the current control.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id511584027709311" class="tablecontentintable" dir="auto">ControlType</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id761584027709516" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id491584027709825" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id261598539120502" class="tablecontentintable" dir="auto">Todo</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971584027709752" class="tablecontentintable" dir="auto">Uno de los tipos de control mencionados anteriormente.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id491583839767611" class="tablecontentintable" dir="auto">Default</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id31583839767743" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id741583839767926" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id71598539168348" class="tablecontentintable" dir="auto">Button</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id111583839767195" class="tablecontentintable" dir="auto">Especifica si un botón de orden es el botón Aceptar predeterminado.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id321616942739272" class="tablecontentintable" dir="auto">DefaultValue</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id241616942739459" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id771616942739341" class="tablecontentintable" dir="auto">Variant</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id861616942739836" class="tablecontentintable" dir="auto">CheckBox, ComboBox, CurrencyField, DateField, FileControl, FormattedField, ListBox, NumericField, PatternField, RadioButton, SpinButton, TextField, TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id271616942739359" class="tablecontentintable" dir="auto">Specifies the default value used to initialize a control in a new record.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id83158383992056" class="tablecontentintable" dir="auto">Enabled</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id771583839920487" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971583839920282" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id891598539196786" class="tablecontentintable" dir="auto">Todo (salvo HiddenControl)</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451583839920858" class="tablecontentintable" dir="auto">Especifica si el control es accesible mediante el cursor.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id751588333908795" class="tablecontentintable" dir="auto">Format</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id571588333908716" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id781588333908500" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id491598539231618" class="tablecontentintable" dir="auto">DateField, TimeField, FormattedField (read-only)</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id721588333908708" class="tablecontentintable" dir="auto">Especifica el formato utilizado para mostrar las fechas y horas. Debe ser una de las siguientes cadenas:</p>
<p id="par_id891598456980194" class="paragraphintable" dir="auto">For dates: "Standard (short)", "Standard (short YY)", "Standard (short YYYY)", "Standard (long)", "DD/MM/YY", "MM/DD/YY", "YY/MM/DD", "DD/MM/YYYY", "MM/DD/YYYY" , "YYYY/MM/DD", "YY-MM-DD", "YYYY-MM-DD".</p>
<p id="par_id221598456991070" class="paragraphintable" dir="auto">For times: "24h short", "24h long", "12h short", "12h long".</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id251583774433989" class="tablecontentintable" dir="auto">ListCount</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id501583774433513" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id411583774433779" class="tablecontentintable" dir="auto">Long</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id531598539561342" class="tablecontentintable" dir="auto">ComboBox, ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id151598177605296" class="paragraphintable" dir="auto">Returns the number of rows in a ListBox or a ComboBox.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id731588334016220" class="tablecontentintable" dir="auto">ListIndex</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id271588334016191" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id991588334016273" class="tablecontentintable" dir="auto">Long</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451598539598242" class="tablecontentintable" dir="auto">ComboBox, ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id251588334016874" class="tablecontentintable" dir="auto">Specifies which item is selected in a ListBox or ComboBox. In case of multiple selection, the index of the first item is returned or only one item is set.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id81616944120456" class="tablecontentintable" dir="auto">ListSource</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id891616944120697" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id831616944120587" class="tablecontentintable" dir="auto">Variant</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id301616944120610" class="tablecontentintable" dir="auto">ComboBox, ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id901616944120614" class="tablecontentintable" dir="auto">Specifies the data contained in a ComboBox or a ListBox as a zero-based array of string values.</p>
<p id="par_id21616944586559" class="paragraphintable" dir="auto">Combined with <span class="literal">ListSourceType</span>, may also contain the name of a table, a query or a complete <span class="literal">SQL</span> statement.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id331616944631911" class="tablecontentintable" dir="auto">ListSourceType</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id821616944631740" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id781616944631772" class="tablecontentintable" dir="auto">Integer</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id671616944631522" class="tablecontentintable" dir="auto">ComboBox, ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id131616944631625" class="tablecontentintable" dir="auto">Especifica el tipo de datos contenidos en un cuadro combinado o un cuadro de lista.</p>
<p id="par_id881616944631341" class="paragraphintable" dir="auto">Debe ser una de las constantes <a target="_blank" href="https://api.libreoffice.org/docs/idl/ref/ListSourceType_8idl_source.html"><span class="literal">com.sun.star.form.ListSourceType.*</span></a>.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451598457655392" class="tablecontentintable" dir="auto">Locked</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id961598457655506" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id571598457655365" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id111598539631340" class="tablecontentintable" dir="auto">ComboBox, CurrencyField, DateField, FileControl, FormattedField, ImageControl, ListBox, NumericField, PatternField, TextField, TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id2159845765568" class="tablecontentintable" dir="auto">Especifica si el control es de solo lectura.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id21159845795140" class="tablecontentintable" dir="auto">MultiSelect</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id621598457951781" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id311598457951281" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id361598539747680" class="tablecontentintable" dir="auto">ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id821598457951782" class="tablecontentintable" dir="auto">Specifies whether the user can select multiple items in a listbox.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id421598458170141" class="tablecontentintable" dir="auto">Name</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id351598458170114" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id391598458170757" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id151598539764402" class="tablecontentintable" dir="auto">Todo</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id621598458170392" class="tablecontentintable" dir="auto">El nombre del control.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id2915984585802" class="tablecontentintable" dir="auto">Parent</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id161598458580581" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id921598458580608" class="tablecontentintable" dir="auto">Object</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id181598539807426" class="tablecontentintable" dir="auto">Todo</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id801598458580456" class="tablecontentintable" dir="auto">Depending on the parent type, a form, a subform or a tablecontrol, returns the parent <span class="literal">SFDocuments</span>.<span class="literal">Form</span> or <span class="literal">SFDocuments</span>.<span class="literal">FormControl</span> class object instance.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id181598458773220" class="tablecontentintable" dir="auto">Picture</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971598458773352" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id471598458773993" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id831598539848472" class="tablecontentintable" dir="auto">Button, ImageButton, ImageControl</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451598458773588" class="tablecontentintable" dir="auto">Specifies the file name containing a bitmap or other type of graphic to be displayed on the control. The filename must comply with the <span class="literal">FileNaming</span> attribute of the <span class="literal">ScriptForge.FileSystem</span> service.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id341616946015404" class="tablecontentintable" dir="auto">Required</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id251616946015886" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id461616946015486" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id131616946015428" class="tablecontentintable" dir="auto">CheckBox, ComboBox, CurrencyField, DateField, ListBox, NumericField, PatternField, RadioButton, SpinButton, TextField, TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id91616946015258" class="tablecontentintable" dir="auto">A control is said required when the underlying data must not contain a <span class="literal">null</span> value.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id491598516764653" class="tablecontentintable" dir="auto">Text</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id781598516764550" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id741598516764696" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id761598539912452" class="tablecontentintable" dir="auto">ComboBox, DateField, FileControl, FormattedField, PatternField, TextField, TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id11159851676440" class="tablecontentintable" dir="auto">Da acceso al texto que muestra el control.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id311598517275908" class="tablecontentintable" dir="auto">TipText</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id411598517275112" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971598517275920" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id171598539985022" class="tablecontentintable" dir="auto">Todo (salvo HiddenControl)</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651598517275384" class="tablecontentintable" dir="auto">Permite especificar el texto que aparece como descripción emergente cuando se posa el puntero del ratón encima del control.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id951598517418614" class="tablecontentintable" dir="auto">TripleState</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id821598517418463" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id231598517418608" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id81598540007035" class="tablecontentintable" dir="auto">CheckBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id141598517418822" class="tablecontentintable" dir="auto">Especifica si el control de casilla aparecerá atenuado (en gris) o no.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id31598517671415" class="tablecontentintable" dir="auto">Value</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id701598517671373" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id2159851767113" class="tablecontentintable" dir="auto">Variant</p>
</td>
<td rowspan="" colspan="" dir="auto"></td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id1001598540024225" class="tablecontentintable" dir="auto">This property depends on the current control type. Refer to <a target="_top" href="es/text/sbasic/shared/03/sf_formcontrol.html#hd_id81598540704978">The <span class="literal">Value</span> property</a> for more information.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id571598517730264" class="tablecontentintable" dir="auto">Visible</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id661598517730941" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id981598517730694" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id761598540042290" class="tablecontentintable" dir="auto">Todo (salvo HiddenControl)</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id881598517730836" class="tablecontentintable" dir="auto">Especifica si el control está oculto o es visible.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id741598177924441" class="tablecontentintable" dir="auto">XControlModel</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451598177924437" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id94159817792441" class="tablecontentintable" dir="auto">Objeto<br>de UNO</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id311598540066789" class="tablecontentintable" dir="auto">Todo</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id191598177924897" class="tablecontentintable" dir="auto">The UNO object representing the control model. Refer to <a target="_blank" href="https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XControlModel.html">XControlModel</a> and <a target="_blank" href="https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1UnoControlModel.html">UnoControlModel</a> in the API documentation for more information.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id801598178083859" class="tablecontentintable" dir="auto">XControlView</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id811598178083501" class="tablecontentintable" dir="auto">Sí</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id981598178083938" class="tablecontentintable" dir="auto">Objeto<br>de UNO</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id551598540079329" class="tablecontentintable" dir="auto">Todo</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id731598178083442" class="tablecontentintable" dir="auto">The UNO object representing the control view. Refer to <a target="_blank" href="https://api.libreoffice.org/docs/idl/ref/interfacecom_1_1sun_1_1star_1_1awt_1_1XControl.html">XControl</a> and <a target="_blank" href="https://api.libreoffice.org/docs/idl/ref/servicecom_1_1sun_1_1star_1_1awt_1_1UnoControl.html">UnoControl</a> in the API documentation for more information.</p>
</td>
</tr>
</table>
<br>
<h2 id="hd_id81598540704978" dir="auto">La propiedad <a id="ValueProperty"></a><span class="literal">Value</span>
</h2>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id10159854325492" class="tableheadintable" dir="auto">Tipo de control</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id741598543254158" class="tableheadintable" dir="auto">Tipo</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id961598543254444" class="tableheadintable" dir="auto">Descripción</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id461598543254494" class="tablecontentintable" dir="auto">Button</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id271598543254590" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id741598543254108" class="tablecontentintable" dir="auto">Applicable to toggle buttons only.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id131598543254931" class="tablecontentintable" dir="auto">CheckBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id741598543254376" class="tablecontentintable" dir="auto">Booleano o entero</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id521598543254630" class="tablecontentintable" dir="auto">0, False: not checked<br>1, True: checked<br>2: grayed out, don't know (applicable if <span class="literal">TripleState</span> is <span class="literal">True</span>)</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id891598543254563" class="tablecontentintable" dir="auto">ComboBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id781598543254887" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id331598543254947" class="tablecontentintable" dir="auto">The selected value, as a String. The <span class="literal">ListIndex</span> property is an alternate option to access the index of the selected value.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id58159854325446" class="tablecontentintable" dir="auto">CurrencyField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id5159854325443" class="tablecontentintable" dir="auto">Numérico</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id90159854325450" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id241598543254415" class="tablecontentintable" dir="auto">DateField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id401598543254743" class="tablecontentintable" dir="auto">Date</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id421598543254587" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id851598543254508" class="tablecontentintable" dir="auto">FileControl</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id731598543254544" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971598543254757" class="tablecontentintable" dir="auto">A file name formatted in accordance with the <span class="literal">FileNaming</span> property of the <span class="literal">ScriptForge.FileSystem</span> service</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id921598543254323" class="tablecontentintable" dir="auto">FormattedField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id221598543254760" class="tablecontentintable" dir="auto">Cadena o Numérico</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id651598543254212" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id581616946805539" class="tablecontentintable" dir="auto">HiddenControl</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id37161694680551" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id491616946805219" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id151598543254318" class="tablecontentintable" dir="auto">ListBox</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id42159854325422" class="tablecontentintable" dir="auto">Cadena o matriz de cadenas</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id601598543254780" class="tablecontentintable" dir="auto">The selected row(s) as a single string or an array of strings. Only a single value can be set. If the box is linked to a database, this property gets or sets the underlying data. Otherwise it gets or sets the data being displayed.</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id771598543254973" class="tablecontentintable" dir="auto">NumericField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id461598543254909" class="tablecontentintable" dir="auto">Numérico</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id161598543254662" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id38159854325480" class="tablecontentintable" dir="auto">PatternField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id81598543254625" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id911598543254335" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id791598543254779" class="tablecontentintable" dir="auto">RadioButton</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id561598543254115" class="tablecontentintable" dir="auto">Boolean</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id851598543254624" class="tablecontentintable" dir="auto">Each button has its own name. Multiple RadioButton controls are linked together when they share the same group name. If a RadioButton is set to <span class="literal">True</span>, the other related buttons are automatically set to <span class="literal">False</span></p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id141598543254361" class="tablecontentintable" dir="auto">ScrollBar</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id531598543254869" class="tablecontentintable" dir="auto">Numérico</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id21598543254994" class="tablecontentintable" dir="auto">Must be within the predefined bounds</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id91616947400762" class="tablecontentintable" dir="auto">SpinButton</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id951616947400919" class="tablecontentintable" dir="auto">Numérico</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id48161694740085" class="tablecontentintable" dir="auto">Must be within the predefined bounds</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id811598543254140" class="tablecontentintable" dir="auto">TextField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id751598543254299" class="tablecontentintable" dir="auto">String</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id441598543254738" class="tablecontentintable" dir="auto">El texto que aparece en el campo</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id89159854325478" class="tablecontentintable" dir="auto">TimeField</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id341598543254600" class="tablecontentintable" dir="auto">Date</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id881598543254964" class="tablecontentintable" dir="auto"></p>
</td>
</tr>
</table>
<br>
<h2 id="hd_id421612628828054" dir="auto">Propiedades del evento</h2>
<p id="par_id41612629140856" class="paragraph" dir="auto">The properties below return or set URI strings that define the script triggered by the event.</p>
<a id="event_properties_toc"></a>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id961612628879819" class="tableheadintable" dir="auto">Nombre</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id401612628879819" class="tableheadintable" dir="auto">De solo lectura</p>
</th>
<th rowspan="" colspan="" class="tableheadcell" dir="auto">
<p id="par_id281612628879819" class="tableheadintable" dir="auto">Descripción tal como figura en el EDI de BASIC</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id801612707166342" class="tablecontentintable" dir="auto">OnActionPerformed</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id91612707166532" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id291612707166258" class="tablecontentintable" dir="auto">Ejecutar acción</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id261612707166662" class="tablecontentintable" dir="auto">OnAdjustmentValueChanged</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id79161270716675" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id831612707166731" class="tablecontentintable" dir="auto">Al ajustar</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id431616948330476" class="tablecontentintable" dir="auto">OnApproveAction</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id301616948330694" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id901616948330305" class="tablecontentintable" dir="auto">Aprobar acción</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id391616948330165" class="tablecontentintable" dir="auto">OnApproveReset</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id821616948330888" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id111616948330257" class="tablecontentintable" dir="auto">Antes de restablecer</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id211616948330775" class="tablecontentintable" dir="auto">OnApproveUpdate</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id271616948330553" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id451616948330759" class="tablecontentintable" dir="auto">Antes de actualizar</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id471616948330872" class="tablecontentintable" dir="auto">OnChanged</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id71616948330769" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id211616948330895" class="tablecontentintable" dir="auto">Modificado</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id171616948330656" class="tablecontentintable" dir="auto">OnErrorOccurred</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id121616948330654" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id2216169483303" class="tablecontentintable" dir="auto">Ha ocurrido un error</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id431612629836735" class="tablecontentintable" dir="auto">OnFocusGained</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id111612629836630" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id1001612629836902" class="tablecontentintable" dir="auto">Al recibir el foco</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id701612629836389" class="tablecontentintable" dir="auto">OnFocusLost</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id291612629836294" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id62161262983683" class="tablecontentintable" dir="auto">Al perder el foco</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id10161270735471" class="tablecontentintable" dir="auto">OnItemStateChanged</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id51612707354544" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id211612707354899" class="tablecontentintable" dir="auto">Estado modificado</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id241612629836863" class="tablecontentintable" dir="auto">OnKeyPressed</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id81612629836634" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id881612629836744" class="tablecontentintable" dir="auto">Tecla pulsada</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id201612629836996" class="tablecontentintable" dir="auto">OnKeyReleased</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id591612629836830" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id161612629836775" class="tablecontentintable" dir="auto">Tecla liberada</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id111612629836950" class="tablecontentintable" dir="auto">OnMouseDragged</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id891612629836630" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id461612629836679" class="tablecontentintable" dir="auto">Mouse moved while key presses</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id711612629836495" class="tablecYesontentintable" dir="auto">OnMouseEntered</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id131612629836291" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id151612629836151" class="tablecontentintable" dir="auto">Ratón dentro</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id971612629836286" class="tablecontentintable" dir="auto">OnMouseExited</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id211612629836725" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id361612629836624" class="tablecontentintable" dir="auto">Ratón fuera</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id721612629836537" class="tablecontentintable" dir="auto">OnMouseMoved</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id311612629836481" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id721612629836752" class="tablecontentintable" dir="auto">Ratón movido</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id55161262983695" class="tablecontentintable" dir="auto">OnMousePressed</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id981612629836116" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id381612629836635" class="tablecontentintable" dir="auto">Botón del ratón pulsado</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id621612629836155" class="tablecontentintable" dir="auto">OnMouseReleased</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id711612629836704" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id35161262983642" class="tablecontentintable" dir="auto">Botón del ratón soltado</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id241616948666992" class="tablecontentintable" dir="auto">OnResetted</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id31616948666215" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id951616948666674" class="tablecontentintable" dir="auto">Después de restablecer</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id84161270760678" class="tablecontentintable" dir="auto">OnTextChanged</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id811612707606330" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id621612707606219" class="tablecontentintable" dir="auto">Texto modificado</p>
</td>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id571616948721115" class="tablecontentintable" dir="auto">OnUpdated</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id41616948721642" class="tablecontentintable" dir="auto">No</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id311616948721872" class="tablecontentintable" dir="auto">Después de actualizar</p>
</td>
</tr>
</table>
<br>
<div class="tip">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/tip.svg" alt="tip" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id961618181634181" dir="auto">Para conocer más sobre las cadenas de URI, consulte la <a target="_blank" href="https://wiki.documentfoundation.org/Documentation/DevGuide/Scripting_Framework#Scripting_Framework_URI_Specification">especificación de URI del marco de programación de secuencias de órdenes</a> (en inglés).</p></div>
</div>
<br>
<a id="methods_toc"></a>
<table border="1" class="" cellpadding="0" cellspacing="0">
<tr>
<th rowspan="" colspan="2" class="tableheadcell" dir="auto">
<p id="par_id891611613601554" class="tableheadintable" dir="auto">Lista de métodos en el servicio FormControl</p>
</th>
</tr>
<tr>
<td rowspan="" colspan="" dir="auto">
<p id="par_id751612709117248" class="tablecontentintable" dir="auto">
<a target="_top" href="es/text/sbasic/shared/03/sf_formcontrol.html#Controls">Controls</a><br>
</p>
</td>
<td rowspan="" colspan="" dir="auto">
<p id="par_id63161270911712" class="tablecontentintable" dir="auto">
<a target="_top" href="es/text/sbasic/shared/03/sf_formcontrol.html#SetFocus">SetFocus</a><br>
</p>
</td>
</tr>
</table>
<br>
<a id="Controls"></a>
<a id="bm_id41584541257826"></a>
<meta itemprop="keywords" content="FormControl service,Controls">
<h2 id="hd_id95158454125767" dir="auto">Controls</h2>
<p id="par_id161584541257982" class="paragraph" dir="auto">This method is applicable only to controls of the <span class="literal">TableControl</span> type. The returned value depends on the arguments provided.</p>
<p id="par_id701618777636827" class="paragraph" dir="auto">If the optional argument <span class="literal">controlname</span> is absent, then a zero-based Array containing the names of all controls is returned.</p>
<p id="par_id851618777715892" class="paragraph" dir="auto">On the other hand, if a <span class="literal">controlname</span> is provided, the method returns a <span class="literal">FormControl</span> class instance corresponding to the specified control.</p>
<div class="embedded">
<a id="functsyntax"></a>
<h3 id="hd_id061420171139089682" dir="auto">Sintaxis:</h3>
</div>
<p id="par_id181622558671497" class="paragraph" dir="auto"><span class="input" data-tooltip="Pulse en el texto para copiarlo en el portapapeles">svc.Controls(): str[0..*]</span></p>
<p id="par_id531622558833434" class="paragraph" dir="auto"><span class="input" data-tooltip="Pulse en el texto para copiarlo en el portapapeles">svc.Controls(controlname: str): svc</span></p>
<div class="embedded">
<a id="functparameters"></a>
<h3 id="hd_id061420171139084157" dir="auto">Parámetros:</h3>
</div>
<p id="par_id1001584541257789" class="paragraph" dir="auto"><span class="emph">controlname</span>: A valid control name as a case-sensitive string. If absent, the list of control names is returned as a zero-based array.</p>
<div class="embedded">
<a id="functexample"></a>
<h3 id="hd_id061420171139088233" dir="auto">Ejemplo:</h3>
</div>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Dim myGrid As Object, myList As Variant, myControl As Object
Set myGrid = myForm.Controls("myTableControl") ' SFDocuments.FormControl
' Returns an Array with the names of all controls in "myTableControl"
myList = myGrid.Controls()
<p id="par_id931618778110273" class="paragraph" dir="auto">' Returns a FormControl class instance corresponding to "myCheckBox"</p>
Set myControl = myGrid.Controls("myCheckBox")
</code></pre></div>
<p id="par_id391622559441530" class="paragraph" dir="auto">Con Python:</p>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
grid = form.Controls('myTableControl') # SFDocuments.FormControl
control_names = form.Controls()
control = grid.Controls('myCheckBox') # SFDocuments.FormControl
</code></pre></div>
<a id="SetFocus"></a>
<a id="bm_id721583933076548"></a>
<meta itemprop="keywords" content="FormControl service,SetFocus">
<h2 id="hd_id681583933076692" dir="auto">SetFocus</h2>
<p id="par_id871583933076448" class="paragraph" dir="auto">Sets the focus on the control. Returns <span class="literal">True</span> if focusing was successful.</p>
<p id="par_id151598178880227" class="paragraph" dir="auto">This method is often called from a form or control event.</p>
<div class="embedded">
<a id="functsyntax"></a>
<h3 id="hd_id061420171139089682" dir="auto">Sintaxis:</h3>
</div>
<p id="par_id991622559468457" class="paragraph" dir="auto"><span class="input" data-tooltip="Pulse en el texto para copiarlo en el portapapeles">svc.SetFocus(): bool</span></p>
<div class="embedded">
<a id="functexample"></a>
<h3 id="hd_id061420171139088233" dir="auto">Ejemplo:</h3>
</div>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Dim oDoc As Object, oForm As Object, oControl As Object
Set oDoc = CreateScriptService("SFDocuments.Document", ThisComponent)
Set oForm = oDoc.Forms(0)
Set oControl = oForm.Controls("thisControl") ' SFDocuments.FormControl
oControl.SetFocus()
</code></pre></div>
<div class="embedded">
<a id="In_Python"></a>
<h5 id="hd_id831620312769993" dir="auto">En Python</h5>
</div>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
bas = CreateScriptService('ScriptForge.Basic')
doc = CreateScriptService('SFDocuments.Document', bas.ThisComponent)
form = doc.Forms(0)
control = form.Controls('thisControl') # SFDocuments.FormControl
control.SetFocus()
</code></pre></div>
<h2 id="hd_id141618777179310" dir="auto">Más ejemplos</h2>
<p id="par_id331618777195723" class="paragraph" dir="auto">Encontrará más abajo dos ejemplos que ilustran el uso del servicio <span class="literal">FormControl</span>.</p>
<p id="par_id371618776324489" class="paragraph" dir="auto">The first example reads the current value in a ComboBox containing city names and writes it to a FixedTest control in a Form:</p>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Dim oDoc as Object, myForm as Object, myControl as Object
Set oDoc = CreateScriptService("SFDocuments.Document", ThisDataBaseDocument)
myForm = oDoc.Forms("formDocumentName", "formName")
Dim lbCity : lbCity = myForm.Controls("labelCity")
Dim cbCity : cbCity = myForm.Controls("comboboxCity")
lbCity.Caption = "Selected City: " & cbCity.Value
</code></pre></div>
<div class="embedded">
<a id="In_Python"></a>
<h5 id="hd_id831620312769993" dir="auto">En Python</h5>
</div>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
bas = CreateScriptService('ScriptForge.Basic') # Métodos semejantes a BASIC
doc = CreateScriptService('SFDocuments.Document', bas.ThisDatabaseDocument)
form = doc.Forms('formDocumentName', 'formName')
lbl_city = form.Controls('labelCity')
combo_city = form.Controls('comboboxCity')
lbl_city.Caption = "Ciudad seleccionada: " + combo_city.Value
</code></pre></div>
<p id="par_id251618776614814" class="paragraph" dir="auto">The following code snippet can be used to process RadioButton controls that share the same group name. In this example, suppose there are three radio buttons with names <span class="literal">optA</span>, <span class="literal">optB</span> and <span class="literal">optC</span> and we wish to display the caption of the selected control.</p>
<div class="bascode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-visual-basic line-numbers">
Dim oDoc as Object, myForm as Object
Set oDoc = CreateScriptService("SFDocuments.Document", ThisDataBaseDocument)
myForm = oDoc.Forms("formDocumentName", "formName")
Dim optNames As Object : optNames = Array("optA", "optB", "optC")
Dim optControl as Object, opt as Variant
For Each opt In optNames
optControl = myForm.Controls(opt)
If optControl.Value = True Then
MsgBox "Opción seleccionada: " & optControl.Caption
Exit For
End If
Next opt
</code></pre></div>
<div class="embedded">
<a id="In_Python"></a>
<h5 id="hd_id831620312769993" dir="auto">En Python</h5>
</div>
<div class="pycode" itemscope="true" itemtype="http://schema.org/SoftwareSourceCode" itemprop="codeSampleType" content="snippet" data-tooltip="Pulse en el texto para copiarlo en el portapapeles"><pre dir="auto"><code class="language-python line-numbers">
bas = CreateScriptService('ScriptForge.Basic') # Métodos semejantes a BASIC
doc = CreateScriptService('SFDocuments.Document', bas.ThisDatabaseDocument)
form = doc.Forms('formDocumentName', 'formName')
radio_buttons = ['optA', 'optB', 'optC']
for name in radio_buttons:
control = form.controls(name)
if control.Value == True:
bas.MsgBox('Opción seleccionada: ' + control.Caption)
break
</code></pre></div>
<div class="embedded">
<a id="SF_InternalUse"></a>
<div class="warning">
<div class="noteicon" dir="auto"><img src="media/icon-themes/res/helpimg/warning.svg" alt="warning" style="width:40px;height:40px;"></div>
<div class="notetext"><p id="par_id851506659675843" dir="auto">Todas las rutinas o identificadores BASIC de <span class="literal">ScriptForge</span> precedidas por guion bajo «_» están reservadas para uso interno. No deben utilizarse en macros BASIC o secuencias Python.</p></div>
</div>
<br>
</div>
<a id="relatedtopics"></a><div class="relatedtopics">
<p class="related" itemprop="mentions" dir="auto"><a id="related"></a><span class="emph">Temas relacionados</span></p>
<div class="relatedbody" itemprop="mentions">
<div class="embedded"><p class="embedded" dir="auto"><a target="_top" href="es/text/sbasic/shared/03/sf_basic.html">Servicio <span class="literal">ScriptForge</span>.<span class="literal">Basic</span></a></p></div>
<div class="embedded"><p class="embedded" dir="auto"><a target="_top" href="es/text/sbasic/shared/03/sf_form.html"><span class="literal">SFDocuments</span>.<span class="literal">Form</span> service</a></p></div>
<div class="embedded"><p class="embedded" dir="auto"><a target="_top" href="es/text/sbasic/shared/03/sf_document.html">Servicio <span class="literal">SFDocuments</span>.<span class="literal">Document</span></a></p></div>
</div>
</div>
</div>
<div id="DonationFrame"></div>
<footer><h2 style="text-align: center;"><a href="https://books.libreoffice.org" target="_blank">Libros de LibreOffice</a></h2>
<div class="noteicon" dir="auto" style="display:flex;justify-content:center;flex-wrap:wrap;row-gap:15px;">
<img src="media/navigation/libo-writer.svg" alt="Writer Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-calc.svg" alt="Calc Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-impress.svg" alt="Impress Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-draw.svg" alt="Draw Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-base.svg" alt="Base Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-math.svg" alt="Math Icon" style="width:60px;height:60px;"><img src="media/navigation/libo-symbol-black.svg" alt="Getting Started Icon" style="width:60px;height:60px;">
</div>
<div id="DEBUG" class="debug">
<h3 class="bug">Help content debug info:</h3>
<p dir="auto">This page is: <a href="https://opengrok.libreoffice.org/xref/help/source/text/sbasic/shared/03/sf_formcontrol.xhp" target="_blank">/text/sbasic/shared/03/sf_formcontrol.xhp</a></p>
<p dir="auto">Title is: Servicio SFDocuments.FormControl</p>
<p id="bm_module" dir="auto"></p>
<p id="bm_system" dir="auto"></p>
<p id="bm_HID" dir="auto"></p>
</div></footer>
</body>
</html>