Demonstra Passo a passo: Criando um novo aplicativo de faixa de opções usando o MFC

Artigo
08/25/2010

Nesta explicação passo a passo, você usará o MFC Application assistente para criar um aplicativo que tenha uma faixa de opções padrão.Você, em seguida, irá expandir da faixa de opções adicionando um Personalizado fita categoria com um Favoritos fita painel e adicionar a ele alguns comandos usados com freqüência.

Pré-requisitos

Para concluir esta explicação passo a passo, você deve instalar o Visual C++ 2008 Feature Pack ou instalar Visual Studio 2008 serviço empacotar 1.

Esta explicação passo a passo presume que você configurou Visual Studio Para usar Configurações Geral de desenvolvimento.Se você estiver usando uma configuração de desenvolvimento diferentes, algumas Visual Studio janelas que usamos nesta explicação passo a passo podem não ser exibidas por padrão.

Para criar um novo aplicativo MFC com uma faixa de opções

Use o MFC Application assistente para criar um aplicativo MFC que tem uma faixa de opções padrão.Para executar o assistente, da Arquivo selecionar menu Novoe, em seguida, selecionar Projeto.The Novo projeto caixa de diálogo será exibida.
No Novo projeto caixa de diálogo, expandir o O Visual C++ nó o Tipos de projeto painel e selecionar MFC.Em seguida, no Modelos painel, selecionar Aplicativo MFC.Digite um nome para o projeto such sistema autônomo MFCRibbonApp e clicar OK.The MFC aplicativo assistente será exibida.
No MFC aplicativo assistente diálogo, clicar Próximo.The Tipo de aplicativo painel será exibido.
No Tipo de aplicativo painel, em Cores e estilo Visual, selecionar O Office 2007 (tema azul).Deixe o Outros configurações sistema autônomo estão.clicar Próximo para exibir o Compostos de suporte do documento painel.
Não adicionaremos suporte documento composto.Por isso, certifique-se de que Nenhum está selecionada.clicar Próximo para exibir o Strings de modelo de documento painel.
No Strings de modelo de documento painel, escolha uma extensão de nome de arquivo para sistema autônomo documentos deste aplicativo irá criar, por exemplo, mfcrbnappe digite-o no Extensão de arquivo campo.clicar Próximo para exibir o Suporte de banco de dados painel.
Não adicionaremos suporte ao banco de dados para este aplicativo.Por isso, certifique-se de que Nenhum está selecionada.clicar Próximo para exibir o Recursos de interface do usuário painel.
No Recursos de interface do usuário painel, certifique-se de que o Usar uma faixa de opções opção está selecionada.clicar Próximo para exibir o Recursos avançados painel.
Por padrão, a MFC aplicativo assistente adiciona suporte para vários painéis de encaixe.Como é a finalidade desta explicação passo a passo saber mais sobre a faixa de opções, removerá essas opções de nosso aplicativo.No Quadro avançados painéis painel, desmarcar todas as opções.clicar Próximo para exibir o Classes geradas painel.
No Classes geradas painel, clicar Concluir para criar seu novo aplicativo do MFC.
Verificar se o aplicativo foi criado com êxito, criando e executando-o.Para criar o aplicativo do Compilação selecionar menu Criar solução.Se o aplicativo criado com êxito, execute o aplicativo selecionando Iniciar a depuração from the Depurar menu.

O assistente cria automaticamente uma faixa de opções com uma faixa de opções categoria chamado residência.Essa faixa de opções contém três painéis da faixa de opções que são nomeados Área de transferência, Modo de exibição, and Janela.

Para adicionar uma categoria da faixa de opções para a faixa de opções

O cabo de fita existente que criou o projeto pode ser encontrado no cabeçalho MainFrm.h.Esse cabeçalho contém a linha de código a seguir:
```
CMFCRibbonBar m_wndRibbonBar;
```
Para adicionar uma categoria para a faixa de opções, chame o CMFCRibbonBar::AddCategory método. Este método tem três parâmetros necessários.O primeiro parâmetro é o nome da categoria.Esse é o valor que aparecerão na guia da categoria na Faixa de Opções de Opções.Para tornar seu aplicativo mais fácil de localizar, adicione este valor à Tabela de seqüência de caracteres nos recursos de aplicativos.

Para fazer isso, clicar Modo de exibição de recurso, expandir o MFCRibbonApp and MFCRibbonApp.rc nós e, em seguida, expandir o Tabela de seqüência de caracteres nó.Se o Modo de exibição de recurso guia não estiver visível, em aberto-lo clicando no Modo de exibição menu, em seguida, clique em Outras janelase finalmente selecionando Modo de exibição de recurso.Em seguida, clicar duas vezes em Tabela de seqüência de caracteres.Na janela que aparece, clicar com o botão direito do mouse em qualquer lugar e selecionar Nova string.O sistema agora cria uma nova entrada possui um valor que é semelhante a IDS_STRINGnnn.A categoria que está sendo criado será rotulada Personalizado, então, renomeie a seqüência de caracteres para IDS_RIBBON_CUSTOM clicando no ID campo.Em seguida, clicar no Legenda de campo e digite Personalizado.

sistema autônomo próximos dois parâmetros para o CMFCRibbonBar::AddCategory método são sistema autônomo bitmaps são usados sistema autônomo ícones para sistema autônomo elementos da faixa de opções. Criar bitmaps personalizados está além do escopo desta explicação passo a passo.Portanto, nós reutilizará bitmaps criados pelo assistente.O segundo parâmetro é a ID do recurso para os bitmaps pequenos que aparecem na Faixa de Opções de Opções.Bitmaps pequenos são pixels de 16 por 16 pixels.Para esses bitmaps, nós selecionará os bitmaps acessados pelo IDB_FILESMALL ID do recurso. O terceiro parâmetro é a ID do recurso para os bitmaps grandes que aparecem na Faixa de Opções de Opções.Bitmaps grandes são 32 pixels por 32 pixels.Para esses bitmaps, nós selecionará os bitmaps acessados pelo IDB_FILELARGE ID do recurso.
Abra o arquivo MainFrm.cpp e localizar o CMainFrame::OnCreate método. Você irá notar estas duas linhas de código:
```
m_wndRibbonBar.Create(this);
InitializeRibbon();
```
The CMFCRibbonBar::criar método cria os controles de Windows subjacentes para o cabo de fita e você pode personalizar a faixa de opções dentro do CMainFrame::InitializeRibbon método.

navegar até a parte inferior do CMainFrame::InitializeRibbon método. Para criar a categoria da faixa de opções, adicione este código:

// Add "Custom" category:
strTemp.LoadString(IDS_RIBBON_CUSTOM);
CMFCRibbonCategory* pCategoryCustom =
    m_wndRibbonBar.AddCategory(strTemp, IDB_FILESMALL, IDB_FILELARGE);

Verifique o categoria da faixa de opções foi criado com êxito, criando e executando o aplicativo.Para criar o aplicativo do Compilação menu, selecionar Criar solução.Se o aplicativo criado com êxito, execute o aplicativo selecionando Iniciar a depuração from the Depurar menu.Você deve ver agora um Personalizado guia na Faixa de Opções de Opções.

Para adicionar um painel da faixa de opções para o categoria da faixa de opções

Você pode agrupar itens que são logicamente relacionados entre si colocando-os dentro de um painel da faixa de opções.Por exemplo, no residência guia deste aplicativo, a Recortar, Cópia, and Colar comandos estão localizados no Área de transferência painel.

Para adicionar um painel da faixa de opções para o Personalizado categoria, telefonar o CMFCRibbonCategory::AddPanel método.

Esse método aceita um parâmetro obrigatório, que é o nome do painel.Adicione este valor para o Tabela de seqüência de caracteres para tornar mais fácil de localizar seu aplicativo.Para fazer isso, clicar Modo de exibição de recurso, expandir o MFCRibbonApp and MFCRibbonApp.rc nós e, em seguida, expandir o Tabela de seqüência de caracteres nó.Em seguida, clicar duas vezes em Tabela de seqüência de caracteres.Na janela que aparece, clicar com o botão direito do mouse em qualquer lugar e selecionar Nova string.O sistema agora cria uma nova entrada possui um valor que é semelhante a IDS_STRINGnnn.Rótulo de painel que estamos criando Favoritos, então, renomeie a seqüência de caracteres para IDS_RIBBON_FAVORITES clicando no ID campo.Em seguida, clicar no Legenda campo e digite Favoritos.

Você também pode fornecer a ID do recurso de um ícone para o AddPanel método. Este ícone é exibido se o painel da faixa de opções é adicionado à barra de ferramentas de acesso rápido, mas não é exibida, na verdade, no painel da faixa de opções propriamente dito.O assistente já criou uma instância de um Classe CMFCToolBarImages para nós de chamada m_PanelImages. Usaremos um dos ícones este bitmap para nosso código.Você pode extrair a imagem, chamando o CMFCToolBarImages::ExtractIcon método.

Para adicionar o Favoritos fita categoria ao painel, adicione o seguinte código abaixo o código que você adicionou anteriormente CMainFrame::InitializeRibbon:

// Create "Favorites" panel:
strTemp.LoadString(IDS_RIBBON_FAVORITES);
CMFCRibbonPanel* pPanelFavorites =
    pCategoryCustom->AddPanel(strTemp, m_PanelImages.ExtractIcon(15));

Verificar se o painel da faixa de opções foi criado com êxito, criando e executando o aplicativo.Para criar o aplicativo do Compilação menu, selecionar Criar solução.Se o aplicativo criado com êxito, execute o aplicativo selecionando Iniciar a depuração from the Depurar menu.Você deve ver agora um Favoritos painel o Personalizado guia na Faixa de Opções de Opções.

Para adicionar elementos para os painéis da faixa de opções

Para adicionar elementos ao painel que você criou no procedimento anterior, chame o CMFCRibbonPanel::Add método. Este método usa uma instância de Classe CMFCRibbonBaseElement sistema autônomo um parâmetro. CMFCRibbonBaseElement é a classe base para todos sistema autônomo elementos que podem ser adicionados a um painel, sistema autônomo botões, caixas de seleção e caixas de combinação.
Primeiro, adicionamos um Impressão botão.The Impressão botão terá um submenu que contenha um Impressão rápidacomando (que imprime usando a impressora padrão).Os dois comandos já estão definidos para este aplicativo porque eles sejam encontram no menu do aplicativo.

Para criar o Impressão rápida botão, adicione o seguinte código abaixo o código que você adicionou anteriormente CMainFrame::InitializeRibbon:
```
// Create "Quick Print" button:
strTemp.LoadString(IDS_RIBBON_PRINT_QUICK);
CMFCRibbonButton* pBtnFavPrintQuick =
    new CMFCRibbonButton(ID_FILE_PRINT_DIRECT, strTemp, 7);
```
The IDS_RIBBON_PRINT_QUICK seqüência de caracteres já está definida no Tabela de seqüência de caracteres, sistema autônomo is the ID_FILE_PRINT_DIRECT comando. O terceiro parâmetro para o Construtor CMFCRibbonButton é o ícone pequeno que é exibido junto ao comando.Nesse caso, a Impressão rápida ícone é o sétimo bitmap no IDB_FILESMALL ID do recurso.

Em seguida, adicione o seguinte código para criar um Impressão botão.Usamos o CMFCRibbonButton::AddSubItem Para adicionar a Impressão rápida botão sistema autônomo um subitem do Impressão botão:
```
// Create "Print" button with "Quick Print" as subitem:
strTemp.LoadString(IDS_RIBBON_PRINT);
CMFCRibbonButton* pBtnFavPrint =
    new CMFCRibbonButton(ID_FILE_PRINT, strTemp, 6);
pBtnFavPrint->AddSubItem(pBtnFavPrintQuick);
```
The IDS_RIBBON_PRINT seqüência de caracteres já está definida no Tabela de seqüência de caracteres, sistema autônomo is the ID_FILE_PRINT comando. O terceiro parâmetro para o construtor é o ícone pequeno que é exibido junto ao comando.Nesse caso, a Impressão ícone é o sexto bitmap no IDB_FILESMALL ID do recurso.

Em seguida, adicione o seguinte código para adicionar o Impressão o botãoFavoritos painel:
```
// Add "Print" button to "Favorites" panel:
pPanelFavorites->Add(pBtnFavPrint);
```
O segundo item adicionaremos à Favoritos painel é uma caixa de combinação.Para simplificar esta explicação passo a passo, nós não irá associar itens da caixa de combinação com um comando.Em vez disso, basta demonstraremos como adicionar uma caixa de combinação da faixa de opções.

The Construtor CMFCRibbonComboBox aceita cinco parâmetros.O primeiro parâmetro é a ID de comando para a ação é executada quando um usuário seleciona um item na caixa de combinação.O segundo parâmetro especifica se os itens na caixa de combinação são editáveis.Neste aplicativo, especificamos FALSE. O terceiro parâmetro é a largura da caixa de combinação.Especificamos -1, para que a caixa de combinação usa a largura padrão de 120 pixels.O quarto parâmetro é o rótulo da caixa de combinação.Neste aplicativo, nós não fornecerá um rótulo.O parâmetro final é a imagem a ser exibida próxima à caixa de combinação.Neste aplicativo, nós não fornecerá uma imagem.Para criar a caixa de combinação, digite este código abaixo o código que você adicionou anteriormente CMainFrame::InitializeRibbon:
```
// Create a simple combo box that has two entries:
CMFCRibbonComboBox *pComboSimple =
    new CMFCRibbonComboBox(-1, FALSE, -1, 0, -1);
```
Em seguida, adicionaremos dois valores da caixa de combinação.Para simplificar, nós atribuirá rótulo esses valores de "Hi!" e "Hello!":
```
// Add two items to the combo box and select the first item in the list:
pComboSimple->AddItem(_T("Hi!"));
pComboSimple->AddItem(_T("Hello!"));
pComboSimple->SelectItem(0);
```
Agora adicionaremos a caixa de combinação ao painel chamando CMFCRibbonPanel::Add:
```
// Add combo button to "Favorites" panel:
pPanelFavorites->Add(pComboSimple);
```
Verificar se a caixa de combinação e de botão foram adicionados ao painel da faixa de opções construir e executar o aplicativo.Para criar o aplicativo do Compilação menu, selecionar Criar solução.Se o aplicativo criado com êxito, execute o aplicativo selecionando Iniciar a depuração from the Depurar menu.Você verá agora o Impressão botão e a combinação caixa no Favoritos painel o Personalizado guia na Faixa de Opções de Opções.

Próximas etapas

Tente adicionar vários elementos de faixa de opções diferentes para o Favoritos painel, sistema autônomo um CMFCRibbonCheckBox or a CMFCLinkCtrl.

Para instruções adicionais sobre o Visual C++ 2008 Feature Pack, consulte Explicações passo a passo (@@).

Para exemplos completos que abordam diversos aspectos do Visual C++ 2008 Feature Pack, consulte Exemplos (MFC recurso empacotar).

Consulte também

Outros recursos

Explicações passo a passo (@@)

Exemplos (MFC recurso empacotar)

Compartilhar via