Usina BRGuía AdvPL
Ingresar
← Todos los temas
CLASEPublicado

BrGetDDB

BrGetDDB():New( <nTop>, <nLeft>, <nBottom>, <nRight>, ... ) --> oBrowse

Crea una grilla/browse de datos con registros en filas e información en columnas.

Interfaz visualBrowseGrillaDatosClase
01 · DESCRIPCIÓN GENERAL

Descripción general

BrGetDDB crea un objeto visual de tipo grilla para mostrar registros de un área de datos en filas y columnas. En el ejemplo oficial, la rutina abre SA1, crea el browse dentro de un diálogo, agrega columnas con TCColumn y utiliza bloques de código para personalizar acciones como edición y eliminación.

02 · SINTAXIS

Sintaxis

BrGetDDB():New( <nTop>, <nLeft>, <nBottom>, <nRight>, ... ) --> oBrowse

Parámetros

nTop
NuméricoObligatorio

Coordenada superior del browse dentro del contenedor.

nLeft
NuméricoObligatorio

Coordenada izquierda del browse dentro del contenedor.

nBottom
NuméricoObligatorio

Coordenada inferior del browse.

nRight
NuméricoObligatorio

Coordenada derecha del browse.

oWnd
ObjetoOpcional

Ventana o diálogo donde se crea el componente.

cAlias
CaractereOpcional

Alias usado por el browse, como SA1 en el ejemplo.

Métodos

NewCria o componente visual de grade dentro de uma janela ou diálogo.BrGetDDB():New( <nTop>, <nLeft>, <nBottom>, <nRight>, ... ) --> oBrowse
Parámetros
NombreFormatoObligatorioDescripciónObservación
nTopNuméricoObligatorio

Posição superior do componente.

nLeftNuméricoObligatorio

Posição esquerda do componente.

nBottomNuméricoObligatorio

Posição inferior do componente.

nRightNuméricoObligatorio

Posição direita do componente.

oWndObjetoOpcional

Container visual, normalmente um diálogo.

cAliasCaractereOpcional

Alias da tabela/área de trabalho a exibir.

Retorno

oBrowse: objeto browse criado.

AddColumnAdiciona uma coluna ao browse usando um objeto TCColumn.oBrowse:AddColumn( TCColumn():New( <cTitle>, <bData>, ... ) ) -->
Parámetros
NombreFormatoObligatorioDescripciónObservación
cTitleCaractereObligatorio

Título exibido no cabeçalho da coluna.

bDataBloco de códigoObligatorio

Bloco que retorna o valor da célula, como { || SA1->A1_COD }.

03 · EJEMPLO PRÁCTICO

Browse de clientes en un diálogo

#Include "TOTVS.ch"

User Function BrGetDDB()
    Local oDlg
    Local oBrowse

    DEFINE DIALOG oDlg TITLE "Exemplo BrGetDDB" ;
        FROM 180, 180 TO 550, 700 PIXEL

    DbSelectArea("SA1")

    oBrowse := BrGetDDB():New( ;
        1, 1, 260, 184, , , , oDlg, , , , , , , , , , , , ;
        .F., "SA1", .T., , .F., , , )

    oBrowse:bCustomEditCol := {|x, y, z| U_EditLine(x, y, z)}
    oBrowse:bDelete        := {|| ConOut("bDelete")}

    oBrowse:AddColumn(TCColumn():New("Código", {|| SA1->A1_COD}, , , , "LEFT", , .F., .F., , , , .F.))
    oBrowse:AddColumn(TCColumn():New("Loja",   {|| SA1->A1_LOJA}, , , , "LEFT", , .F., .F., , , , .F.))
    oBrowse:AddColumn(TCColumn():New("Nome",   {|| SA1->A1_NOME}, , , , "LEFT", , .F., .F., , , , .F.))

    ACTIVATE DIALOG oDlg CENTERED
Return

User Function EditLine(x, y, z)
    ApMsgStop("editLine")
Return .T.
Resultado esperado

Crea un diálogo con una grilla basada en el alias SA1 y tres columnas: Código, Tienda y Nombre.

BUENAS PRÁCTICAS
  • Antes de crear el browse, selecciona el área de datos con DbSelectArea() o asegúrate de que el alias esté abierto.
  • Usa TCColumn para declarar qué campos o expresiones se mostrarán como columnas.
  • Callbacks como bCustomEditCol y bDelete permiten personalizar el comportamiento.
ERRORES COMUNES
  • Las coordenadas y dimensiones dependen del contenedor visual y del uso de PIXEL en el diálogo.
  • Si el alias no está abierto o correctamente posicionado, la grilla no mostrará los datos esperados.
  • Por ser un componente visual legado/específico, valida el comportamiento en el SmartClient y release utilizados.

Contenido relacionado

REFERENCIAS
  1. TOTVS. BrGetDDb. TOTVSTEC / TDN. Crea un objeto de tipo grilla con registros en filas e información en columnas.
Estado
Publicado
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha