Función CStr Función CStr Función CStr
vbShortTime 4 Muestra una hora con el formato de 24 horas (hh:mm) Comentarios
El siguiente ejemplo usa la función FormatDateTime para dar formato de fecha larga a la expresión y asignarla a MiFechaHora:
Function ObtenerFechaActual
' FormatDateTime da formato a Date como fecha larga.
ObtenerFechaActual = FormatDateTime(Date, 1)
End Function
Función FormatNumber
Función FormatNumberFunción FormatNumber
Función FormatNumber
Descripción
Devuelve una expresión con formato de número.
Sintaxis
FormatNumber(Expresión [,NúmDígitosDespuésDeDecimal [,IncluirDígitoInicio [,UsarParéntesisParaNúmerosNegativos [,GrupoDígitos]]]])
La sintaxis de la función FormatNumber tiene las siguientes partes:
Parte Descripción
Expresión Requerido. Expresión a la que se va a aplicar formato.
NúmDígitosDespuésDeDecimal Opcional. Valor numérico que indica cúantos lugares se muestran a la derecha del decimal. El valor predeterminado es -1, que indica que se usa la configuración regional del equipo.
IncluirDígitoInicio Opcional. Constante de tres estados que indica si se debe mostrar o no un cero inicial para valores fraccionarios. Consulte la sección Valores para saber cuáles son los valores permitidos.
UsarParéntesisParaNúmerosNegativos Opcional. Constante de tres estados que indica si se deben encerrar o no los valores negativos entre paréntesis. Consulte la sección Valores para saber cuáles son los valores permitidos.
GrupoDígitos Opcional. Constante de tres estados que indica si se deben agrupar o no los números con el delimitador de grupos especificado en el Panel de control. Consulte la sección Valores para saber cuáles son los valores permitidos.
Los argumentos IncluirDígitoInicio, UsarParéntesisParaNúmerosNegativos y GrupoDígitos tienen los siguientes valores:
Constante Valor Descripción
TristateTrue -1 True
TristateFalse 0 False
TristateUseDefault -2 Usa la configuración regional del equipo.
Comentarios
Cuando se omiten uno o más de los argumentos opcionales, los valores de los argumentos omitidos los proporciona la configuración regional del equipo.
Nota
Toda la información de configuración y valores se obtiene de la ficha Número de Configuraciónregional.
El siguiente ejemplo usa la función FormatNumber para dar formato a un número para que tenga cuatro lugares decimales:
Function EjemploDeFormatNumber Dim MiAngulo, MiSecante, MiNumero
MiAngulo = 1.3 ' Define un ángulo en radianes. MiSecante = 1 / Cos(MiAngulo) ' Calcula la secante.
EjemploDeFormatNumber = FormatNumber(MiSecante,4) ' Da formato a MiSecante para que tenga
cuatro lugares decimales. End Function
Función FormatPercent
Función FormatPercentFunción FormatPercent
Función FormatPercent
Descripción
Devuelve una expresión con formato de porcentaje (multiplicada por 100) con una carácter % inicial.
Sintaxis
FormatPercent(Expresión[,NúmDígitosDespuésDeDecimal [,IncluirDígitoInicio [,UsarParéntesisParaNúmerosNegativos [,GrupoDígitos]]]])
La sintaxis de la función FormatPercent tiene las siguientes partes:
Parte Descripción
Expresión Requerido. Expresión a la que se va a aplicar formato.
NúmDígitosDespuésDeDecimal Opcional. Valor numérico que indica cúantos lugares se muestran a la derecha del decimal. El valor predeterminado es -1, que indica que se usa la configuración regional del equipo.
IncluirDígitoInicio Opcional. Constante de tres estados que indica si se debe mostrar o no un cero inicial para valores fraccionarios. Consulte la sección Valores para saber cuáles son los valores permitidos.
UsarParéntesisParaNúmerosNegativos Opcional. Constante de tres estados que indica si se deben encerrar o no los valores negativos entre paréntesis. Consulte la sección Valores para saber cuáles son los valores permitidos.
los números con el delimitador de grupos especificado en el Panel de control. Consulte la sección Valores para saber cuáles son los valores permitidos.
Valores
Los argumentos IncluirDígitoInicio, UsarParéntesisParaNúmerosNegativos y GrupoDígitos tienen los siguientes valores:
Constante Valor Descripción
TristateTrue -1 True
TristateFalse 0 False
TristateUseDefault -2 Usa la configuración regional del equipo.
Comentarios
Cuando se omiten uno o más argumentos opcionales, los valores de los argumentos omitidos los proporciona la configuración regional del sistema.
Nota
Toda la información de configuración y valores se obtiene de la ficha Número de Configuraciónregional.
El siguiente ejemplo usa la función FormatPercent para dar formato a una expresión como porcentaje: Dim MiPorcentaje
MiPorcentaje = FormatPercent(2/32) ' MiPorcentaje contiene 6.25%.
Función GetObject
Función GetObjectFunción GetObject
Función GetObject
Descripción
Devuelve una referencia a un objeto de Automatización desde un archivo.
Sintaxis
GetObject([nombrederuta] [, clase])
La sintaxis de la función GetObject tiene las siguientes partes: Parte Descripción
nombrederuta Opcional; String. Ruta y nombre completos del archivo que contiene el objeto que desea recuperar. Si se omite nombrederuta, se requiere clase.
clase Opcional; String. Clase del objeto.
El argumento claseusa la sintaxis nombredeaplicación.tipodeobjeto y tiene las siguientes partes:
Parte Descripción
nombredeaplicación Requerido; String. Nombre de la aplicación que proporciona el objeto.
Use la función GetObject para tener acceso a un objeto de automatización desde un archivo y asignar el objeto a una variable de objeto. Use la instrucción Set para asignar el objeto devuelto por GetObject a la variable de objeto. Por ejemplo:
Dim CADObject
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")
Cuando se ejecuta este código, se inicia la aplicación asociada con el nombre de ruta especificado y el objeto del archivo especificado se activa. Si nombrederuta es una cadena de longitud cero (""), GetObject devuelve una nueva instancia de objeto del tipo especificado. Si se omite el argumento nombrederuta, GetObject devuelve un objeto activo del tipo especificado. Si no existe ningún objeto del tipo especificado, se produce un error.
Algunas aplicaciones le permiten activar parte de un archivo. Agregue un signo de admiración (!) al final del nombre del archivo y, a continuación, agregue una cadena que identifique la parte del archivo que desea activar. Para obtener información acerca de cómo crear esta cadena, consulte la documentación de la aplicación que creó el objeto.
Por ejemplo, en una aplicación de dibujo podría tener varias capas de un dibujo almacenado en un archivo. Podría usar el siguiente código para activar una capa de un dibujo llamado SCHEMA.CAD:
Set ObjetoCapa = GetObject("C:\CAD\SCHEMA.CAD!Layer3")
Si no especifica la clase de objeto, la automatización determina la aplicación que debe iniciar el objeto para activarlo, basado en el nombre de archivo proporcionado. Sin embargo, es posible que algunos archivos admitan más de una clase de objeto. Por ejemplo, un dibujo puede admitir tres tipos de objeto distintos: un objeto Application, un objeto Drawing y un objeto Toolbar, y todos forman parte del mismo archivo. Para especificar qué objeto desea activar en un archivo, use el argumento opcional clase. Por ejemplo:
Dim MiObjeto
Set MiObjeto = GetObject("C:\DIBUJOS\EJEMPLO.DRW", "FIGMENT.DRAWING")
En el ejemplo anterior, FIGMENT es el nombre de una aplicación de dibujo y DRAWING es uno de los tipos de objeto que admite. Una vez activado un objeto, se hace referencia a él en el código mediante la
variable de objeto definida. En el ejemplo anterior, se tiene acceso a las propiedades y métodos del nuevo objeto con la variable de objeto MiObjeto. Por ejemplo:
MiObjeto.Line 9, 90
MiObjeto.InsertText 9, 100, "Hola mundo." MiObjeto.SaveAs "C:\DIBUJOS\EJEMPLO.DRW"
Nota
Use la función GetObject cuando hay una instancia actual del objeto o si desea crear el objetocon un archivo cargado. Si no hay una instancia actual y no desea iniciar el objeto con un archivo cargado, use la función CreateObject.
Si un objeto se ha registrado como un objeto de una única instancia, sólo se crea una instancia del objeto, independientemente del número de veces que se ejecute CreateObject. Con un objeto de una única instancia, GetObject siempre devuelve la misma instancia cuando se llama con una sintaxis con cadena de longitud cero ("") y produce un error si se omite el argumento nombrederuta.
Función GetRef
Función GetRefFunción GetRef
Función GetRef
Descripción
Devuelve una referencia a un procedimiento que se puede enlazar a un evento.
Sintaxis
Set objeto.nombreEvento = GetRef(nombreProc)
La sintaxis de la función GetRef consta de las siguientes partes: Parte Descripción
evento Necesario. Nombre del evento al que se va a enlazar la función.
nombreProc Necesario. Cadena que contiene el nombre del procedimiento Sub o Function que se asocia con el
evento.
Observaciones
La función GetRef le permite conectar un procedimiento VBScript (Function o Sub) a cualquier evento disponible en sus páginas DHTML (de HTML dinámico). El modelo de objetos DHTML proporciona
información acerca de qué eventos están disponibles para sus diversos objetos.
En otros lenguajes de programación y de secuencias de comandos, se llama puntero de función a la funcionalidad que proporciona GetRef, es decir, se señala la dirección de un procedimiento que ejecutar cuando ocurre el evento especificado.
El ejemplo siguiente muestra la utilización de la función GetRef: <SCRIPT LANGUAGE="VBScript">
Function PruebaGetRef() Dim Splash
Splash = "PruebaGetRef Versión 1.0" & vbCrLf Splash = Splash & Chr(169) & " Organización 1998 " MsgBox Splash
End Function
Set Window.Onload = GetRef("PruebeGetRef")
</SCRIPT>