TRABAJO CON PROYECTOS VISUALES EN C#

Un proyecto visual en C# se crea como una Windows Application, de la siguiente manera:

Como normas fundamentales de planificacin de un proyecto, vemos unos cuantos detalles a la hora de generar un proyecto de este tipo (y de otros): ? ? Siempre hay que poner la solucin en un sitio conocido y adecuado, no en el sitio por defecto que propone el entorno. No hay que dejar los nombres por defecto, tales como Solution1, Application1, etc. Cuando tengamos varios proyectos no habr manera de identificarlos con las carpetas ni con sus nombres, y todos parecern iguales. No es buena idea meter en la misma carpeta la solution y el project. Hay que generar una carpeta independiente para el proyecto, dentro de la carpeta de la solucin. Lo ms normal es que una solution tenga varios proyectos, y que uno de ellos comparta el sitio con ella, sea cual sea, no es lo ms indicado. En general, cuando se dan de alta elementos de un proyecto o una solution mediante los asistentes, hay que poner nombres a todo, porque si no, luego cuesta mucho ms el cambiarlos una vez que se han generado.

Una vez generada la solution y el proyecto, tendremos una pantalla como la siguiente:

Lo primero que hemos de hacer es dar un nombre adecuado al formulario. No es bueno que los formularios de un proyecto se llamen Form1, Form2, etc. Hemos de cambiar su nombre (propiedad (name), tal como se ve en la pantalla anterior). Hemos de cambiar el nombre del fichero donde se va a guardar. En este caso, el formulario se va a llamar Principal, y su fichero ser Principal.cs Hay que cambiar un pequeo detalle en el cdigo:

Hay que cambiar el new Form1() por un new Principal, ya que hemos cambiado el nombre al formulario. Es importante hacer estas tareas al principio, antes de todo lo dems, porque si no, luego tendremos un montn de funciones con nombre que hacen referencia a Form1, y ser mucho ms complicado.

Ahora estamos en disposicin de ver como funciona nuestro proyecto. Ejecutndolo, aparecer un programa totalmente vaco:

Para cambiar la vista de edicin entre el diseo del formulario y el cdigo, en la ventana de la solucion tenemos los siguientes botones:

Vista de diseo del formulario Vista de cdigo

Propiedades del formulario

Hay un conjunto de propiedades que se pueden establecer durante el diseo del mismo, es decir, sin escribir cdigo: Las propiedades del intuitivas, en general. formulario son bastante

La que se usan ms normalmente son las siguientes: Name FormBorderStyle GridSize Icon MaximizeBox MinimizeBox Size StartPosition Text WindowState

Name Es el nombre del formulario. Todo formulario tiene que tener un nombre decente, no Form1, o Form2, hay que cambiarlo siempre.

FormBorderStyle Es el estilo del borde del formulario. Los valores ms usados son: - Sizeable: El usuario puede cambiar el tamao del formulario durante la ejecucin del programa. - FixedDialog: El tamao del formulario en ejecucin es fijo, no se puede modificar. En general, no se debe dejar como sizeable un formulario que no resizee su interior convenientemente al cambiar de tamao, da muy mala imagen y sensacin de dejadez y poca profesionalidad. GridSize Es el tamao de separacin entre los puntitos que aparecen en tiempo de diseo y que valen para colocar alineados los componentes dentro del formulario. Normalmente, un valor de 4x4 es mucho ms adecuado que el de 8x8 que aparece por defecto. Icon Es el icono del formulario (dibujito superior izquierdo). En un proyecto solo ha de tener icono el formulario principal, o bien los formularios MDIChild si es un proyecto MDI. En el resto de formularios hay que quitar el icono, queda muy feo un formulario de interaccin con el usuario con un dibujo por defecto que no vale para nada. MaximizeBox MinimizeBox Sirven para hacer aparecer o desaparecer los botones de maximizado y minimizado en el borde superior derecho de la pantalla. En un formulario fijo, estos botones se han de quitar, no pintan nada y hace muy feo que queden alli. Size Define el tamao del formulario. Normalmente es mejor ajustar su tamao estirandolo directamente con el raton, pero si queremos que mida algo exacto, se pueden fijar en esta propiedad los valores. StartPosition Dice la posicin del formulario con respecto a la pantalla y al formulario que lo activa. Por defecto, esta propiedad vale WindowsDefaultLocation. No se debe dejar as. Los valores adecuados son: - CenterScreen: El formulario aparece centrado en la pantalla - CenterParent: El formulario aparece centrado en el que lo activ. Text Es el texto del titulo del formulario WindowState Para formularios sizeables, esta propiedad permite decidir si el formulario aparecer de alguna de las siguientes maneras: - Normal: En el tamao en que ha sido dibujado - Maximized: Ocupando toda la pantalla del ordenata. - Minimized: Iconizado en la barra de tareas. Existen propiedades de aspecto del formulario, tales como: BackColor BackgroundImage ForeColor Font Opacity TransparencyKey TopMost

Estas propiedades son muy majas de probar (fuentes, colores, etc). Sin embargo no deben ser cambiadas a no se que se quiera indicar algo muy importante con ese cambio. Las pantallas de un programa han de ser lo ms estndar posible, no deben ser de color rosa, con fuentes raras, ni nada semejante. Este tipo de cambios exigen una gran coherencia de imagen en todo el proyecto, y normalmente lo mejor es dejar la apariencia tal cual.

Eventos del formulario

Los eventos son seales lanzadas por el formulario en tiempo de ejecucin, las cuales podemos capturar y definir el cdigo que se ejecutar cuando ocurran: Los que se usan ms normalmente son los siguientes: Load Activated Deactivate Closed Closing Click DoubleClick KeyUp KeyDown KeyPress MouseUp MouseDown MouseMove Paint Resize

Load Activated Deactivate Closed Closing Son eventos que se lanzan al cargar se formulario, al cargarse los controles y activarse, al perder el foco de activacin, y al descargarse. Veremos mas adelante un ejemplo de su uso, con un formulario hijo activado especficamente. Click DoubleClick MouseMove MouseUp MouseDown Son eventos que se lanzan al mover el ratn o pulsar los botones del mismo. KeyUp KeyDown KeyPress Son eventos que se lanzan al pulsar teclas en el teclado. (Atencin a la propiedad KeyPreview). Paint Evento lanzado cuando el formulario es repintado por el sistema operativo (estaba debajo de alguna otra cosa, adquiere visibilidad y debe ser redibujado). Rezise Evento lanzado cuando el formulario cambia de tamao.

Ejemplo de atencin a un evento del formulario.

Vamos a hacer que en la barra del titulo del formulario, en todo momento, figure la posicin donde se encuentra el ratn. ?

Primero hemos de atender el evento MouseMove, que es el que se produce cuando el ratn cambia de sitio.

Hemos hecho doble click sobre el evento que queremos atender, y ha aparecido automticamente la funcin que se ejecutar cuando se produzca ese evento. Dentro de la funcin, hemos escrito this.Text = e.X + , + e.Y; que coloca en la propiedad Text del formulario la coordenada X y la coordenada Y separado por una coma. El argumento e (de tipo System.Windows.Forms.MouseEventArgs) contiene las propiedades actuales del ratn, entre las que estn la X y la Y, que son las que hemos utilizado.

Si abrimos el codigo manejado por el diseador del formulario, tenemos lo siguiente:

Aqu podemos ver que todas las propieadades que hemos establecido en tiempo de diseo, realmente han sido codificadas dentro del programa por el diseador de formularios. En la ultima linea, podemos ver como se aade el delegado Principal_MouseMove a la gestion de eventos de MouseMove del formulario, que es la que realmente codifica la gestion del evento. this.MouseMove es un array de punteros a funciones, que sern llamadas cuando se produzca el evento. Tiene sobrecargado el operador +, que permite aadir funciones a este array. Si queremos eliminar la atencin de este evento, deberemos eliminar esta linea del InitializeComponent, y luego borrar la funcion Principal_MouseMove. Una alternativa es posicionarnos en el evento (en el diseo del formulario), hacer botn derecho, y escoger Reset. Esto elimina la agregacin del delegado, pero todava deberemos eliminar manualmente la funcin Principal_MouseMove.

En tiempo de ejecucin nuestro programa ahora sera el siguiente (vemos como en la barra de ttulo aparecen las coordenadas del ratn en el momento actual):

INSERCION DE COMPONENTES DENTRO DE UN FORMULARIO

Veremos ahora como insertar y utilizar los componentes ms normales, los ms sencillos.

Insercin de un men

Menu, una vez elaborado Componente de tipo Menu Hemos aadido un men al programa (seleccionar el componente, y hacer click en medio del formulario). Le hemos dado un nombre (en este caso MenuPrincipal). Hemos tecleado las opciones del men (es bastante intuitivo, type here, ). Le hemos dado nombre a las opciones que vamos a utilizar del men (Hacer Algo -> MNU_HacerAlgo, Salir -> MNU_Salir). Para meter un separador en el men, hay que insertar un elemento y ponerle como texto un guin. Ahora atendemos los eventos del men MNU_HacerAlgo, y del MNU_Salir, tal como se ha explicado en el caso del formulario. Hay que tener en cuenta que las propiedades y eventos que aparecen en la parte derecha del diseador corresponden al objeto que esta seleccionado.

Vemos que la opcin de men hacer algo nos da un mensaje (observar la llamada a MessageBox.Show), y que el men Salir termina la ejecucin del formulario (invoca al mtodo Close ()).

Hay que tener cuidado y dar nombres razonables a todos los elementos de men que vayan a ser utilizados como generadores de eventos. No se deben dejar elementos como MenuItem1, ni cosas por el estilo, porque despus es muy complicado ver que hace un programa y entenderlo.

Insercin de una etiqueta

Componente de tipo Label Hemos insertado una etiqueta en el formulario. Le hemos puesto de nombre UnaEtiqueta, y en la propiedad Text Esto es el titulo de la etiqueta. Una etiqueta se usa bsicamente para dos cosas: Para poner un titulo en el formulario, sin ms. Para definir un rea donde se mostrarn datos de solo lectura al usuario.

Si la etiqueta se va a usar para mostrar informacin al usuario, se le debe cambiar el nombre. No es bueno encontrar en el programa cosas del estilo: Label1.Text = Informacin, por ejemplo. Las propiedades de la etiqueta son bastante intuitivas, comentaremos las ms importantes y ms comnmente usadas: AutoSize BorderStyle TextAlign Permite definir si la etiqueta ha de ajustar su tamao automticamente. Permite definr el aspecto del borde de la etiqueta Definicin del alineado del contenido de la etiqueta.

Insercin de un botn

Componente de tipo Button (botn) La propiedad ms importante del botn es Text, que es el texto que aparece dentro del mismo. Atencin del evento Click del botn: En este caso, al pulsar el botn, escribimos en la etiqueta anterior Hola que tal.

Insercin de una caja de texto

Componente de tipo TextBox (caja de texto) Una caja de texto se utiliza para que el usuario teclee datos que el programa usar despus (una especie de scanf, mas o menos). La propiedad ms importante es Text, que es el contenido de la caja de texto. Se le pueden asignar cosas o consultar su valor. Vamos a modificar el evento click del botn, para que al pulsarlo haga que el la etiqueta salga lo que hay escrito en la caja de texto:

Un programa muy sencillo, se puede construir bsicamente con etiquetas, botones y cajas de texto (el men ya sera algo sofisticado). El resto de controles no los vamos a comentar en este momento, muchos de ellos son muy intuitivos y solo hay que probar su funcionamiento, otros, son mas complicados, y seguramente exigirn buscar informacin sobre ellos. Generalmente, no hay ms que escribir en el Google lo que uno busca, y aparecen cosas hasta de debajo de las piedras:

Sin embargo, muchas veces es necesario pintar dentro del formulario, visualizar grficas, datos en forma de matriz, etc. Vamos a ver ahora un par de tcnicas para conseguir esto: Por un lado, utilizaremos un panel para dibujar fsicamente en su interior. Por otro lado, utilizaremos el control dbGrid, que es una matriz de visualizacin de datos.

Dibujar dentro de un panel Vamos a insertar un panel y un botn en el formulario:

Control de tipo Panel Al panel lo hemos llamado Dibujo, y al botn Dibujar. En el evento click del botn dibujar, escribimos lo siguiente:

Hemos hecho lo siguiente: ? Obtener un objeto de tipo System.Drawing.Graphics para poder dibujar en l. No se puede dibujar directamente en el panel, hace falta el contexto que devuelve su mtodo CreateGraphics, para hacerlo dentro de l. Para dibujar una lnea es necesario definir un Lpiz (se puede reutilizar luego, por supuesto), y utilizar el mtodo DrawLine del objeto Graphics. Para dibujar texto hace falta definir una fuente, una brocha, y utilizar el mtodo DrawString. Para dibujar un rectngulo, hace falta un lpiz, y utilizar el mtodo DrawRectangle.

? ? ?

La clase Graphics tiene muchsimas llamadas, es cuestin de consultarla para ver ms posibilidades.

El aspecto en ejecucin de este programa, una vez pulsado el botn, ser el siguiente:

Sin embargo, ocurre una desgracia irreparable Cuando ocultamos el formulario (poniendo otro encima, cambiando de tarea), al volver a visualizarlo el dibujo ha desaparecido. Esto ocurre porque Windows no guarda el contenido de cada ventana cuando deja de estar en el topmost de pantalla. Si hiciera esto, debera guardar, por ejemplo, para esta ventana, unos 600 x 400 puntos, esto es 240.000, cada punto ocupara 4 bytes, o sea, casi una mega. Se ve que es inviable, si cada pantalla ocupara una mega de memoria solo para guardar el dibujito, el sistema se colapsara rpidamente, al activar varios programas. Por tanto, Windows lanza un evento Paint cuando un control debe ser repintado, por pasar a estar visible una parte que haba estado oculta anteriormente. La tcnica de un programa es entonces un poco ms estructurada: No se puede pintar directamente en pantalla (a menos que no nos importe que se pierda la informacin al ocultarse), sino que se ha de crear una estructura de datos con la informacin a pintar, y dentro del evento Paint realizar el dibujo de la misma. Se puede provocar un repintado invocando al mtodo Invalidate.

Hemos cambiado un poco el cdigo: El objeto Graphics, para pintar, ya est disponible en el argumento e que llega al evento paint. El texto que se pinta es el contenido de la caja, para ver como realmente cambia.

Ahora, en el Paint se realiza el trabajo de dibujar, y en el botn simplemente se llama a Invalidate, para provocar un evento de este tipo. Cuando el programa se inicia, ya aparece pintada la informacin, porque se produce un evento Paint justo al dibujarse el control.

Como utilizar una DataGrid para cargar informacin.

Componente DataGrid Para esta prueba se ha aadido al proyecto una clase Cliente:
using System; namespace EjemploV { public class Cliente { private int m_Codigo; private string m_Nombre; public Cliente(int Codigo,string Nombre) { m_Codigo = Codigo; m_Nombre = Nombre; } public int Codigo { get { return m_Codigo; } set { m_Codigo = value; } } public string Nombre { get { return m_Nombre; } set { m_Nombre = value; } } } }

El cdigo asociado al primer botn (Grid) es el siguiente:

Se puede ver como asocia al datagrid (propiedad DataSource) un DataTable, que contiene la informacin a mostrar. Es decir, se trata de crear un DataTable, con sus DataColumn correspondientes, y luego asignarlo al DataSource del DataGrid para que lo visualice. Al crear un DataColumn se le ha de indicar el nombre de la columna y el tipo de dato (en este caso son todas string). Las propiedades adicionales (PreferredColumnWidth, etc) son para visualizar mejor la informacin.

El cdigo asociado al segundo botn (Grid2) es el siguiente:

En este caso, se le asigna al DataGrid un ArrayList, donde cada elemento es de tipo Cliente. La grid muestra en cada fila un elemento del ArrayList, cada uno con sus datos asociados.

El uso mas habitual de un datagrid est enfocado a utilizar bases de datos. Por ejemplo, esta seria la forma de mostrar una consulta sobre una grid:
private void Consultar_Click(object sender, System.EventArgs e) { SqlConnection Cnx; Cnx = new SqlConnection("server=localhost;uid=pepe;pwd=pepe;database=Musika"); Cnx.Open(); SqlDataAdapter Adp; Adp = new SqlDataAdapter("SELECT * FROM Grupos WHERE GRP_Nombre LIKE 'K%'", Cnx); DataSet Dt = new DataSet(); Adp.Fill(Dt, "Grupos"); Cnx.Close(); G.DataSource = Dt; G.DataMember = "Grupos"; G.Refresh (); }

Este programa crea una conexin con una base de datos en SqlServer (Musika). Crea una consulta sobre la tabla Grupos, buscando los que tengan el nombre empezando por K. Crea un DataSet y lo llena con la consulta. Enlaza este DataSet con la Grid, y como se puede ver, aparecen los resultados.

Uso del control OpenFileDialog / SaveFileDialog Este control sirve para abrir la ventana estandar de Windows y pedir al usuario que escoja un archivo:
private void Abrir_Click(object sender, System.EventArgs e) { DlgAbrir.Filter = "Pedeefes|*.pdf|" + "Textos|*.txt|" + "Documentos|*.doc|" + "Imagenes|*.bmp;*.jpg;*.gif|" + "Todos los archivos|*.*"; DlgAbrir.InitialDirectory = "C:\\Kastefa\\LPII (2004-2005 Q1)"; DlgAbrir.Title = "Abrir unas cosas"; if (DlgAbrir.ShowDialog () == DialogResult.OK) { lbAbrir.Text = DlgAbrir.FileName; } }

La propiedad Filter (optativa, por defecto muestra todos los archivos) llena el combo inferior (Tipo), y sirve para filtrar determinadas extensiones y mostrar una leyenda adecuada. La propiedad Title (optativa, por defecto muestra Abrir), sirve para cambiar el titulo del dilogo. La propiedad InitialDirectory sirve para establecer el directorio en el que se abre el dialogo. Devuelve DialogResult.OK si se puls Abrir, DialogResult.Cancel si se puls Cancelar. La propiedad FileName contiene el nombre del archivo con la ruta completa. La propiedad FileTitle contiene el nombre del archivo, sin el path.

Una vez aceptado el dilogo, se puede ver el nombre del archivo en la etiqueta inferior:

El cdigo asociado al botn Guardar sera el siguiente:

private void Guardar_Click(object sender, System.EventArgs e) { DlgSalvar.FileName = lbAbrir.Text; if (DlgSalvar.ShowDialog() == DialogResult.OK) lbAbrir.Text = "Se ha escogido salvar"; else lbAbrir.Text = "Se ha escogido no salvar"; }

Uso del control Timer Este control sirve para provocar eventos temporales, cada cierto tiempo.

Control Timer Le hemos llamado Temporizador, como nombre del objeto insertado. Sus propiedades ms importantes son: Enabled Interval Indica si funciona o no funciona. (Envia eventos o no lo hace) Tiempo entre evento y evento, en milisegundos.

En el formulario se ha puesto un botn Tiempo, que lo habilita y lo deshabilita, y una etiqueta para ver la fecha/hora actuales, refrescada en cada evento del temporizador:
private void Tiempo_Click(object sender, System.EventArgs e) { Temporizador.Enabled = !Temporizador.Enabled; Temporizador.Interval = 1000; } private void Temporizador_Tick(object sender, System.EventArgs e) { lbTiempo.Text = DateTime.Now.ToString(); }

El evento Tick del Timer es el que se enva cada vez que vence la cuenta.