DataGrid Objects - Revision history

Marie.o: beautification

2010-05-17T21:06:22Z

beautification

←Older revision		Revision as of 21:06, 17 May 2010
Line 7:		Line 7:
	Additionally in the Data Grid generator you can attach attributes to each cell, which are a pair of strings, such as color=blue, size=l, etc. In Designer you can specify as parameters for the datagrid PK_DesignObj_Row1, PK_DesignObj_Coll1 and PK_DesignObj_Cell. In this case those objects will be used in place of the normally rendered cells; the objects are positioned in Designer in a grid for the rows and columns, and are automatically hidden when there is no corresponding cell.		Additionally in the Data Grid generator you can attach attributes to each cell, which are a pair of strings, such as color=blue, size=l, etc. In Designer you can specify as parameters for the datagrid PK_DesignObj_Row1, PK_DesignObj_Coll1 and PK_DesignObj_Cell. In this case those objects will be used in place of the normally rendered cells; the objects are positioned in Designer in a grid for the rows and columns, and are automatically hidden when there is no corresponding cell.

	Example for Add Software grid:		== Example for Add Software grid ==

	We have a grid that lists software modules the user can install. Each row needs to list the title of the module, show an icon for the software, and display a check box if it's virus free.		We have a grid that lists software modules the user can install. Each row needs to list the title of the module, show an icon for the software, and display a check box if it's virus free.

	We create an object in Designer for the cells in the grid, and on it place a text object with "<%=CA:Title%>". This means the text will contain the cell's attribute "Title". Create a blank bitmap object with no graphic to represent the icon, and another which contains a check box for 'virus free'.		We create an object in Designer for the cells in the grid, and on it place a text object with "<%=CA:Title%>". This means the text will contain the cell's attribute "Title".
			* Create a blank bitmap object with no graphic to represent the icon, and another which contains a check box for 'virus free'.
	Create a new DataGrid in Designer and place on it all 3 of those objects, marking the 'virus free' one as 'can hide', meaning it won't always be visible.		* Create a new DataGrid in Designer and place on it all 3 of those objects, marking the 'virus free' one as 'can hide', meaning it won't always be visible.
			* Create a data grid generator (in this case in general info plugin) and register it as follows:
	Create a data grid generator (in this case in general info plugin) and register it as follows:		bool General_Info_Plugin::Register() {
			...
	bool General_Info_Plugin::Register() {
	...
	m_pDatagrid_Plugin->RegisterDatagridGenerator(		m_pDatagrid_Plugin->RegisterDatagridGenerator(
	new DataGridGeneratorCallBack(this, (DCEDataGridGeneratorFn) (&General_Info_Plugin::AddSoftware)),		new DataGridGeneratorCallBack(this, (DCEDataGridGeneratorFn) (&General_Info_Plugin::AddSoftware)),
Line 25:		Line 22:
	in the generator code we retrieve the software modules from the database and create a cell for each with the correct attributes:		in the generator code we retrieve the software modules from the database and create a cell for each with the correct attributes:

	class DataGridTable General_Info_Plugin::AddSoftware( string GridID, string Parms, void ExtraData, int *iPK_Variable, string		class DataGridTable General_Info_Plugin::AddSoftware( string GridID, string Parms, void ExtraData, int *iPK_Variable, string
	sValue_To_Assign, class Message pMessage ) {		sValue_To_Assign, class Message pMessage ) {
	DataGridTable *pDataGrid = new DataGridTable();		DataGridTable *pDataGrid = new DataGridTable();
	DataGridCell *pCell;		DataGridCell *pCell;

	string sql="SELECT PK_Software, Iconstr, Title, Category, Rating, Virus_Free, Installation_status, Description, Homeurl		string sql="SELECT PK_Software, Iconstr, Title, Category, Rating, Virus_Free, Installation_status, Description, Homeurl
	FROM Software WHERE FK_Device="+sPK_Device_PC+" ORDER BY Title";		FROM Software WHERE FK_Device="+sPK_Device_PC+" ORDER BY Title";

	int iRow=0;		int iRow=0;
	if( (result.r = m_pDatabase_pluto_main->mysql_query_result(sql)) )		if( (result.r = m_pDatabase_pluto_main->mysql_query_result(sql)) )

Rwilson131 at 02:19, 6 September 2007

2007-09-06T02:19:26Z

←Older revision		Revision as of 02:19, 6 September 2007
Line 144:		Line 144:
	return false; // Keep processing it		return false; // Keep processing it
	}		}
			[[Category: Programmer's Guide]]

Jerry finn at 16:13, 16 March 2007

2007-03-16T16:13:07Z

←Older revision		Revision as of 16:13, 16 March 2007
Line 1:		Line 1:
	<table width="100%"> <tr><td bgcolor="#FFCFCF">This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.</td></tr> </table>Data grids are objects shown on the Orbiters which have dynamically changing data in the rows and columns, which data is specified in code. To create a DataGrid you must add a new DataGrid to the DataGrid table in pluto_main, and create a function, usually in a plugin, which builds the rows and columns of data. Upon startup call the function RegisterDatagridGenerator in the DataGrid plugin to specify the function that provides the data for the data grid. In Designer create a data grid object on a screen and specify the data grid id and the parameters to be passed to the data grid generator in the DesignObjParameter 'options'.		Data grids are objects shown on the Orbiters which have dynamically changing data in the rows and columns, which data is specified in code. To create a DataGrid you must add a new DataGrid to the DataGrid table in pluto_main, and create a function, usually in a plugin, which builds the rows and columns of data. Upon startup call the function RegisterDatagridGenerator in the DataGrid plugin to specify the function that provides the data for the data grid. In Designer create a data grid object on a screen and specify the data grid id and the parameters to be passed to the data grid generator in the DesignObjParameter 'options'.

	In the Data Grid Generator create cells in rows and columns, and attach to each cell a 'value' and optionally 'text'. When the screen with a DataGrid first appears Orbiter will fire the command "Populate DataGrid" which will result in the DataGrid Generator getting called to populate the entire contents of the grid, and then every time it needs to render a block of rows/columns it sends the command "Request DataGrid Contents".		In the Data Grid Generator create cells in rows and columns, and attach to each cell a 'value' and optionally 'text'. When the screen with a DataGrid first appears Orbiter will fire the command "Populate DataGrid" which will result in the DataGrid Generator getting called to populate the entire contents of the grid, and then every time it needs to render a block of rows/columns it sends the command "Request DataGrid Contents".

Wikiadmin: spelling corrections

2006-12-10T15:01:09Z

spelling corrections

←Older revision		Revision as of 15:01, 10 December 2006
Line 1:		Line 1:
	<table width="100%"> <tr><td bgcolor="#FFCFCF">This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.</td></tr> </table>Data grids are objects shown on the Orbiters which have dynamically changing data in the rows and columns, which data is specified in code. To create a ~~datagrid~~ you must add a new DataGrid to the DataGrid table in pluto_main, and create a function, usually in a plugin, which builds the rows and columns of data. Upon startup call the function RegisterDatagridGenerator in the DataGrid plugin to specify the function that provides the data for the data grid. In Designer create a data grid object on a screen and specify the data grid id and the parameters to be passed to the data grid generator in the DesignObjParameter 'options'.		<table width="100%"> <tr><td bgcolor="#FFCFCF">This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.</td></tr> </table>Data grids are objects shown on the Orbiters which have dynamically changing data in the rows and columns, which data is specified in code. To create a DataGrid you must add a new DataGrid to the DataGrid table in pluto_main, and create a function, usually in a plugin, which builds the rows and columns of data. Upon startup call the function RegisterDatagridGenerator in the DataGrid plugin to specify the function that provides the data for the data grid. In Designer create a data grid object on a screen and specify the data grid id and the parameters to be passed to the data grid generator in the DesignObjParameter 'options'.

	In the Data Grid Generator create cells in rows and columns, and attach to each cell a 'value' and optionally 'text'. When the screen with a ~~datagrid~~ first appears Orbiter will fire the command "Populate ~~Datagrid~~" which will result in the ~~Datagrid~~ Generator getting called to populate the entire contents of the grid, and then every time it needs to render a block of rows/columns it sends the command "Request ~~Datagrid~~ Contents".		In the Data Grid Generator create cells in rows and columns, and attach to each cell a 'value' and optionally 'text'. When the screen with a DataGrid first appears Orbiter will fire the command "Populate DataGrid" which will result in the DataGrid Generator getting called to populate the entire contents of the grid, and then every time it needs to render a block of rows/columns it sends the command "Request DataGrid Contents".

	When a cell in the ~~datagrid~~ is selected orbiter will store the 'value' for the cell into the variable specified in the parameter for the ~~datagrid~~, and Orbiter will fire all the commands in the "On Activate" list. You can also use ScreenHandler's RegisterCallBack method to create a function that is called whenever a cell is selected (use the type cbDataGridSelected).		When a cell in the DataGrid is selected orbiter will store the 'value' for the cell into the variable specified in the parameter for the DataGrid, and Orbiter will fire all the commands in the "On Activate" list. You can also use ScreenHandler's RegisterCallBack method to create a function that is called whenever a cell is selected (use the type cbDataGridSelected).

	Additionally in the Data Grid generator you can attach attributes to each cell, which are a pair of strings, such as color=blue, size=l, etc. In Designer you can specify as parameters for the datagrid PK_DesignObj_Row1, PK_DesignObj_Coll1 and PK_DesignObj_Cell. In this case those objects will be used in place of the normally rendered cells; the objects are positioned in Designer in a grid for the rows and columns, and are automatically hidden when there is no corresponding cell.		Additionally in the Data Grid generator you can attach attributes to each cell, which are a pair of strings, such as color=blue, size=l, etc. In Designer you can specify as parameters for the datagrid PK_DesignObj_Row1, PK_DesignObj_Coll1 and PK_DesignObj_Cell. In this case those objects will be used in place of the normally rendered cells; the objects are positioned in Designer in a grid for the rows and columns, and are automatically hidden when there is no corresponding cell.
Line 13:		Line 13:
	We create an object in Designer for the cells in the grid, and on it place a text object with "<%=CA:Title%>". This means the text will contain the cell's attribute "Title". Create a blank bitmap object with no graphic to represent the icon, and another which contains a check box for 'virus free'.		We create an object in Designer for the cells in the grid, and on it place a text object with "<%=CA:Title%>". This means the text will contain the cell's attribute "Title". Create a blank bitmap object with no graphic to represent the icon, and another which contains a check box for 'virus free'.

	Create a new ~~datagrid~~ in Designer and place on it all 3 of those objects, marking the 'virus free' one as 'can hide', meaning it won't always be visible.		Create a new DataGrid in Designer and place on it all 3 of those objects, marking the 'virus free' one as 'can hide', meaning it won't always be visible.

	Create a data grid generator (in this case in general info plugin) and register it as follows:		Create a data grid generator (in this case in general info plugin) and register it as follows:

Wikiadmin: Changed identation

2006-10-30T10:50:17Z

Changed identation

Show changes

Wikiadmin at 05:06, 30 October 2006

2006-10-30T05:06:01Z

New page

<table width="100%"> <tr><td bgcolor="#FFCFCF">This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007. In general any information should apply to LinuxMCE. However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.</td></tr> </table>Data grids are objects shown on the Orbiters which have dynamically changing data in the rows and columns, which data is specified in code. To create a datagrid you must add a new DataGrid to the DataGrid table in pluto_main, and create a function, usually in a plugin, which builds the rows and columns of data. Upon startup call the function RegisterDatagridGenerator in the DataGrid plugin to specify the function that provides the data for the data grid. In Designer create a data grid object on a screen and specify the data grid id and the parameters to be passed to the data grid generator in the DesignObjParameter 'options'.

In the Data Grid Generator create cells in rows and columns, and attach to each cell a 'value' and optionally 'text'. When the screen with a datagrid first appears Orbiter will fire the command "Populate Datagrid" which will result in the Datagrid Generator getting called to populate the entire contents of the grid, and then every time it needs to render a block of rows/columns it sends the command "Request Datagrid Contents".

When a cell in the datagrid is selected orbiter will store the 'value' for the cell into the variable specified in the parameter for the datagrid, and Orbiter will fire all the commands in the "On Activate" list. You can also use ScreenHandler's RegisterCallBack method to create a function that is called whenever a cell is selected (use the type cbDataGridSelected).

Additionally in the Data Grid generator you can attach attributes to each cell, which are a pair of strings, such as color=blue, size=l, etc. In Designer you can specify as parameters for the datagrid PK_DesignObj_Row1, PK_DesignObj_Coll1 and PK_DesignObj_Cell. In this case those objects will be used in place of the normally rendered cells; the objects are positioned in Designer in a grid for the rows and columns, and are automatically hidden when there is no corresponding cell.

Example for Add Software grid:

We have a grid that lists software modules the user can install. Each row needs to list the title of the module, show an icon for the software, and display a check box if it's virus free.

We create an object in Designer for the cells in the grid, and on it place a text object with "<%=CA:Title%>". This means the text will contain the cell's attribute "Title". Create a blank bitmap object with no graphic to represent the icon, and another which contains a check box for 'virus free'.

Create a new datagrid in Designer and place on it all 3 of those objects, marking the 'virus free' one as 'can hide', meaning it won't always be visible.

Create a data grid generator (in this case in general info plugin) and register it as follows:

bool General_Info_Plugin::Register() {
...
m_pDatagrid_Plugin->RegisterDatagridGenerator(
new DataGridGeneratorCallBack(this, (DCEDataGridGeneratorFn) (&General_Info_Plugin::AddSoftware)),
DATAGRID_Installable_Apps_CONST, PK_DeviceTemplate_get());

in the generator code we retrieve the software modules from the database and create a cell for each with the correct attributes:

class DataGridTable *General_Info_Plugin::AddSoftware( string GridID, string Parms, void *ExtraData, int *iPK_Variable, string *sValue_To_Assign, class Message *pMessage ) {
DataGridTable *pDataGrid = new DataGridTable();
DataGridCell *pCell;

string sql="SELECT PK_Software, Iconstr, Title, Category, Rating, Virus_Free, Installation_status, Description, Homeurl FROM Software WHERE FK_Device="+sPK_Device_PC+" ORDER BY Title";

int iRow=0;
if( (result.r = m_pDatabase_pluto_main->mysql_query_result(sql)) )
{
unsigned long *lengths;
while((row=mysql_fetch_row(result.r))){
lengths=mysql_fetch_lengths(result.r);
int size = 0;
char *data = NULL;

pCell = new DataGridCell("", row[0]);
if(lengths[1]){
char *Data=new char[lengths[1]];
memcpy(Data,row[1],lengths[1]);
pCell->SetImage(Data, lengths[1], GR_PNG);
}
pCell->m_mapAttributes["Title"] = row[2] ? row[2] : "";
pCell->m_mapAttributes["Category"] = row[3] ? row[3] : "";
pCell->m_mapAttributes["Rating"] = row[4] ? row[4] : "";
pCell->m_mapAttributes["Rating"] = row[4] ? row[4] : "";
pCell->m_mapAttributes["Virus_Free"] = row[5] ? row[5] : "";
pCell->m_mapAttributes["Installation_status"] = row[6] ? row[6] : "";
pCell->m_mapAttributes["Description"] = row[7] ? row[7] : "";
pDataGrid->SetData(0,iRow++,pCell);
}
}

return pDataGrid;
}

Then in orbiter we create a screen handler for this screen and register interceptors:

/*virtual*/ void ScreenHandler::SCREEN_Add_Software(long PK_Screen)
{
ScreenHandlerBase::SCREEN_Add_Software(PK_Screen);
RegisterCallBack(cbDataGridSelected, (ScreenHandlerCallBack) &ScreenHandler::AddSoftware_GridSelected, new DatagridCellBackData());
RegisterCallBack(cbDataGridRendering, (ScreenHandlerCallBack) &ScreenHandler::AddSoftware_GridRendering, new DatagridAcquiredBackData());
}
//-----------------------------------------------------------------------------------------------------
bool ScreenHandler::AddSoftware_GridRendering(CallBackData *pData)
{
// This is called every time a new section of the grid is to be rendered. We want to find the child object for the 'virus free' check and hide it if it's virus free,
// and also find the child object for the icon and assign it the picture associated with the cell.
DatagridAcquiredBackData *pDatagridAcquiredBackData = (DatagridAcquiredBackData *) pData; // Call back data containing relevant values for the grid/table being rendered

// Iterate through all the cells
for(MemoryDataTable::iterator it=pDatagridAcquiredBackData->m_pDataGridTable->m_MemoryDataTable.begin();it!=pDatagridAcquiredBackData->m_pDataGridTable->m_MemoryDataTable.end();++it)
{
DataGridCell *pCell = it->second;
pair<int,int> colRow = DataGridTable::CovertColRowType(it->first); // Get the column/row for the cell

// See if there is an object assigned for this column/row
map< pair<int,int>, DesignObj_Orbiter *>::iterator itobj = pDatagridAcquiredBackData->m_pObj->m_mapChildDgObjects.find( colRow );
if( itobj!=pDatagridAcquiredBackData->m_pObj->m_mapChildDgObjects.end() )
{
DesignObj_Orbiter *pObj = itobj->second; // This is the cell's object.
DesignObj_DataList::iterator iHao;

// Iterate through all the object's children
for( iHao=pObj->m_ChildObjects.begin( ); iHao != pObj->m_ChildObjects.end( ); ++iHao )
{
DesignObj_Orbiter *pDesignObj_Orbiter = (DesignObj_Orbiter *)( *iHao );
if( pDesignObj_Orbiter->m_iBaseObjectID==DESIGNOBJ_Installed_Apps_Not_Virus_Free_CONST )
pDesignObj_Orbiter->m_bHidden = pCell->m_mapAttributes_Find("Virus_Free")=="Yes"; // Hide this if it's virus fee
if( pDesignObj_Orbiter->m_iBaseObjectID==DESIGNOBJ_Installed_Apps_Icon_CONST )
m_pOrbiter->m_pOrbiterRenderer->UpdateObjectImage(pDesignObj_Orbiter->m_ObjectID, "PNG",
pCell->m_pGraphicData, pCell->m_GraphicLength, "0"); // Store the icon, which is cell's picture
}
}
}
return false;
}
//-----------------------------------------------------------------------------------------------------
bool ScreenHandler::AddSoftware_GridSelected(CallBackData *pData)
{
DatagridCellBackData *pCellInfoData = (DatagridCellBackData *)pData;
if( pCellInfoData->m_pDataGridCell )
{
int PK_Software = atoi(pCellInfoData->m_pDataGridCell->GetValue());
string sText,sCommand;
if( PK_Software>0 )
{
sText = m_pOrbiter->m_mapTextString[TEXT_Confirm_Add_Software_CONST];
sCommand = StringUtils::itos(m_pOrbiter->m_dwPK_Device) + " " + StringUtils::itos(m_pOrbiter->m_dwPK_Device_GeneralInfoPlugIn)
+ " 1 " + TOSTRING(COMMAND_Add_Software_CONST) + " " + TOSTRING(COMMANDPARAMETER_PK_Software_CONST)
+ " " + pCellInfoData->m_pDataGridCell->GetValue() + " " TOSTRING(COMMANDPARAMETER_PK_Device_CONST) " "
+ StringUtils::itos(m_pOrbiter->m_pLocationInfo->m_dwPK_Device_MediaDirector) + " " TOSTRING(COMMANDPARAMETER_TrueFalse_CONST) " 1";
}
else if( PK_Software<0 )
{
sText = m_pOrbiter->m_mapTextString[TEXT_Confirm_Add_Software_CONST];
sCommand = StringUtils::itos(m_pOrbiter->m_dwPK_Device) + " " + StringUtils::itos(m_pOrbiter->m_dwPK_Device_GeneralInfoPlugIn)
+ " 1 " + TOSTRING(COMMAND_Add_Software_CONST) + " " + TOSTRING(COMMANDPARAMETER_PK_Software_CONST)
+ " " + StringUtils::itos(PK_Software*-1) + " " TOSTRING(COMMANDPARAMETER_PK_Device_CONST) " "
+ StringUtils::itos(m_pOrbiter->m_pLocationInfo->m_dwPK_Device_MediaDirector) + " " TOSTRING(COMMANDPARAMETER_TrueFalse_CONST) " 0";
}
else
return false; // No software was selected

DataGridCell *pCell = pCellInfoData->m_pDesignObj_DataGrid->DataGridTable_Get() ? pCellInfoData->m_pDesignObj_DataGrid->DataGridTable_Get()->GetData( 0, pCellInfoData->m_Row ) : NULL;
if( pCell )
sText+="\n" + pCell->m_mapAttributes["Title"];
DisplayMessageOnOrbiter(0,sText,false,"30",false,m_pOrbiter->m_mapTextString[TEXT_YES_CONST],sCommand,m_pOrbiter->m_mapTextString[TEXT_NO_CONST]);
}

return false; // Keep processing it
}