Você está na página 1de 37

MTBCADVIEWER.

OCX MANUAL DEL CONTROL Y API DE PROGRAMACIN

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 2 de 37

NDICE
Captulo/Seccin 1 2 Pgina INTRODUCCIN ............................................................................................................................ 3 OPCIONES DEL CONTROL .......................................................................................................... 4 2.1 2.2 2.3 2.4 3 4 5 La barra de botones ............................................................................................................. 4 La imagen corporativa. ........................................................................................................ 6 La barra de estado ............................................................................................................... 7 La zona grfica. .................................................................................................................... 9

LISTAS DE ENUMERACIN ....................................................................................................... 10 TIPOS DE DATOS........................................................................................................................ 12 PROPIEDADES ............................................................................................................................ 13 5.1 5.2 Solo lectura ......................................................................................................................... 13 Lectura y escritura ............................................................................................................. 13

6 7 8 9 10 11 12

EVENTOS ..................................................................................................................................... 16 MTODOS .................................................................................................................................... 19 FUNCIONES ................................................................................................................................. 24 REGISTRARSE COMO USUARIO DE MTB SOFTWARE. ........................................................ 32 OBTENCIN DE LICENCIAS ...................................................................................................... 32 ACUERDO DE LICENCIA ............................................................................................................ 33 REDISTRIBUCIN DEL CONTROL ............................................................................................ 34

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 3 de 37

1 INTRODUCCIN
MTBCadViewer.ocx es un componente ActiveX que permite la apertura y visualizacin de dibujos de AutoCAD. Este componente puede incrustarse en sus aplicaciones, dentro del entorno de programacin de los programas de Microsoft Office o en una pgina web. Para ello es necesario que el componente est correctamente instalado en el equipo del cliente. Adems de la visualizacin de dibujos, MTBCadViewer.ocx, segn el tipo de licencia bajo el que se ejecuta, ofrece acceso a todo un conjunto de propiedades, mtodos y eventos con los que puede automatizar el funcionamiento del control. Para utilizar MTBCadViewer.ocx para la visualizacin de dibujos, no es preciso realizar ninguna tarea de programacin, salvo establecer las propiedades necesarias en tiempo de diseo. Por ejemplo, para visualizar dibujos dentro de una hoja de Microsoft Excel basta con incrustar el control en la misma.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 4 de 37

2 OPCIONES DEL CONTROL

2.1 La barra de botones

Abrir un dibujo. Cerrar el dibujo actual. Cambiar el color de fondo de la pantalla. Eliminar todos los objetos virtuales del dibujo actual.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 5 de 37

Inicia el formulario de control de capas.

Permite crear, establecer y eliminar distintas combinaciones de capas.

Muestra la lista de capas del dibujo actual.

Establece la capa actual de trabajo.

Haciendo clic sobre las celdas de la columna Visible puede establecer la visibilidad de las capas. Haciendo clic sobre las celdas de la columna Color puede establecer el ndice de color ACI de AutoCAD para la capa.

Solicita al usuario que seleccione objetos dentro del dibujo para mostrar luego la informacin relativa a los mismos. Realiza un zoom a la extensin del dibujo. Realiza un zoom acercar. Realiza un zoom alejar. Solicita dos puntos en pantalla y realiza un zoom ventana sobre los mismos. Solicita al usuario que seleccione objetos dentro del dibujo para hacer un zoom sobre los mismos. Solicita dos puntos en pantalla para realizar un encuadre sobre los mismos. Realiza un zoom previo. Copia la imagen actual al portapapeles.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 6 de 37

Guarda la imagen actual del visor en formato BMP. Si dispone de licencia comercial o distribucin adems puede controlar el tamao de la imagen exportada. Guarda la imagen actual del visor en formato DWF. Si dispone de licencia comercial o distribucin adems puede controlar el tamao del archivo exportado. Abre el cuadro de dilogo Acerca de, desde el cual puede registrarse como usuario, obtener un cdigo de validacin as como validar su licencia local.

2.2 La imagen corporativa.

Si usted est ejecutando el control en modo de evaluacin, se muestra la imagen corporativa en la parte inferior del visor. Esta imagen dispone de un hipervnculo hacia la pgina web donde puede obtener informacin acerca de cmo adquirir o cambiar el modelo de licencia para su equipo local.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 7 de 37

2.3 La barra de estado

Zona de coordenadas.

Se muestran las coordenadas del cursor sobre el dibujo actual. Esta zona de la barra de estado es sensible al doble clic. Haciendo doble clic sobre esta zona se abrir un formulario desde el cual podr determinar la precisin decimal para los valores mostrados as como si desea que se muestren los ejes acompaando al cursor sobre el dibujo actual.

Lista de presentaciones.

En un cuadro desplegable se muestra la lista de presentaciones disponibles en el dibujo actual. Seleccionando sobre la misma pondr en primer plano la presentacin seleccionada sobre el dibujo. Nota. Algunas funciones o mtodos solo son activos sobre la ficha Modelo careciendo de efectos sobre las presentaciones del espacio papel.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 8 de 37

Nombre del dibujo.

Presenta el nombre del dibujo abierto por el control. No es sensible a ningn evento del ratn. El control permite realizar hasta diez operaciones reservadas para usuario comercial o distribuidor en modo de evaluacin por sesin. Con ello el desarrollador podr poner a prueba su cdigo aunque no disponga de licencia todava. Cuando se ha cumplido este nmero mximo de pruebas aparece una indicacin al lado del nombre del dibujo indicando tal evento. Modo de seleccin.

Haciendo clic sobre esta zona se van conmutando los modos de seleccin soportados por el visor: Seleccin simple (single). Se requiere al usuario que selecciones los objetos uno a uno. Seleccin por captura (croshing). El usuario define una ventana en pantalla y quedan seleccionados todos los objetos que estn en el interior del rectngulo o atravesados por el mismo. Seleccin por ventana (window). El usuario define una ventana en pantalla y quedan seleccionados solamente aquellos objetos que estn completamente en el interior del rectngulo.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 9 de 37

2.4 La zona grfica.

Es el rea donde se muestra la informacin grfica relativa al dibujo actual. Cuando est algn comando en ejecucin que requiera una solicitud al usuario, se muestra al lado del cursor un mensaje indicando la misma.

Este tipo de comandos interactivos pueden cancelarse haciendo clic sobre el botn derecho del ratn.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 10 de 37

3 LISTAS DE ENUMERACIN
MTBPlotSize. o Enumera los posibles tamaos del papel en las exportaciones de dibujos a formato DWF. Los valores admitidos son: A0 A1 A2 A3 A4

DwgTextAlignement. o Enumera los mtodos de alineacin para la insercin de textos. Los valores admitidos son: AlignementLeft AlignementCenter AlignementRight AlignementMiddle AlignementTopLeft AlignementTopCenter AlignementTopRight AlignementMiddleLeft AlignementMiddleCenter AlignementMiddleRight AlignementBottomLeft AlignementBottomCenter AlignementBottomRight

MTB_Language. o Enumera los idiomas en los que el control puede mostrar sus mensajes. Los valores admitidos son: Spanish Catal English Francais

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 11 de 37

DWG_BackColor. o Enumera los colores de fondo para el rea de dibujo del visor. Los valores admitidos son: White Black

MTB_Command. o Enumera el conjunto de comandos que pueden ser invocados desde el cdigo de programacin mediante el mtodo SendCommand. Los valores admitidos son: MTB_ZoomExtens MTB_ZoomLimits MTB_ZoomWindow MTB_ZoomPrevious MTB_ZommToObject MTB_Pan MTB_ZoomIn MTB_ZoomOut

MTB_SelectMode. o Enumera los mtodos de seleccin posibles dentro del control. Los valores admitidos son: MTB_Single MTB_Croshing MTB_Window

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 12 de 37

4 TIPOS DE DATOS
DwgProperty. o Se utiliza como parte del tipo de dato MTB_AcadObject para enumerar las distintas propiedades de los objetos soportados por el control. El contenido del tipo es el siguiente: PropertyName As String PropertyValue As Variant (object)

MTB_AcadObject. o Almacena el conjunto de propiedades de los objetos soportados por el control. El contenido del tipo es el siguiente: ObjectName As String ObjectId As Long Handle As String Layer As String LineType As String LineTypeScale As Double PlotStyleName As String R As Integer G As Integer B As Integer ACIColorIndex As Integer ContextProperties() As DwgProperty

XDataValues. o Se utiliza como parte del tipo de dato MTBXData para enumerar los cdigos y los valores de los datos de entidad extendidos de un objeto. El contenido del tipo es el siguiente: Code As Integer Value As Variant

MTBXData. o Almacena el conjunto de datos de entidad extendidos de un objeto. El contenido del tipo es el siguiente: ApplicationName As String HandleObject As String Values() As XDataValues

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 13 de 37

5 PROPIEDADES
5.1 Solo lectura
DwgName. o Obtiene el nombre del dibujo actual que se muestra en el control. El valor para esta propiedad se establece tras la apertura correcta de un dibujo.

DwgPath. o Obtiene la ruta donde est almacenado el dibujo actual que se muestra en el control. El valor para esta propiedad se establece tras la apertura correcta de un dibujo.

EvaluationMode. o Obtiene el modo en el que se est ejecutando el control. Sus valores son True o False segn el tipo de licencia bajo el que se est ejecutando el componente. El valor para esta propiedad se establece en fase de ejecucin del control.

5.2 Lectura y escritura


AllowCloseDwg. o Obtiene o establece si va a mostrarse el botn de cerrar dibujo en la botonera estndar del control. Valor por defecto: True.

AllowOpenDwg. o Obtiene o establece si va a mostrarse el botn de abrir dibujo en la botonera estndar del control. Valor por defecto: True.

AllowSelectObjects. o Obtiene o establece si va a mostrarse el botn de seleccin de objetos en la botonera estndar del control. Valor por defecto: True.

AllowShowAboutMTB. o Obtiene o establece si va a mostrarse el botn con informacin acerca del control. El control sobre esta variable depender del tipo de licencia bajo la que se est ejecutando el control. Valor por defecto: True.

Aperture. o Obtiene o establece el radio de accin alrededor del cursor sobre el que el control realizar la bsqueda en los casos de seleccin de objetos. La distancia se considera en pxeles. Los valores admitidos van de 1 a 9 pxeles. Valor por defecto: 3

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 14 de 37

BackColor. o Obtiene o establece el color de fondo del visor cuando no hay ningn dibujo abierto. Valor por defecto: &H00000000& (negro)

DwgBackColor. o Obtiene o establece el color de fondo del visor cuando hay un dibujo abierto. Los valores admitidos son negro y blanco. Esta propiedad tambin puede actualizarse utilizando el botn correspondiente en la botonera estndar del control. Valor por defecto: Negro.

Enabled. o Obtiene o establece si el control responder a las acciones del usuario. Valor por defecto: True.

Language. o Obtiene o establece el idioma en que el control mostrar los mensajes al usuario. Valor por defecto: Spanish.

LocalSupportPath. o Obtiene o establece la ruta en el equipo local que va a utilizar el visor para realizar operaciones de lectura y escritura de archivos temporales y/o auxiliares. Debe establecerse una ruta vlida para la que el usuario disponga de los permisos necesarios para el acceso total a esa carpeta. Valor por defecto: C:.

NumDecCoords. o Obtiene o establece el nmero de decimales con los que se representan las coordenadas en el control. Valor por defecto: 4.

SelectMode. o Obtiene o establece el modo de seleccin por defecto que usar el control. Valor por defecto: MTB_Single.

ShowAxis. o Obtiene o establece si el control debe mostrar los ejes sobre la coordenada actual del dibujo.

ShowPromoImg. o Obtiene o establece si el control debe mostrar la imagen corporativa. Solo dispone de control sobre esta propiedad si su nivel de usuario es comercial o distribuidor. Valor por defecto: True.
Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 15 de 37

SupportPath. o Obtiene o establece la lista de directorios donde el control puede obtener archivos de soporte como fuentes de texto, archivos de configuracin de trazadores, etc. Los directorios deben representarse mediante una sola cadena de texto, donde cada una de las rutas indicadas deben ir separadas por el smbolo ; (punto y coma). Si se omite esta propiedad se toma como ruta de soporte la misma donde est instalado el control.

ToolBarVisible. o Obtiene o establece si el control debe mostrar o no la botonera estndar.

VirtualHatchColor. o Obtiene o establece el ndice de color ACI de AutoCAD que debe utilizar el control para los sombreados virtuales de polilneas. Los valores admitidos son de 1 a 255. Valor por defecto: 1 (rojo).

VirtualRemarkColor. o Obtiene o establece el ndice de color ACI de AutoCAD que debe utilizar el control para dibujar los recuadros de remarque de objetos. Los valores admitidos son de 1 a 255. Valor por defecto: 3 (verde).

VirtualTextAlignement. o Obtiene o establece la alineacin que debe utilizar el control en las cadenas de texto virtuales. Los valores admitidos son los especificados en la lista de enumeracin DwgTextAlignement. Valor por defecto: MiddleCenter.

VirtualTextColor. o Obtiene o establece el ndice de color ACI de AutoCAD que debe utilizar el control para los textos virtuales. Los valores admitidos son de 1 a 255. Valor por defecto: 5.

VirtualTextHeight. Obtiene o establece la altura que debe utilizar el control para la insercin de textos virtuales. El valor necesariamente siempre ha de ser superior a 0. Valor por defecto: 2.

VirtualTextRotation. o Obtiene o establece el ngulo de rotacin (en grados decimales) que debe utilizar el control para la insercin de textos virtuales. Los valores admitidos van de 0 a 360. Valor por defecto: 0. La orientacin de los textos virtuales puede verse afectada en funcin del punto de orientacin y direccin de los ngulos establecidos en el dibujo. Por defecto suelen ser: ngulo 0 al este y direccin trigonomtrica (sentido anti horario).

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 16 de 37

6 EVENTOS
Resize. Se produce cuando el control cambia de tamao. Click. Se produce cuando el usuario hace clic con el ratn sobre el control. DblClick. Se produce cuando el usuario hace doble clic sobre el control. KeyDown (KeyCode As Integer, Shift As Integer). Se produce cuando el usuario inicia la pulsacin de una tecla sobre el control. KeyCode Indica el cdigo ASCII de la tecla pulsada. Shift indica si se puls con alguna de las teclas Shift pulsada. KeyPress (KeyAscii As Integer). Se produce cuando el usuario pulsa una tecla. KeyAscii recoge el cdigo ASCII de la tecla pulsada. KeyUp (KeyCode As Integer, Shift As Integer). Se produce cuando el usuario finaliza la pulsacin de una tecla sobre el control. KeyCode indica el cdigo ASCII de la tecla pulsada. Shift indica si se puls con alguna de las teclas Shift pulsada. MouseDown (Button As Integer, Shift As Integer, X As Single, Y As Single). Se produce cuando el usuario pulsa alguno de los botones del ratn sobre el control. Button indica el cdigo del botn pulsado. Shift indica si se mantiene la tecla Shift pulsada. X indica la coordenada X del control donde se produjo la pulsacin. Y indica la coordenada Y del control donde se produjo la pulsacin. MouseMove (Button As Integer, Shift As Integer, X As Single, Y As Single). Se produce cuando se desplaza el cursor sobre el control. Button indica el botn del ratn que est pulsada mientras se produce el evento. Shift indica si se mantiene la tecla Shift pulsada durante el evento. X indica la coordenada X de la posicin del cursor sobre el control. Y indica la coordenada Y de la posicin del cursor sobre el control.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 17 de 37

MouseUp (Button As Integer, Shift As Integer, X As Single, Y As Single). Se produce cuando finaliza la pulsacin de alguno de los botones del ratn sobre el control. Button indica el cdigo del botn pulsado. Shift indica si se mantiene la tecla Shift pulsada. X indica la coordenada X de la posicin del cursor sobre el control al finalizar la pulsacin. Y indica la coordenada Y de la posicin del cursor sobre el control al finalizar la pulsacin. DwgClick (DwgX As Double, DwgY As Double, ActiveCommand As String). Se produce cuando el usuario hace doble clic sobre el rea de dibujo del control. DwgX indica la coordenada X del dibujo donde se puls. DwgY indica la coordenada Y del dibujo donde se puls. ActiveCommand indica el nombre del comando activo (si existe) cuando se realiz la operacin. DwgMouseMove (DwgX As Double, DwgY As Double). Se produce cuando el usuario desplaza el cursor sobre el rea de dibujo. DwgX indica la coordenada X del dibujo correspondiente a la posicin del cursor. DwgY indica la coordenada Y del dibujo correspondiente a la posicin del cursor. CtrlMouseMove (X As Single, Y As Single). Se produce cuando el usuario desplaza el cursor sobre el rea del dibujo. X indica la coordenada X de la zona grfica del control correspondiente a la posicin del cursor. Y indica la coordenada Y de la zona grfica del control correspondiente a la posicin del cursor. DwgObjectsSelected (ArrHandles() As String). Se produce cuando el usuario realiza una seleccin sobre eldibujo. ArrHandles() es una matriz de tipo string que contiene la lista de handles de entidad correspondiente a los objetos seleccionados. DwgLayoutChanged (OldLayoutName As String, NewLayoutName As String). Se produce cada vez que el usuario cambia de presentacin en el dibujo. OldLayoutName indica el nombre de la presentacin actual antes de realizar el cambio. NewLayoutName indica el nombre de la presentacin seleccionada. DwgOpened (DwgFile As String). Se produce cada vez que el control abre un dibujo. DwgFile indica el nombre del dibujo abierto. DwgSaved (DwgFile As String). Se produce cada vez que se realiza una operacin de guardado del dibujo actual. DwgFile indica el nombre con el que se guard el dibujo.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 18 de 37

EntityAddedInDwg (EntityHandle As String). Se produce cada vez que se aade alguna entidad en el dibujo actual. EntityHandle indica el handle de entidad correspondiente al objeto aadido. EntityMovedInDwg (EntityHandles() As String). Se produce cada vez que se realiza una operacin de cambio de ubicacin de objetos sobre el dibujo actual. EntityHandles() es una matriz de tipo string que contiene la lista de handles de entidad correspondiente a los objetos seleccionados. EntityCopiedInDwg (EntityHandles() As String). Se produce cada vez que se realiza una operacin de copia de objetos sobre el dibujo actual. EntityHandles() es una matriz de tipo string que contiene la lista de handles de entidad correspondiente a los nuevos objetos producto de la copia realizada. EntityScaledInDwg (EntityHandles() As String). Se produce cada vez que se realiza una operacin de cambio de escala sobre objetos sobre el dibujo actual. EntityHandles() es una matriz de tipo string que contiene la lista de handles de entidad correspondiente a los objetos escalados.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 19 de 37

7 MTODOS
AddLayer (ByVal LayerName As String, Optional ByVal Visible As Boolean = True, Optional ByVal LayerColor As Integer = 1). o Aade una nueva capa al dibujo actual. Solo disponible para usuario comercial o distribuidor.

CloseDWG. o Cierra el dibujo actual.

ConfigLayers. o Abre el cuadro de dilogo de configuracin de capas. Surte el mismo efecto que si hace clic en el botn correspondiente de la botonera estndar del control.

CopyClip. o Copia al portapapeles la parte del dibujo actual que se muestra en el visor. Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control.

CopyObjects (HandlesObject() As String, FromPoint() As Double, ToPoint() As Double, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True). o Copia un conjunto de objetos en el dibujo actual. Solo disponible para usuario comercial o distribuidor. HandlesObject(). Matriz de tipo string con la lista de los handles de los objetos a copiar. FromPoint(). Matriz de tipo double con tres elementos que representa la coordenada que va a utilizarse como punto de referencia para hacer la copia. ToPoint(). Matriz de tipo double con tres elementos que representa la coordenada que va a utilizarse como punto de destino para hacer la copia. GenerateEvent. Opcional de tipo booleano que indica si la operacin debe generar el evento EntityCopiedInDwg. ShowInDwg. Opcional de tipo booleano que indica si se desea que el visor realice un refresco del dibujo en el mismo momento de realizar la operacin. Si va a realizar una serie de copias va cdigo de objetos puede establecer este parmetro a False y forzar un refresco ms tarde usando el mtodo Redraw. Con ello ganar gran velocidad en el proceso.

GetRGBColor (ByVal ACIColor As Integer, ByRef R As Integer, ByRef G As Integer, ByRef B As Integer). o Establece en los parmetros pasados por referencia R, G y B los componentes rojo, azul y verde respectivamente correspondientes al ndice de color ACI de AutoCAD pasado en el parmetro ACIColor. El rango admitido para ACIColor es de 1 a 255.
Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 20 de 37

SetActiveLayer (ByVal LayerName As String). o Establece la capa indicada en el parmetro como capa de trabajo en el dibujo actual. Solo disponible para usuario comercial o distribuidor.

MoveObjects (HandlesObject() As String, FromPoint() As Double, ToPoint() As Double, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True). o Desplaza un conjunto de objetos en el dibujo actual. Solo disponible para usuario comercial o distribuidor. HandlesObject(). Matriz de tipo string con la lista de los handles de los objetos a desplazar. FromPoint(). Matriz de tipo double con tres elementos que representa la coordenada que va a utilizarse como punto de referencia para hacer el desplazamiento. ToPoint(). Matriz de tipo double con tres elementos que representa la coordenada que va a utilizarse como punto de destino para hacer el desplazamiento. GenerateEvent. Opcional de tipo booleano que indica si la operacin debe generar el evento EntityMovedInDwg. ShowInDwg. Opcional de tipo booleano que indica si se desea que el visor realice un refresco del dibujo en el mismo momento de realizar la operacin. Si va a realizar una serie de desplazamientos va cdigo de objetos puede establecer este parmetro a False y forzar un refresco ms tarde usando el mtodo Redraw. Con ello ganar gran velocidad en el proceso.

Pan (ByVal FirstPointX As Double, ByVal FirstPointY As Double, ByVal LastPointX As Double, ByVal LastPointY As Double). o Realiza una operacin de encuadre sobre el dibujo actual. El encuadre se realiza desde el punto establecido por los parmetros FirstPointX (coordenada X) y FirstPointY (coordenada Y) al punto establecido por los parmetros LastPointX (coordenada X) y LastPointY (coordenada Y).

Redraw. o Redibuja el contenido del control.

RemoveObject (ByVal eHandle As String). o Borra el objeto establecido en el parmetro eHandle del dibujo actual. Solo disponible para usuario comercial o distribuidor.

ResetVirtualObjects(). o Realiza una eliminacin masiva de todos los objetos virtuales existentes en el dibujo actual (sombreados, textos, remarques, etc.). Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 21 de 37

SaveAsBMP (ByVal FullName As String, Optional ByVal Height As Integer = 0, Optional ByVal Width As Integer = 0, Optional ByVal BackColor As DWG_BackColor = DWG_BackColor.White). o Obtiene un archivo en formato de mapa de bits (*.BMP). Disponible solo para usuario registrado, comercial o distribuidor. FullName. Ruta y nombre del archivo bmp a obtener. Height. Especifica la altura que deber tener la imagen obtenida. Si se omite o su valor es 0 toma como altura de la imagen la misma que la zona grfica del control. Los valores para este parmetro se expresan en pxeles. Width. Especifica la anchura que deber tener la imagen obtenida. Si se omite o su valor es 0 toma como anchura de la imagen la misma que la zona grfica del control. Los valores para este parmetro se expresan en pxeles. BackColor. Especifica el color de fondo para la imagen obtenida. Los valores admitidos son los de la lista de enumeracin DWG_BackColor.

SaveAsDwf (ByVal DwfFullName As String, ByVal plotSize As MTBPlotSize, Optional ByVal SaveExtens As Boolean = True). o Obtiene un archivo en formato de Autodesk DWF. Disponible solo para usuario registrado, comercial o distribuidor. DwfFullName. Ruta y nombre del archivo dwf a obtener. plotSize. Especifica el tamao de salida del archivo a obtener. Los valores admitidos son los de la lista de enumeracin MTBPlotSize. SaveExtens. Especifica si el contenido del archivo dwf obtenido mostrar la extensin de la ventana grfica actual. En caso negativo el contenido del archivo dwf obtenido se restringe al conjunto de objetos visibles en pantalla.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 22 de 37

ScaleObjects(HandlesObject() As String, BasePoint() As Double, ByVal ScaleFactor As Double, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True). o Cambia la escala de un conjunto de objetos en el dibujo actual. Disponible solo para usuario comercial o distribuidor. HandlesObject(). Matriz de tipo string con la lista de los handles de los objetos a escalar. BasePoint(). Matriz de tipo double con tres elementos que representa la coordenada que va a utilizarse como punto de referencia para el escalado. ScaleFactor. Especifica el factor de escala a aplicar. Ha de ser mayor que 0. GenerateEvent. Opcional de tipo booleano que indica si la operacin debe generar el evento EntityScaledInDwg. ShowInDwg. Opcional de tipo booleano que indica si se desea que el visor realice un refresco del dibujo en el mismo momento de realizar la operacin. Si va a realizar una serie de ajustes de escala de objetos va cdigo puede establecer este parmetro a False y forzar un refresco ms tarde usando el mtodo Redraw. Con ello ganar gran velocidad en el proceso.

SendCommand (StrCommand As MTB_Command). o Ejecuta un comando dentro del control. Los commandos admitidos son los especificados en la lista de enumeracin MTB_Command.

SetDwgLayout (ByVal LayoutName As String). o Establece como actual la presentacin especificada en el parmetro LayoutName.

SetLayerColor(ByVal LayerName As String, ByVal nColor As Integer). o Establece el ndice de color ACI de AutoCAD para la capa indicada. Solo disponible para usuario comercial o distribuidor. LayerName. Nombre de la capa sobre la que se va a actualizar el color nColor. ndice de color ACI de AutoCAD para el color de la capa. Los valores admitidos van del 1 al 255.

SetLayerVisible(ByVal LayerName As String, ByVal isVisible As Boolean). o Establece la visibilidad de una capa. No puede establecerse como invisible la capa actual. LayerName. Nombre de la capa a tratar. isVisible. Establece la visibilidad de la capa.

ShowLicData. o Carga el formulario desde el cual puede obtener o establecer los datos relativos a la licencia del control.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 23 de 37

ZoomExtens. o Realiza un zoom a la extensin de la presentacin actual. Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control o si se invoca el mtodo SendCommand.

ZoomIn. o Realiza un zoom acercar en la presentacin actual. Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control o si se invoca el mtodo SendCommand.

ZoomLimits. o Realiza un zoom a los lmites de la presentacin actual. Surte el mismo efecto que si se invoca desde el mtodo SendCommand.

ZoomOut. o Realiza un zoom alejar en la presentacin actual. Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control o si se invoca el mtodo SendCommand.

ZoomPrevious. o Realiza un zoom anterior al actual. Surte el mismo efecto que si se hace clic en el botn correspondiente de la botonera estndar del control o si se invoca el mtodo SendCommand.

ZoomToObjects (ArrHandles() As String). o Realiza un zoom sobre los objetos especificados en el parmetro ArrHandles. ArrHandles() es una matriz de tipo string en la que cada uno de sus elementos representa un Handle de entidad de AutoCAD. El zoom se realiza sobre el conjunto de objetos especificados por sus handles en la matriz.

ZoomWindow (ByVal LowerLeftCornerX As Double, ByVal LowerLeftCornerY As Double, ByVal UpperRightCornerX As Double, ByVal UpperRightCornerY As Double). o Realiza un zoom sobre las coordenadas especificadas en los parmetros. LowerLeftCornerX. Coordenada X de la esquina inferior izquierda de la zona sobre la que va a ejecutarse el zoom. LowerLeftCornerY. Coordenada Y de la esquina inferior izquierda de la zona sobre la que va a ejecutarse el zoom. UpperRightCornerX. Coordenada X de la esquina superior derecha de la zona sobre la que va a ejecutarse el zoom. UpperRightCornerY. Coordenada Y de la esquina superior derecha de la zona sobre la que va a ejecutarse el zoom.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 24 de 37

8 FUNCIONES
Function AddArc (CenterPoint() As Double, ByVal Radius As Double, ByVal StartAngle As Double, ByVal EndAngle As Double, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade un arco al dibujo actual. Solo disponible para usuario comercial o distribuidor. Devuelve una cadena con el handle del objeto creado. Solo disponible para usuario comercial o distribuidor. CenterPoint() Matriz de 3 dobles que representa el punto central del arco. Radius. Representa el radio del arco. StartAngle. ngulo inicial donde debe iniciarse el arco. EndAngle. ngulo final donde debe finalizar el arco. IsVirtualObject. (Opcional) Indica si la lnea que va a crearse ser una lnea de tipo virtual (se eliminar al regenerar). Por defecto: True. ACIColor. (Opcional) Indica el color con el que va a crearse la lnea. Por defecto: 256 (por capa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin de un arco. En caso de crear varios arcos en una sola operacin puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Function AddCircle(CenterPoint() As Double, ByVal Radius As Double, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade un crculo al dibujo actual. Solo disponible para usuario comercial o distribuidor. Devuelve una cadena con el handle del objeto creado. Solo disponible para usuario comercial o distribuidor. CenterPoint(). Matriz de 3 dobles que indica la coordenada del centro del crculo. Radius. Indica la longitud del radio del crculo. IsVirtualObject. (Opcional) Indica si la lnea que va a crearse ser una lnea de tipo virtual (se eliminar al regenerar). Por defecto: True. ACIColor. (Opcional) Indica el color con el que va a crearse la lnea. Por defecto: 256 (por capa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin de un crculo. En caso de crear varios crculos en una sola operacin puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 25 de 37

Function AddHatchPredefined (ByVal HandleObject As String, Optional ByVal PatternName As String = "SOLID", Optional ByVal ScaleFactor As Double = 1, Optional ByVal RotationAngle As Double = 0, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade un sombreado al dibujo actual. Devuelve una cadena con el handle del objeto creado. Solo disponible para usuario comercial o distribuidor. La funcin realiza el sombreado sobre los siguientes objetos: AcadPolyline, AcadLWPolyline, AcadCircle y AcadEllipse. HandleObject. Especifica el Handle de entidad del objeto que va a sombrearse. PatternName. Especifica el patrn de sombreado predefinido a utilizar. Por defecto SOLID. ScaleFactor. Especifica el factor de escala que va a usarse en el sombreado. Este parmetro se obvia en caso de que el patrn a utilizar sea SOLID. RotationAngle. Especifica el ngulo de rotacin que va a usarse en el sombreado. Este parmetro se obvia en caso de que el patrn a utilizar sea SOLID. IsVirtualObject. (Opcional) Indica si la lnea que va a crearse ser una lnea de tipo virtual (se eliminar al regenerar). Por defecto: True. ACIColor. (Opcional) Indica el color con el que va a crearse la lnea. Por defecto: 256 (por capa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin del sombreado. En caso de crear varios sombreados puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 26 de 37

Function AddHatchUserDefined(ByVal HandleObject As String, Optional ByVal PatternSpace As Double = 0.1, Optional ByVal PatternDouble As Boolean = False, Optional ByVal RotationAngle As Double = 0, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade un sombreado al dibujo actual basado en lneas. Solo disponible para usuario comercial o distribuidor. Devuelve una cadena con el handle del objeto creado. La funcin realiza el sombreado sobre los siguientes objetos: AcadPolyline, AcadLWPolyline, AcadCircle y AcadEllipse. HandleObject. Especifica el Handle de entidad del objeto que va a sombrearse. PatternSpace. Especifica la distancia entre las lneas del sombreado definido por el usuario. Por defecto: 0.1. PatternDouble. Especifica si el sombreado perpendicularmente. Valor por defecto: False. debe doblarse

RotationAngle. Especifica el ngulo de rotacin que va a usarse en el sombreado.Valor por defecto: 0. IsVirtualObject. (Opcional) Indica si la lnea que va a crearse ser una lnea de tipo virtual (se eliminar al regenerar). Por defecto: True. ACIColor. (Opcional) Indica el color con el que va a crearse la lnea. Por defecto: 256 (por capa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin del sombreado. En caso de crear varios sombreados puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 27 de 37

Function AddLine(StartPoint() As Double, EndPoint() As Double, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade una lnea al dibujo actual. Devuelve una cadena con el handle del objeto creado. Solo disponible para usuario comercial o distribuidor. StartPoint(). Matriz de 3 dobles que representa el punto inicial de la lnea. EndPoint(). Matriz de 3 dobles que representa el punto final de la lnea. IsVirtualObject. (Opcional) Indica si la lnea que va a crearse ser una lnea de tipo virtual (se eliminar al regenerar). Por defecto: True. ACIColor. (Opcional) Indica el color con el que va a crearse la lnea. Por defecto: 256 (por capa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin de la lnea. En caso de crear varias lneas en una sola operacin puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 28 de 37

Function AddMText(ByVal TextString As String, ByRef InsertPoint() As Double, ByVal AttachPoint As DwgMTextAttachementPoint, ByVal Width As Double, Optional ByVal RotationAngle As Double = 0, Optional ByVal TextHeight As Double = -1, Optional ByVal BackGroundFill As Boolean = False, Optional ByVal IsVirtualObject As Boolean = True, Optional ByVal ACIColor As Integer = 256, Optional ByVal GenerateEvent As Boolean = True, Optional ByVal ShowInDwg As Boolean = True) As String o Aade un texto multiple al dibujo actual. Devuelve una cadena con el handle del objeto creado. Solo disponible para usuario comercial o distribuidor. TextString. Cadena con el texto mltiple a aadir al dibujo. InsertPoint(). Matriz de 3 dobles que representa el punto de insercin del texto mltiple. AttachPoint. Valor del tipo DwgMTextAttachementPoint que indica el mtodo de alineacin del texto mltiple. Width. Indica el ancho (en unidades de dibujo) de la caja de texto que va a contener el texto mltiple. RotationAngle. (Opcional) Indica el ngulo de rotacin del texto mltiple. Valor por defecto: 0. TextHeight. (Opcional) Indica la altura del texto mltiple. Si se establece a -1 se toma como valor el establecido en la propiedad VirtualTextHeight. BackGroundFill. (Opcional) Indica si la caja que contiene el texto mltiple debe mostrarse pintada. Valor por defecto: False. IsVirtualObject. (Opcional) Indica si el texto mltiple creado debe ser considerado como objeto virtual. Valor por defecto: True. ACIColor. (Opcional) Indica el color que va a usarse para el texto mltiple creado. Valor por defecto: 256 (PorCapa). GenerateEvent. (Opcional) Indica si se desea que la lnea creada genere el evento EntityAddedInDwg. Por defecto: True. ShowInDwg. (Opcional) Indica si se desea que el dibujo se refresque al finalizar la operacin de creacin de la lnea. En caso de crear varios objetos en una sola operacin puede establecerse a False y luego realizar un refresco general con el mtodo Redraw(). Valor por defecto: True.

Function ClientToDwg (ByVal CtrlX As Integer, ByVal CtrlY As Integer, ByRef DwgX As Double, ByRef DwgY As Double) As Boolean o Obtiene las coordenadas X e Y del dibujo a partir de las coordenadas del control. Devuelve True o False si la operacin de conversin ha tenido xito. Si no hay dibujo activo siempre devuelve False. Almacena el resultado de la conversin en los parmetros pasados por referencia (DwgX y DwgY). CtrlX. Coordenada X del control. CtrlY. Coordenada Y del control. DwgX. Coordenada X del dibujo correspondiente a la coordenada X del control. DwgY. Coordenada Y del dibujo correspondiente a la coordenada Y del control.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 29 de 37

Function DegToRad (ByVal Degrees As Double) As Double o Convierte el valor pasado como parmetro en grados decimales a radianes. Degrees. Valor a convertir.

Function DwgToClient (ByVal DwgX As Double, ByVal DwgY As Double, ByRef CtrlX As Integer, ByRef CtrlY As Integer) As Boolean o Devuelve las coordenadas X e Y sobre la zona grfica del control a partir de las coordenadas del dibujo. Devuelve True o False si la operacin de conversin ha tenido xito. Si no hay dibujo activo siempre devuelve False. Almacena el resultado de la conversin en los parmetros pasados por referencia (CtrlX y CtrlY). DwgX. Coordenada X del dibujo. DwgY. Coordenada Y del dibujo. CtrlX. Coordenada X del control correspondiente a la coordenada X del dibujo. CtrlY. Coordenada Y del control correspondiente a la coordenada Y del dibujo.

Function GetActiveLayer() As String o Devuelve el nombre de la capa actual del dibujo abierto.

GetDist (p1() As Double, p2() As Double) As Double o Devuelve la distancia entre los dos puntos indicados en los parmetros. P1(). Matriz de ndice 1 donde el elemento 0 representa la coordenada X del punto inicial y el elemento 1 representa la coordenada Y del punto inicial. P2(). Matriz de ndice 1 donde el elemento 0 representa la coordenada X del punto final y el elemento 1 representa la coordenada Y del punto final.

Function GetAngleFromXAxis (StartPoint() As Double, EndPoint() As Double) As Double o Devuelve el ngulo sobre el eje X de la lnea formada por los dos puntos pasados como parmetros. Si no hay ningn dibujo abierto siempre devuelve 0. StartPoint(). Matriz de 3 dobles que representa el punto inicial de la lnea. EndPoint(). Matriz de 3 dobles que representa el punto final de la lnea.

Function GetCmdACIColor(ByVal IniColor As Integer) As Integer o Abre el cuadro de dilogo del control con el selector de colores. Devuelve un entero entre 1 y 255 correspondiente al color ACI seleccionado. Si se cancela devuelve el mismo valor que el parmetro IniColor. Para que se active el cuadro de dilogo del control es necesario que el valor establecido para IniColor est entre 1 y 255. IniColor. Especifica el color inicial que aparecer seleccionado en el cuadro de dilogo.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 30 de 37

Function GetDistance (ByVal p1_X As Double, ByVal p1_Y As Double, ByVal p1_Z As Double, ByVal p2_X As Double, ByVal p2_Y As Double, ByVal p2_Z As Double) As Double o Devuelve la distancia entre dos puntos representados en los parmetros. P1_X. Coordenada X del punto inicial. P1_Y. Coordenada Y del punto inicial. P1_Z. Coordenada Z del punto inicial. P2_X. Coordenada X del punto final. P2_Y. Coordenada Y del punto final. P2_Z. Coordenada Z del punto final.

Function GetPoint (ByVal Prompt As String, Optional RubberBand As Variant) As Variant o Solicita al usuario hacer clic sobre el dibujo. Devuelve una matriz de ndice 1 donde el primer elemento es la coordenada X y el segundo es la coordenada Y del dibujo donde el usuario hizo clic. Si se produce algn error o se cancela la operacin devuelve una cadena vaca. Prompt. Cadena que indica la solicitud a mostrar en el control. RubberBand. (Opcional). Si se usa ha de ser una matriz de tipo doble de ndice 1. Indica que se desea que el control muestre una lnea elstica desde el punto indicado hacia la posicin del cursor. Si se omite no se mostrar esta lnea.

Function GetInfoObject (ArrHandles() As String, Optional ByVal ShowInScreen As Boolean = True) As MTB_AcadObject() o Devuelve una matriz del tipo MTB_AcadObject con la informacin relativa a la lista de Handles de entidad de AutoCAD pasada en el primer parmetro. ArrHandles(). Matriz de tipo string donde cada elemento representa un handle de entidad sobre el que se desea obtener informacin. ShowInScreen. Booleano. Si se establece a True adems de devolver la informacin requerida, sta se muestra sobre el control en un formulario.

Function MarkObject (ByVal eHandle As String) As String o Dibuja un rectngulo alrededor de la caja de abarque de un objeto cuyo handle est establecido en el parmetro. El rectngulo generado es un objeto virtual. Devuelve el handle de la polilnea creada por el control para remarcar el objeto. eHandle. Cadena donde se indica el handle de entidad correspondiente al objeto que desea remarcar.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 31 de 37

Function OpenDWG (ByVal FileName As String) As Boolean o Abre un dibujo en el control. Devuelve True o False en funcin de si ha tenido xito o no en la operacin. Esta funcin genera valores para las propiedades DwgName y DwgPath. FileName. Representa la cadena completa del archivo DWG que va a abrirse.

Function RadToDeg (ByVal rad As Double) As Double o Convierte el valor pasado como parmetro en radianes a grados decimales. Rad. Valor a convertir.

Function SelectObjects (Optional ByVal Mode As MTB_SelectMode = -1) As Variant o Inicia el proceso de seleccin grfica sobre el control. Si la seleccin contiene objetos devuelve una matriz de tipo string donde cada elemento seleccionado representa el handle de entidad de AutoCAD. Mode. Parmetro del tipo MTB_SelectMode que indica el modo de seleccin que va a utilizarse. Si se omite el parmetro se toma como mtodo de seleccin el predefinido en la propiedad SelectMode del control.

Public Function SetColorEntityByHandle (ByVal eHandle As String, ByVal nColor As Integer) As Boolean o Actualiza el color de un objeto en el dibujo actual. Devuelve True o False si la operacin ha tenido xito. eHandle. Cadena con el identificador del objeto al que actualizar le color. nColor. Entero que indica el color con el que debe actualizarse el objeto. Los valores admitidos son de 1 a 256. (256 = PorCapa).

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 32 de 37

9 REGISTRARSE COMO USUARIO DE MTB SOFTWARE.


Para disponer de licencias de evaluacin y de acceso a los servicios de soporte tcnico de MTB Software es imprescindible registrarse como usuario. Esta operacin puede realizarse a travs de Internet. Es gratuita y no implica obligacin legal para el usuario. Al registrarse como usuario recibir un cdigo de usuario, un login y un password que le dar acceso a los distintos servicios de soporte as como los foros. Los niveles de acceso a los servicios vendrn condicionados al tipo de licencias asociadas al mismo.

10 OBTENCIN DE LICENCIAS
Este control ActiveX puede distribuirse bajo dos modos con dos niveles para cada uno. EVALUACIN Sin cdigo de validacin Puede abrir dibujos hasta un tamao mximo de 256 Kb. Puede ejecutar hasta 10 mtodos o funciones reservados al modo de explotacin. No puede ocultar la imagen promocional. Con cdigo de validacin. El cdigo puede obtenerse por Internet y es gratuito. Requiere registrarse como usuario de MTB Software. Acceso de solo lectura a los servicios de soporte tcnico y foros. Puede abrir dibujos de cualquier tamao. Puede ejecutar hasta 10 mtodos o funciones reservados al modo de explotacin. No puede ocultar la imagen promocional. EXPLOTACIN Comercial. El cdigo de validacin ha sido adquirido como usuario final a los precios de tarifa Distribuidor. El usuario mantiene un contrato de distribucin con el que puede obtener los cdigos de distribucin con descuento sobre los precios de tarifa Requiere estar registrado como usuario de MTB Software. Acceso de lectura y escritura a los servicios de soporte tcnico y foros. Puede abrir dibujos de cualquier tamao. Puede ejecutar todos los mtodos y funciones. Puede ocultar la imagen promocional.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 33 de 37

11 ACUERDO DE LICENCIA
Las soluciones de MTB Software SL se limitan al diseo del programa y proporcionan este control OLE de ordenador ActiveX (MTBCadViewer) as como la documentacin y licencia de uso. El usuario asume la responsabilidad de la opcin de usar este componente para alcanzar los resultados previstos. As como de la instalacin, del uso y de los resultados alcanzados. MTBCadViewer no es, ni ha sido, de pblico dominio o software libre. Cualquier versin de MTBCadViewer (OCX) se puede distribuir solamente con una licencia vlida de distribucin; esta licencia se obtiene sobre la base de un contrato o acuerdo con MTB Software SL. MTBCadViewer as como los archivos de soporte adicionales del control se proporciona sin garanta de ninguna clase. El riesgo completo en cuanto a los resultados producidos por este programa es asumido por el comprador / usuario. Si el programa llega a ser defectuoso, el comprador / usuario asume el coste de la licencia obtenida como mxima indemnizacin por todos los daos asociados. MTB Software no tendr ninguna responsabilidad hacia ninguna persona o compaa por el hecho de suministrar el software. AutoCAD, AutoCAD 2009, AutoCAD 2008, AutoCAD 2007, AutoCAD 2006, AutoCAD 2005, AutoCAD 2004, AutoCAD 2002, AutoLISP, DWG y DXF son marcas registradas de Autodesk Windows 98 Windows Me, Windows NT, Windows 2000, Windows XP y Windows Vista son marcas registradas de Microsoft Corporation. DwgDirectX, DwgDirect y DgnDirect son marcas registradas de Open Design Alliance MTBViewerX es marcar registrada de MTB Software SL. MTBCadViewer es marca registrada de MTB Software SL. MTBCadViewer no es, ni aspira a serlo, un programa para realizar planos y dibujos como lo hara AutoCAD u otros productos de CAD del mercado. La herramienta por excelencia para estas labores es y sigue siendo AutoCAD. No obstante s que aporta una serie de utilidades que atienden las demandas de la comunidad de programadores que necesitan trabajar con archivos DWG sin generar costes grandes adicionales en sus aplicaciones.

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 34 de 37

REDISTRIBUCIN DEL CONTROL


Para el correcto funcionamiento del control en sus aplicaciones debe distribuir los siguientes archivos: Archivo zlib.dll WinOpenGL_2.05_6.gs WinGDI_2.05_6.gs WinDirectX_2.05_6.gs WinBitmap_2.05_6.gs WhipTk.dll W3dTk.dll ViewX_2.05_6.oca ViewX_2.05_6.dll RxRasterServices_2.05_6.drx Ubicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin Requiere registro No No No No No No No No Si No No No No No No Si No No Si No

RecomputeDimBlock_2.05_6.drx CommonFiles o aplicacin RasterProcessor_2.05_6.drx PlotStyleServices_2.05_6.drx CommonFiles o aplicacin CommonFiles o aplicacin

PlotSettingsValidator_2.05_6.drx CommonFiles o aplicacin PDFToolkit_2.05_6.dll OdSmX_2.05_7.dll OdOleItemHandler_2.05_6.drx OdBagFiler_2.05_6.drx OdaX_2.05_6.dll ModelerGeometry_2.05_6.drx CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 35 de 37

Archivo GripPoints_2.05_6.drx ExFieldEvaluator_2.05_6.drx DWGdirectX_2.05_6.oca DwfToolkit.dll DwfCore.dll SvgExport_2.05_6.drx DD_SpatialIndex_2.05_6.dll DD_Sm_2.05_6.drx DD_Root_2.05_6.dll DD_Reg_2.05_6.dll DD_PdfExport_2.05_6.dll DD_Gs_2.05_6.dll DD_Gi_2.05_6.dll DD_Ge_2.05_6.dll DD_DynBlocks_2.05_6.drx DD_Dwf7Import_2.05_6.drx DD_Dwf7Export_2.05_6.dll DD_DbRoot_2.05_6.dll DD_Db_2.05_6.dll DD_BrepRenderer_2.05_6.dll DD_Br_2.05_6.dll DD_BmpExport_2.05_6.dll

Ubicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin

Requiere registro No No No No No No No No No No No No No No No No No No No No No No

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 36 de 37

Archivo DD_Alloc_2.05_6.dll DD_AcisBuilder_2.05_6.dll DbCommands_2.05_6.drx MSPRPES.DLL MSSTKPRP.DLL FLXGDES.DLL MSFLXGRD.OCX MSFLXGRD.DEP MSFLXGRD.OCA CMDLGES.DLL COMDLG32.OCX COMDLG32.DLL COMDLG32.OCA COMDLG32.DEP MSCMCES.DLL MSCOMCTL.OCX MSCOMCTL.DEP MSCOMCTL.OCA MSCOMCTL.SRG DWGdirectX_2.05_6.dll MTBCadViewer.ocx

Ubicacin CommonFiles o aplicacin CommonFiles o aplicacin CommonFiles o aplicacin Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema Sistema CommonFiles o aplicacin Aplicacin

Requiere registro No No No No Si No Si No No No Si No No No No Si No No No Si Si No

Archivos con extensin SHX y Aplicacin PC3 (Soporte a dibujos)

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

SISTEMAS DE INFORMACIN MTBCadViewer.ocx Manual del control y API de programacin

Fecha Autor Pgina

: : :

21/05/2008 MTB 37 de 37

Mayo 2007 Copyright MTB Software S.L. N.I.F. B-25626367

Você também pode gostar