Monday, June 15, 2015

CONTROL SS- TAB USADO PARA CREAR VIÑETAS O PESTAÑAS


El control SSTab en Visual Basic 6.0



  Proporciona un conjunto de Fichas (Panels en otros lenguajes), cada uno de los cuales actúa como contenedor de otros controles (A diferencia del control TabStrip que solo simula el comportamiento pero que no es un contenedor).
Para acceder al control SSTab Elegir: Menú Proyecto > Referencias (o con las teclas Ctrl + T). Debe aparecer el cuadro de dialogo “Componentes”, elegir Microsoft Tabbed Dialog Control 6.0 (TABCTL32.ocx), así ya estará disponible en la barra de herramientas.
Fig. 1: Página de propiedades de un control SSTab mostrando los estilos de Tab que puede presentar.Fig. 1: Página de propiedades de un control SSTab mostrando los estilos de Tab que puede presentar.




1 - Descripción del control

El Control Tabbed Dialog, también denominado SStab, que es muy similar al que nos presenta el cuadro de diálogo de propiedades de pantalla de windows cuando presionamos el botón derecho en el escritorio, consta de una interface con "pestañas", en la que cada una de ellas nos sirve para mostrar una opción determinada.

vista del control Sstab

Cada pestaña puede contener sus propios controles y es una buena opción para presentar interfaces de una forma organizada. Cada pestaña actúa como contenedor de los controles que insertamos
Para incorporarlo a un proyecto lo debemos agregar o añadir bajo el nombre de Microsoft Tabbed Dialog control 6.0 desde la opción agregar componentes del menú de Visual Basic como muestra el siguiente gráfico:

Ventana de componentes de Visual basic
vista de la ventana de componentes para agregar el control Sstab al iniciar un nuevo proyecto

Una ves añadido el control , se visualizará con el siguiente ícono:



2 - Página de propiedades

Para acceder a las propiedades mas importantes del SStab , podemos utilizar el cuadro de diálogo "Custom" o personalizado, desde la ventana de propiedades de visual basic.
O también para acceder a dicha ventana podemos seleccionar el Tabbed Dialog y con el botón derecho elegir la opción Propiedades
En cada pestaña del control podemos colocar controles y estos funcionarán de manera normal, como lo hacen siempre, y al colocarlos en cada pestaña estarán contenidos dentro de estas.
Para insertar un control dentro de una pestaña solo hay que dibujarlo dentro y ya quedará contenido, de igual manera a como se hace en un control PictureBox por ejemplo.
Apenas insertamos el TabbedDialog en el formulario, este presenta 3 pestañas por defecto.
Para agregar o especificar la cantidad de Tabs que queremos utilizar para el , se puede hacer desde el cuadro de diálogo "Custom" en la opción "contador" como está en la imagen:

vista de la ventana página de propiedades del Microsoft Tabbed dialog control

También se puede especificar las pestañas a utilizar, desde la ventana de propiedades de Visual Basic en la propiedad "Tabs" indicando un valor numérico para el mismo.
importanete: Si nosotros hemos agregado pestañas al control y le hemos insertado controles a alguna de ellas y luego queremos eliminar alguna pestaña, hay que anteriormente retirar los controles de las pestañas o eliminarlos, ya que si están contenidos no lo permite.


3 - Propiedad Orientation y Style


Estas son dos propiedades importantes referidas al aspecto gráfico del Tabbed Dialog y a su disposición.

Propiedad Style
Esta puede tener 2 valores, ssStylePropertyPage o ssStyleTabbedDialog
Una vista de estas 2 propiedades:

Vista previa del uso de la propiedad style del control TabbedDialog

La propiedad Orientation
Establece la orientación y disposición de las pestañas en el control, es decir la alineación.
Los valores que puede tener son ssTabOrientationTop (pestañas arriba), ssTabOrientationLeft (Izquierda), ssTabOrientationRight (derecha) y ssTabOrientationBottom (abajo)
Una vista de estas de estas cuatro opciones:
Vista previa de la orientación de las pestañas del control Tabbed

Nota: Para poder utilizar las pestañas con la propiedad Orientation en ssTabOrientationLeft y ssTabOrientationRight, el tipo de fuente que debe tener configurado elTabbedDialog debe ser una fuente de tipo TrueType, de lo contrario se visualizará de forma incorrecta.


4 - Otras propiedades del Tabbed Dialog


TabsPerRow

Devuelve o establece el número de fichas de cada fila de un control SSTab.
Puede usar esta propiedad junto con la propiedad Tabs en tiempo de diseño para determinar el número de filas que aparecen en el control. En tiempo de ejecución, utilice la propiedad Rows.

TabHeight

Devuelve o establece el alto de todas las fichas de un control SSTab.

TabMaxWidth

Devuelve o establece el ancho máximo de cada ficha
Nota : Cuando el valor de la propiedad Style es ssStyleTabbedDialog y el de TabMaxWidth es cero (0), el control SSTab ajusta automáticamente el tamaño de las fichas, según el valor de la propiedad TabsPerRow, para ajustarlas por igual al control.
Si selecciona el valor ssStylePropertyPage en la propiedad Style, se pasará por alto la propiedad TabMaxWidth. En este caso, el ancho de cada ficha se ajusta automáticamente a la longitud del texto de la propiedad TabCaption.

WordWrap

Devuelve o establece un valor que indica si el texto de cada ficha continúa en la línea siguiente cuando es demasiado largo y no cabe horizontalmente en una ficha de un control tabbed dialog.
Comentarios
Puede usar la propiedad WordWrap para determinar la forma en que el control SSTab muestra el texto en cada ficha. Por ejemplo, en un cuadro de diálogo con fichas que se modifica dinámicamente, el texto también puede cambiar. Para asegurarse de que no se truncará si es demasiado largo, establezca la propiedad WordWrap a True, la propiedad TabMaxWidth a cero (0) y la propiedad TabHeight a un alto que permita ver el texto más largo posible.

ShowFocusRect:

Establece mediante True o False si se dibuja un recuadro punteado en el tab cuando este tiene el foco

Picture

establece un gráfico para los Tabs
Comentarios
En tiempo de diseño puede establecer la propiedad Picture de una ficha si hace clic en ella y después establece la propiedad en la ventana Propiedades. En tiempo de ejecución puede establecer la propiedad Picture con la función LoadPicture o con la propiedad Picture de otro control o de otro objeto Form. Puede convertir cualquier ficha en la ficha activa si establece la propiedad Tab.
Al establecer la propiedad Picture en tiempo de diseño, el gráfico se guarda y se carga con el objeto Form que contiene el control SSTab. Si crea unarchivo ejecutable, el archivo contendrá la imagen. Al cargar un gráfico en tiempo de ejecución, el gráfico no se guarda con laaplicación.
Establecer la propiedad Picture afecta al valor de la propiedad TabPicture de la ficha actual y además aparece la imagen correspondiente en la ficha activa.
Ejemplo
Private Sub Command1_Click()
   SSTab1.Picture = LoadPicture("ruta de la imagen ")
End Sub 


TabCaption:

Comentarios
En tiempo de diseño, puede establecer la propiedad TabCaption si hace clic en una ficha y establece la propiedad Caption en la ventana Propiedades. También puede seleccionar (Custom) en la ventana Propiedades y establecer la propiedad TabCaption en la ficha General del cuadro de diálogo Propiedades.
En tiempo de ejecución puede leer o cambiar el título de cualquier ficha mediante la propiedad TabCaption. También puede usar la propiedad Caption para cambiar la propiedad TabCaption sólo para la ficha activa.
Puede usar la propiedad TabCaption para asignar a una ficha unatecla de acceso. En el valor de TabCaption, incluya el símbolo & inmediatamente antes del carácter que desea designar como tecla de acceso. Ese carácter aparecerá subrayado. Presione la tecla ALT y el carácter de subrayado para que la ficha pase a ser la ficha activa. Para incluir un símbolo & en el título sin crear una tecla de acceso, escriba dos símbolos seguidos (&&). En el título sólo aparecerá uno y no habrá ningún carácter subrayado.

Tab

Comentarios
La ficha actual se coloca en primer plano y pasa a ser la ficha activa.
Normalmente, el usuario de la aplicación hará clic en una ficha para convertirla en la ficha activa. Sin embargo, puede que tenga que seleccionarla en el código. Por ejemplo, puede que desee que cierta ficha sea la activa cada vez que se muestre un cuadro de diálogo determinado en la aplicación. Si abandona el cuadro de diálogo mediante el método Hide del objeto Form, la última ficha que estaba activa al ocultar el Form seguirá siendo la ficha activa cuando aparezca de nuevo el cuadro de diálogo. Puede establecer la propiedad Tab del control SSTab para que esté activa la misma ficha cada vez que aparezca el cuadro de diálogo.

Ejemplo
Este ejemplo hace que la ficha activa sea siempre la primera ficha del control SSTab justo antes de mostrar el formulario que contiene el control. Para probar este ejemplo, cree dos objetos Form. Coloque un control CommandButton en el Form1 y un control SSTab en el Form2. Pegue el código en el evento Click del control CommandButton del Form1 y después ejecute el ejemplo.
Private Sub Command1_Click()
   Form2.SSTab1.Tab = 1
   Form2.Show
End Sub
 

Rows

Devuelve el número de filas de fichas
Comentarios
El número de filas del control SSTab se especifica en tiempo de diseño mediante las propiedades Tabs y TabsPerRow.

TabEnabled

Determina si el Tab especificado está habilitado o deshabilitado
Comentarios
Cuando una ficha está desactivada, su texto aparece atenuado y el usuario no puede seleccionarla.
La propiedad TabEnabled activa o desactiva una única ficha. Para activar o desactivar todo el control SSTab, utilice la propiedad Enabled.

TabVisible:

Determina si el Tab especificado estará visible o no
Comentarios
La propiedad TabVisible muestra u oculta una única ficha. Puede usar la propiedad Visible para mostrar u ocultar todo el control SSTab.


5 - Establecer un gráfico a un tab

Para establecerle un gráfico a un Tab, solo hay que seleccionar la pestaña que queremos y desde la ventana de propiedades seleccionar Picture y elegir el archivo gráfico.
Si quisiéremos hacerlo en tiempo de ejecución, podríamos hacerlo de esta forma refiriendonos a la propiedad TabPicture:

Private Sub Command1_Click()
'Le pasamos a la propiedad tabPicture el índice del tab.
El_SSTab.TabPicture(0) = LoadPicture(App.Path & "\imagen.ico")
End Sub

Nota: también podríamos establecer gráficos a cada Tab en tiempo de ejecución que están cargados en un control ImageList.


6 - Ejemplo para establecer en tiempo de ejecución el Caption de un Tab

Aquí cuando se presiona un Command1 se le establece el texto "Datos" al primer Tab, es decir el tab que tiene el índice número 0.
Private Sub Command1_Click()

'Le pasamos a la propiedad TabCaption el índice del tab y le asignamos un texto
SSTab1.TabCaption(0) = "Datos"

End Sub


7 - Agregar Tabs o pestañas en tiempo de ejecución

Agregar un Tabbed Dialog llamado SSTab1, Colocar un Command1 y un Text1 en el formulario.
Luego cada ves que presiones el Command1, se agregará un nuevo Tab en tiempo de ejecución con el texto que se haya ingresado en el control Text1

Código fuente en el formulario
Private Sub Command1_Click()
    Call Agregar(Text1)
End Sub

Private Sub Agregar(Texto_Tab As String)

    SSTab1.Tabs = SSTab1.Tabs + 1

    SSTab1.TabCaption(SSTab1.Tabs - 1) = Texto_Tab

End Sub

Private Sub Form_Load()

    SSTab1.Tabs = 1

End Sub 


8 - Eventos del Sstab

  • Click: Ocurre cuando el usuario presiona y suelta un botón del mouse sobre el control
  • DblClick: Ocurre al presionar y soltar un botón del mouse, y volver a presionarlo y soltarlo sobre el control
  • GotFocus: Ocurre cuando el mismo recibe el enfoque
  • LostFocus: Ocurre cuando el control pierde el enfoque
  • MouseDown: Ocurre cuando el usuario presiona el botón del mouse mientras el control tiene el enfoque
  • MouseMove: Se ejecuta cuando se mueve el mouse sobre el Sstab
  • MouseUp: Se ejcuta al soltar el botón del mouse cuando tiene el enfoque
  • Validate: Ocurre cuando el control pierde el enfoque en favor de un control que produce una validación, en este caso del Sstab

Como se ve en la descripción anterior, este no posee ningún evento propio, es decir tiene los eventos comunes que poseen la mayoría de los controles
Lo único que difiere, es el evento Click, en el cual posee un parámetro extra llamado PreviousTab
Private Sub SSTab1_Click(PreviousTab As Integer)

End Sub

Al hacer Click en el control, este parámetro nos devuelve el Tab anterior al cual se hizo click.
El siguiente ejemplo obtiene el Caption del Tab en el cual se hizo click ( Tab Activo ), y lo visualiza en la barra de título del formulario:

Private Sub SSTab1_Click(PreviousTab As Integer)

'Visualiza en la barra de título del form el caption _
del Tab activo

Me.Caption = SSTab1.TabCaption(SSTab1.Tab)
End Sub
 


9 - Propiedad Container

El siguiente ejemplo, coloca en tiempo de ejecución, un control TextBox que se encuentra fuera del control SSTab, y lo hace en la ficha activa del mismo, utilizando la propiedad Container del textBox:

Private Sub Command1_Click()


' Coloca el Text1 en el tab activo
Set Text1.Container = SSTab1

' Redimensiona el control Text1 y lo posiciona
Text1.Move 50, SSTab1.TabHeight + 100, _
           SSTab1.Width - 100, _
           SSTab1.Height - SSTab1.TabHeight - 200

End Sub 


10 - Redimensionar el SSTab en el Resize del Formulario


Este ejemplo, cuando se cambia de tamaño el Form, redimensiona y posiciona el control Tabbed dialog al ancho y alto que tenga el Form. También se redimensiona un control TextBox que se encuentra dentro de uno de los Tabs
Colocar un sstab y un Textbox dentro de un Tab

Private Sub Form_Resize()


' Posiciona y redimensiona el Sstab al ancho y alto del Fomulario
SSTab1.Move 10, 10, ScaleWidth - 10, ScaleHeight - 10

' Posiciona y redimensiona el TextBox
Text1.Move 50, SSTab1.TabHeight + 100, _
           SSTab1.Width - 100, _
           SSTab1.Height - SSTab1.TabHeight - 200


End Sub


Cómo usar las pestañas en Visual Basic



Cómo usar las pestañas en Visual Basic
Las pestañas de  tienen cuatro funciones diferentes. Permiten navegar dentro de los formularios, sirven como espaciadores para la  de textos a través de Visual Basic, actúan como delimitador entre los campos de texto para las  de datos, y muestran pestañas de cajas de diálogo en las . Dos controles, “TabStrip” and “SSTab”, son parte de la matriz de Visual Basic de control de objetos. Elegir entre los controles TabStrip y SSTab es una decisión que debe tomar el programador dependiendo de las propiedades individuales de cada uno. TabStrip es más complicado para desarrollar pero tiene más características, aunque el control SSTab ofrece un desarrollo más rápido.

 Utilizar Viñetas mediante la propiedad SelBullet

Este ejemplo muestra como utilizar dicha propiedad en conjunto con la propiedad BulletIndent para aplicar viñetas. Como muestra el gráfico, al presionar el checkBox, se establece la propiedad en SelBullet en True. BulletIndent en cambio, especifica la sangría de la línea que tiene la viñeta.
Colocar un check1 y un control RichText
vista del ejemplo con el control check para aplicar viñetas a un control Rich TextBox
Nota: la propiedad BulletIndent para el margen, toma como escala el valor del contenedor del control RichTextbox, es decir si por ejemplo está en un formulario y el ScaleMode en VbPixels, el margen será en pixeles.
 Private Sub Check1_Click()

If Check1 Then

'Sangría de 20 pixeles
   El_RichTextBox.BulletIndent = 20
   'Establece la viñeta al Richtext
   El_RichTextBox.SelBullet = True
Else
   ' Quita la viñeta
   El_RichTextBox.SelBullet = False
End If


El_RichTextBox.SetFocus

End Sub

Private Sub El_RichTextBox_SelChange()
'Cambia el Value del check según el valor _
de SelBullet del párrafo donde estamos ubicados
If El_RichTextBox.SelBullet Then
   Check1.Value = 1
Else
   Check1.Value = 0
End If
End Sub

Private Sub Form_Load()
'Pixeles
Me.ScaleMode = vbPixels
Check1.Caption = " Viñeta "
End Sub





0 comments:

Post a Comment