nRow, nColNuméricoObligatorio
Fila y columna donde se coloca el componente. Con PIXEL, las coordenadas parten de la esquina superior izquierda del componente padre.
COMANDOPublicado
@ ... BITMAP
@ <nRow>, <nCol> BITMAP [<oBmp>] [RESOURCE <cResName> | FILE <cFileName>] [SIZE <nWidth>, <nHeight>] [OF <oWnd>] [PIXEL]Muestra una imagen en una interfaz AdvPL desde un recurso del repositorio o un archivo de disco.
Descripción general
El comando @ ... BITMAP crea un componente visual para mostrar imágenes en diálogos, paneles y otros contenedores. Durante la compilación se traduce al constructor New() de la clase TBitmap. La imagen puede proceder de un recurso almacenado en el repositorio de objetos o de un archivo resuelto desde el RootPath del entorno.
Sintaxis
@ <nRow>, <nCol> BITMAP [<oBmp>] [RESOURCE <cResName> | FILE <cFileName>] [SIZE <nWidth>, <nHeight>] [OF <oWnd>] [PIXEL]Parámetros
oBmpObjetoOpcional
Variable que recibe el objeto TBitmap, necesaria para usar propiedades o métodos después de crearlo.
RESOURCE cResNameCaractereOpcional
Nombre de una imagen guardada como recurso en el repositorio de objetos. También admite NAME y RESNAME.
FILE cFileNameCaractereOpcional
Nombre del archivo de disco resuelto desde el RootPath del entorno. También admite FILENAME y DISK.
SIZE nWidth, nHeightNuméricoOpcional
Ancho y alto reservados para el componente.
OF oWndObjetoOpcional
Diálogo, panel, folder u otro contenedor visual propietario del bitmap. OF es la forma recomendada por la documentación oficial.
ON CLICK / ON RIGHT CLICKExpressãoOpcional
Función literal ejecutada con clic izquierdo o derecho. La sintaxis documentada no admite un CodeBlock aquí.
NOBORDER · SCROLL · ADJUST · CURSOR · PIXEL · WHEN · VALIDCláusulasOpcional
Controlan borde, barras, ajuste, cursor, coordenadas, habilitación y validación del componente.
Imagen cargada desde un archivo
#Include "TOTVS.ch"
User Function ExBitmap()
Local oDlg
Local oBmp
Local cArchivo := "\system\imagen.png"
Define Dialog oDlg Title "Ejemplo de imagen" ;
From 180, 180 To 550, 700 Pixel
@ 10, 10 Bitmap oBmp File (cArchivo) ;
Size 120, 80 Of oDlg Pixel NOBORDER
Activate Dialog oDlg Centered
ReturnResultado esperado
El archivo se lee desde RootPath, se muestra sin borde y el objeto queda disponible en oBmp.
Imagen del repositorio con clic
#Include "TOTVS.ch"
User Function ExBitmapRecurso()
Local oDlg
Local oBmp
Define Dialog oDlg Title "Atalho visual" ;
From 0, 0 To 180, 360 Pixel
@ 15, 20 Bitmap oBmp Resource "LOGO_EMPRESA" ;
Size 120, 60 Of oDlg Pixel Adjust ;
On Click AbrirCadastro()
Activate Dialog oDlg Centered
Return
Static Function AbrirCadastro()
MsgInfo("Imagem selecionada")
ReturnResultado esperado
El recurso se ajusta al área definida y llama a una función literal al recibir un clic izquierdo.
- Incluye TOTVS.ch para que el compilador reconozca el comando.
- Prefiere OF para identificar explícitamente el contenedor propietario.
- Conserva oBmp cuando necesites Load() o propiedades de la clase después de la creación.
- SCROLL habilita barras cuando la imagen supera el área.
- ADJUST estira la imagen y puede distorsionarla si las proporciones difieren.
- Consulta TBitmap para confirmar formatos y propiedades adicionales como transparencia.
- FILE se resuelve desde RootPath; verifica la ubicación y disponibilidad en el entorno de ejecución.
- Mezclar coordenadas PIXEL con otra unidad puede colocar o dimensionar mal el componente.
- ADJUST puede deformar la imagen; conserva su proporción cuando sea importante.
- Sin OF, el componente se crea en la ventana o diálogo activo y puede asociarse inesperadamente.
- En ON CLICK y ON RIGHT CLICK, proporciona una función literal según la documentación, no un bloque de código.