[翻译]-Windows CE 程序设计 (3rd 版)--5.2 公共控件(八)

保存带区布局 翻译: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风格，可以达到这个目的。这样可以解决这个问题，但如果用户想要一个不同的顺序，就不能够给用户提供帮助了。在本节最后的例子程序中，我使用带区索引值来猜测顺序。但这个方法不能保证一定能有效。