TTfvsDBClientFrameMasterClases - Historial de revisiones

Luciano Carou en 14:13 3 jun 2025

2025-06-03T14:13:25Z

← Revisión anterior		Revisión del 16:13 3 jun 2025
Línea 3:		Línea 3:

	Según lo documentado en [[DEV ETIQUETAS/FRAME EDICION]] este frame correspondería a la '''instancia 2'''.		Según lo documentado en [[DEV ETIQUETAS/FRAME EDICION]] este frame correspondería a la '''instancia 2'''.

			=[[QUEESESTO/IDENTIDAD\|Identidad]]=
			[[Category:MANUAL/PROGRAMADOR]]
			[[Category:CONTROLES/FRAMES]]
			*Ancestro: [[TTfvsDBClientFrame]]
			*Carpeta: C:\DevelopPrx\frames
			*Archivo: fvsDBClientFrameMasterClases.pas

	===Imagen del frame en diseño===		===Imagen del frame en diseño===
Línea 232:		Línea 239:
	Retorna el frame que contiene al dataset dentro de las pestañas del PageControl. Usa la propiedad ActivePageIndex del PageControlpara saber qué pestaña activa y luego dentro de sus componentes busca uno que sea de tipo [[TTfvsDBClientFrameGridClases]] (ya que los detalles normalmente se presentan en una grilla).		Retorna el frame que contiene al dataset dentro de las pestañas del PageControl. Usa la propiedad ActivePageIndex del PageControlpara saber qué pestaña activa y luego dentro de sus componentes busca uno que sea de tipo [[TTfvsDBClientFrameGridClases]] (ya que los detalles normalmente se presentan en una grilla).

	=~~[[QUEESESTO/IDENTIDAD\|Identidad]]~~=		=Uso=
	[[~~Category~~:~~MANUAL/PROGRAMADOR]]~~		Este frame es usado por todas las clases definidas en [[:Category:DEV CLASES\|Clases]].
	[[Category:~~CONTROLES/FRAMES~~]]
	*Ancestro: [[TTfvsDBClientFrame]]
	*Carpeta: C:\DevelopPrx\frames
	*Archivo: fvsDBClientFrameMasterClases.~~pas~~

Luciano Carou: /* Implementación */

2025-06-03T14:12:04Z

Implementación

← Revisión anterior		Revisión del 16:12 3 jun 2025
Línea 188:		Línea 188:

	Si algún campo usa el panel '''tab_last''' entonces lo agrega al PageControl.		Si algún campo usa el panel '''tab_last''' entonces lo agrega al PageControl.

			Si algún campo usa el panel de comentarios entonces lo hace visible.

			Si algún campo usa el panel de totales entonces lo hace visible.

			Este procedimiento se asiste con:
			*procedure ClassShow_BuildFrame_ArmaTab_Especial(aTabName: String) arma las pestañas en el PageControl.
			*procedure ClassShow_BuildFrame_PanelesAlPie(aPanelName: String; aScrollBox: TprxScrollBox) arma los paneles al pie.

			===procedure OnExecute_INSERT_Master(Sender: TObject)===
			Recibe el OnClick de inserción del master, si el panel de la cabecera es de tipo [[TTfvsDBClientFrame]] ejecuta su función OnExecute_INSERT.

			===procedure OnExecute_EDIT_Master(Sender: TObject)===
			Recibe el OnClick de edición del master:
			*Si el panel de la cabecera es de tipo [[TTfvsDBClientFrameCmpCabecera]] ejecuta su función OnExecute_EDIT, este panel identifica a un comprobante.
			*Si es de tipo [[TTfvsDBClientFrame]] ejecuta su función OnExecute_EDIT, este panel identifica a clases distintas a comprobantes.

			===procedure OnExecute_POST_Master(Sender: TObject)===
			Cuando el panel de la cabecera (PanelCABECERA_ClassShow_Frame) es de tipo:
			*[[TTfvsDBClientFrameCmpCabecera]] (es un comprobante) ejecuta su función OnExecute_POST.
			*[[TTfvsDBClientFrame]] (no es un comprobante) ejecuta su función OnExecute_POST.

			Luego llama al '''DataSet.PostXtd''' para guardar los cambios al dataset y solo si se trata del master llama a '''UpdateBatchXtd''' para guardar la transacción.

			===procedure OnExecute_CANCEL_Master(Sender: TObject)===
			Cancela la operación corriente (inserción o edición), si el panel es de tipo [[TTfvsDBClientFrame]] llama a su función OnExecute_CANCEL.

			===procedure OnExecute_DELETE_Master(Sender: TObject)===
			Intenta eliminar el registro según el tipo de panel superior:
			*Si es [[TTfvsDBClientFrameCmpCabecera]] llama a su función OnExecute_DELETE.
			*Si es [[TTfvsDBClientFrame]] llama a su función OnExecute_DELETE.

			===procedure OnExecute_INSERT_Detail(Sender: TObject)===
			Recibe el OnClick para insertar un detalle, llama al OnExecute_INSERT del frame que lo contiene.

			===procedure OnExecute_EDIT_Detail(Sender: TObject)===
			Recibe el OnClick para editar un detalle, llama al OnExecute_EDIT del frame que lo contiene.

			===procedure OnExecute_POST_Detail(Sender: TObject)===
			Recibe el OnClick para eliminar un detalle, llama al OnExecute_DELETE del frame que lo contiene.

			===function OnExecute_Detail_Select_Frame(var aFrame: TTfvsDBClientFrame): Boolean===
			Retorna el frame que contiene al dataset dentro de las pestañas del PageControl. Usa la propiedad ActivePageIndex del PageControlpara saber qué pestaña activa y luego dentro de sus componentes busca uno que sea de tipo [[TTfvsDBClientFrameGridClases]] (ya que los detalles normalmente se presentan en una grilla).

	=[[QUEESESTO/IDENTIDAD\|Identidad]]=		=[[QUEESESTO/IDENTIDAD\|Identidad]]=

Luciano Carou: /* Implementación */

2025-06-03T13:22:04Z

Implementación

@@ Línea 138: / Línea 138: @@
 =Implementación=
 ===procedure ClassShow_BuildFrame(Sender: TObject)===
 =[[QUEESESTO/IDENTIDAD|Identidad]]=

Luciano Carou: /* Imagen del frame en diseño */

2025-06-03T13:17:55Z

Imagen del frame en diseño

← Revisión anterior		Revisión del 15:17 3 jun 2025
Línea 10:		Línea 10:
	Sus partes son:		Sus partes son:
	*'''Panel superior''': normalmente usado con controles de edición en formato de ficha, puede tener hasta dos paneles (el izquierdo y el derecho).		*'''Panel superior''': normalmente usado con controles de edición en formato de ficha, puede tener hasta dos paneles (el izquierdo y el derecho).
	*'''Área para detalles''': se crean las pestañas para los detalles de la clase master (si los hubiere).		*'''Área para detalles''': se crean las pestañas para los detalles de la clase master (si los hubiere), el control en este panel es un [https://docwiki.embarcadero.com/Libraries/Alexandria/en/Vcl.ComCtrls.TPageControl TPageControl] que permite agregar esas pestañas.
	*'''Panel de comentarios''': normalmente contiene el control de edición de comentarios, pero puede tener otros controles de edición.		*'''Panel de comentarios''': normalmente contiene el control de edición de comentarios, pero puede tener otros controles de edición.
	*'''Panel de totales''': normalmente muestra los totales del comprobante.		*'''Panel de totales''': normalmente muestra los totales del comprobante.

Luciano Carou: /* Implementación */

2025-06-03T13:14:25Z

Implementación

← Revisión anterior		Revisión del 15:14 3 jun 2025
Línea 137:		Línea 137:

	=Implementación=		=Implementación=
			===procedure ClassShow_BuildFrame(Sender: TObject)===

	=[[QUEESESTO/IDENTIDAD\|Identidad]]=		=[[QUEESESTO/IDENTIDAD\|Identidad]]=

Luciano Carou: /* Imagen del frame en runtime */

2025-06-03T12:57:10Z

Imagen del frame en runtime

← Revisión anterior		Revisión del 14:57 3 jun 2025
Línea 29:		Línea 29:
	*'''Panel de comentarios''': agrega dos controles de edición al estándar de comentarios.		*'''Panel de comentarios''': agrega dos controles de edición al estándar de comentarios.
	*'''Panel de totales''': muestra los totales del comprobante.		*'''Panel de totales''': muestra los totales del comprobante.

			[[DEV CLASES/CAMPOS#Panel\|Panel]] desarrolla este tema.

	===Ubicación de los campos en el frame===		===Ubicación de los campos en el frame===

Luciano Carou: /* Imagen del frame en runtime */

2025-06-03T12:56:00Z

Imagen del frame en runtime

← Revisión anterior		Revisión del 14:56 3 jun 2025
Línea 23:		Línea 23:

	Sus partes son (notar que el panel superior se abre en dos, el izquierdo y el derecho):		Sus partes son (notar que el panel superior se abre en dos, el izquierdo y el derecho):
	*'''Panel superior, izquierda''': los comprobantes ~~del sistema tienen casi los mismos datos en este panel~~, pueden variar según si el comprobante valoriza o no o como en este caso agrega el campo '''Factura Crédito''' ~~pero son todos muy parecidos~~.		*'''Panel superior, izquierda''': este panel es muy parecido para todos los comprobantes, pueden variar según si el comprobante valoriza o no o como en este caso agrega el campo '''Factura Crédito'''.
	*'''Panel superior, derecha''': contiene los datos del proveedor y de la factura presentada		*'''Panel superior, derecha''': contiene los datos del proveedor y de la factura presentada
	*'''Detalle de artículos''': contiene una grilla (instancia 1) del detalle de la factura, desde aquí se accede a la instancia 2 de esa misma tabla.		*'''Detalle de artículos''': contiene una grilla (instancia 1) del detalle de la factura, desde aquí se accede a la instancia 2 de esa misma tabla.

Luciano Carou: /* Ubicación de los campos en el frame */

2025-06-03T12:54:23Z

Ubicación de los campos en el frame

← Revisión anterior		Revisión del 14:54 3 jun 2025
Línea 34:		Línea 34:

	[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]		[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]
	El campo FCUENTA se ubica en panel '''main''' pero como tiene el comando ~~<pre><BR></pre>~~ se muestra en el panel a derecha.		El campo FCUENTA se ubica en panel '''main''' pero como tiene el comando '''BREAK''' se muestra en el panel a derecha.

	[[Archivo:20250603 0951 CAMPO FRECUPEROIVA.png\|miniaturadeimagen\|no\|Campo FRECUPEROIVA en el panel comentarios.]]		[[Archivo:20250603 0951 CAMPO FRECUPEROIVA.png\|miniaturadeimagen\|no\|Campo FRECUPEROIVA en el panel comentarios.]]

Luciano Carou: /* Ubicación de los campos en el frame */

2025-06-03T12:53:58Z

Ubicación de los campos en el frame

← Revisión anterior		Revisión del 14:53 3 jun 2025
Línea 32:		Línea 32:
	===Ubicación de los campos en el frame===		===Ubicación de los campos en el frame===
	En [[DEV CLASES/CAMPOS#Panel\|Panel]] se describe cómo hacer para ubicar un campo en algún panel en particular.		En [[DEV CLASES/CAMPOS#Panel\|Panel]] se describe cómo hacer para ubicar un campo en algún panel en particular.

	[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]		[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]
			El campo FCUENTA se ubica en panel '''main''' pero como tiene el comando <pre><BR></pre> se muestra en el panel a derecha.

	El campo ~~FCUENTA~~ se ubica en panel '''~~main~~''' ~~pero como tiene el comando <pre><BR></pre> se muestra en el panel a derecha~~.		[[Archivo:20250603 0951 CAMPO FRECUPEROIVA.png\|miniaturadeimagen\|no\|Campo FRECUPEROIVA en el panel comentarios.]]
			El campo FRECUPEROIVA se ubica en panel '''comentarios'''.

	=Declaración=		=Declaración=

Luciano Carou: /* Ubicación de los campos en el frame */

2025-06-03T12:48:53Z

Ubicación de los campos en el frame

← Revisión anterior		Revisión del 14:48 3 jun 2025
Línea 31:		Línea 31:

	===Ubicación de los campos en el frame===		===Ubicación de los campos en el frame===
	~~Cuando definimos los campos de una clase podemos definir~~ en ~~qué parte del frame se muestran:~~		En [[DEV CLASES/CAMPOS#Panel\|Panel]] se describe cómo hacer para ubicar un campo en algún panel en particular.
	[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]		[[Archivo:20250603 0933 CAMPO FCUENTA.png\|miniaturadeimagen\|no\|Campo FCUENTA en panel '''main'''.]]

	*'''~~Grupo~~'''~~: cuando indicamos un texto para el grupo el sistema va a imprimir ese texto~~ como ~~título justo antes del campo (notar en la imagen de runtime). Este caso en particular~~ tiene ~~una etiqueta '''~~<BR>~~''' antes del título, eso indica '''BREAK''' y hace que el campo~~ se ~~inicie~~ en el panel ~~izquierdo.~~		El campo FCUENTA se ubica en panel '''main''' pero como tiene el comando <pre><BR></pre> se muestra en el panel a derecha.
	*'''Panel''': indica en qué panel debe dibujarse el campo, ver [[DEV CLASES/CAMPOS#Panel]].

	~~Por ejemplo, el campo FCUENTA:~~
	*

	=Declaración=		=Declaración=