保存带区布局 翻译:tellmenow
命令带控件的可配置能力给程序员带来一个问题。用户重新排列带区后,希望定制的布局在应用程序下一次启动的时候能够恢复。通过使用下面的函数,可以轻易的达到目的:
BOOL CommandBans_GetRestoreInformation (HWND hwndCmdBands, UINT uBand, LPCOMMANDBANDSRESTOREINFO pcbr);
该函数将单个带区的信息保存到COMMANDBANDSRESTOREINFO结构中。该函数有两个参数,一个是命令带控件句柄,一个是将要查询的带区的索引值。下面的代码片段展示了如何查询命令带控件中每个带区的信息。
// Get the handle of the command bands control.
hwndCB = GetDlgItem (hWnd, IDC_CMDBAND);
// Get information for each band.
for (i = 0; i < NUMBANDS; i++) {
// Get band index from ID value.
nBand = SendMessage (hwndCB, RB_IDTOINDEX, IDB_CMDBAND+i, 0);
// Initialize the size field, and get the restore information.
cbr[i].cbSize = sizeof (COMMANDBANDSRESTOREINFO);
CommandBands_GetRestoreInformation (hwndCB, nBand, &cbr[i]);
}
上面的代码使用RB_IDTOINDEX消息,将带区ID转化成带区索引,以用于CommandBands_GetRestoreInformation。结构中的数据通常存储在系统注册表中。我将在第8章“文件和注册表”中讲解如何读写注册表数据。
当应用程序恢复的时候,应该从注册表中读取恢复信息,并在创建命令带控件的时候使用。
// Restore configuration to a command band.
COMMANDBANDSRESTOREINFO cbr[NUMBANDS];
REBARBANDINFO rbi;
// Initialize size field.
rbi.cbSize = sizeof (REBARBANDINFO);
// Set only style and size fields.
rbi.fMask = RBBIM_STYLE | RBBIM_SIZE;
// Set the size and style for all bands.
for (i = 0; i < NUMBANDS; i++) {
rbi.cx = cbr[i].cxRestored;
rbi.fStyle = cbr[i].fStyle;
nBand = SendMessage (hwndCB, RB_IDTOINDEX, cbr[i].wID, 0);
SendMessage (hwndCB, RB_SETBANDINFO, nBand, (LPARAM)&rbi);
}
// Only after the size is set for all bands can the bands
// needing maximizing be maximized.
for (i = 0; i < NUMBANDS; i++) {
if (cbr[i].fMaximized) {
nBand = SendMessage (hwndCB, RB_IDTOINDEX, cbr[i].wID, 0);
SendMessage (hwndCB, RB_MAXIMIZEBAND, nBand, TRUE);
}
}
上面的代码假设命令带控件已经按照默认配置创建。在实际应用中,尺寸和风格的恢复信息用于最初创建控件的时候。在那种情况下,剩余的将根据COMMANDBANDSRESTOREINFO结构中fMaximized域的状态来决定是否最大化带区。只有在所有的带区被创建和适当的调整尺寸后,才做上面代码中的最后一步。
该系统对保存和恢复带区的布局有一个限制,就是您没有办法判断带区在控件中的顺序。带区索引不能提供可靠的信息,因为经过用户几次重新安排带区后,索引值既不连续也不是按任何定义的顺序。解决该问题的唯一方式是强制排列带区,这样用户就不能重新排列带区。通过设置RBS_FIXEDORDER风格,可以达到这个目的。这样可以解决这个问题,但如果用户想要一个不同的顺序,就不能够给用户提供帮助了。在本节最后的例子程序中,我使用带区索引值来猜测顺序。但这个方法不能保证一定能有效。