Este documento presenta el objeto Controls en Microsoft Small Basic, el cual permite agregar controles como cuadros de texto y botones a la ventana gráfica. Explica cómo usar varias operaciones y propiedades del objeto Controls, como AddTextBox, AddButton, GetTextBoxText, entre otras. También cubre los eventos ButtonClicked y TextTyped que se pueden usar con los controles. Finalmente, propone un ejercicio práctico para crear un pequeño formulario usando este objeto.

1. Microsoft® Small Basic
El Objeto Controls
Tiempo estimado para completar esta lección: 1 hora

2. El objeto Controls
En esta lección, aprenderás cómo:
Utilizar las distintas propiedades del objeto Controls.
Utilizar varias operaciones del objeto Controls.
Utiliza los eventos control en los botones y
cuadros de texto en tu programa.

3. Introducción al objeto Controls
Hasta ahora, has aprendido a utilizar diferentes
objetos en Small Basic, como los objetos
GraphicsWindow, Shapes, File y Math.
Esta lección presenta el objeto Controls que ofrece
Small Basic. Con este objeto, puedes mostrar
controles simples, tales como cuadros de texto y
botones, en la ventana gráfica.

4. Operaciones del objeto Controls
Antes de crear un programa mediante el objeto Controls, vamos a aprender
acerca de algunas operaciones del objeto Controls y sus parámetros.
AddTextBox—Puedes definir un
cuadro de texto que aparecerá en la
ventana gráfica mediante el uso de
esta operación. Como parámetros,
debe especificar la coordenada x y la
coordenada y de la caja de texto.
AddButton—Puedes definir un botón
que aparecerá en la ventana gráfica
mediante el uso de esta operación.
Como parámetros, se deben
especificar el título del botón, su
coordenada x y su coordenada y.

5. Operaciones del objeto Controls
GetButtonCaption—Mediante esta operación,
puedes recuperar el título de un botón. Debes
especificar el nombre del botón como parámetro.
SetButtonCaption—Mediante esta operación,
puedes establecer o cambiar el título de un botón.
Debes especificar el nombre de la tecla y el nuevo
título como parámetros.
GetTextBoxText—Puedes recuperar el texto que
aparece en un cuadro de texto especificando su
nombre como un parámetro para esta operación.
SetTextBoxText—Puedes definir el texto que
aparece en un cuadro de texto especificando su
nombre y el texto requerido como parámetros para
esta operación.

6. Operaciones del objeto Controls
Además de agregar controles útiles en tu programa, puedes realizar
determinadas operaciones y definir los ajustes de los controles que se
agregan.
Vamos a explorar el objeto Controls con la
ayuda de un ejemplo.
Haga clic en de la barra de herramientas.

7. Propiedades y Operaciones del objeto Controls
Echemos un vistazo a las capacidades de las operaciones y propiedades que
ofrece el objeto Controls.
HideControl—Puedes utilizar esta
operación para ocultar un control
existente de la ventana gráfica.
ShowControl—Puedes utilizar esta
operación para mostrar un control
previamente oculto en la ventana
gráfica.
Remove—Puedes utilizar esta
operación para eliminar un control
de la ventana gráfica.

8. Propiedades y Operaciones del objeto Controls
SetSize—Puedes especificar un tamaño fijo para
un control mediante el uso de esta operación.
Debes especificar el nombre, altura y anchura del
control como parámetros.
Move—Puedes mover un control a una posición
diferente en la ventana gráfica mediante el uso de
esta operación. Debes especificar el nombre, la
coordenada izquierda y coordenada superior del
control como parámetros.
LastClickedButton—Puedes utilizar esta
operación para encontrar el último botón
que hizo clic en la ventana gráfica.
LastTypedTextBox—Puedes utilizar esta
operación para encontrar el último cuadro de
texto donde fue escrito el texto.

9. El objeto Controls
Ahora vamos a escribir un programa sencillo que incluye el objeto Controls.
Este programa muestra las definiciones de una palabra dada.

10. Eventos de Controls
Ahora que estás familiarizado con el objeto Controls en Small Basic, vamos a
presentar los eventos que puedes utilizar para ese objeto. Los eventos de
Controls pueden generar acciones en tu programa cuando el usuario hace clic en
un botón o tipea algún texto en un cuadro de texto.
ButtonClicked provoca un evento
cuando el usuario hace clic en un botón.
TextTyped provoca un evento cuando el
usuario escribe texto en un cuadro de
texto.
Puedes utilizar el evento ButtonClicked
para hacer una simple calculadora
como la que aparece a la derecha:
Y aquí está un ejemplo del
evento TextTyped:

11. Vamos a resumir…
¡Felicidades! Ahora ya sabes cómo:
Usar las distintas propiedades del objeto Controls.
Usar varias operaciones del objeto Controls.
Usar los eventos de control en los botones y cuadros de texto
en tu programa.

12. Demuestra lo que sabes
Escribe un programa de apariencia simple y que
realice los siguientes pasos:
 Agregar cuadros de texto para solicitar el
nombre, dirección, número de teléfono y
correo electrónico del usuario.
 Agregar un botón Enviar en el formulario.
 Después de que el usuario especifica la
información y haga clic en Enviar, se
mostrará un mensaje apropiado a su
criterio.