DataGrid Objects
| 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. |
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
}
