Requisitos de build para Controles Comuns do Windows

Artigo
06/16/2023

A MFC (Microsoft Foundation Class) dá suporte a Controles Comuns do Windows. Os Controles Comuns estão incluídos no Windows e a biblioteca está incluída no Visual Studio. A biblioteca MFC fornece novos métodos que aprimoram classes existentes, bem como classes e métodos adicionais que dão suporte aos Controles Comuns do Windows. Ao criar seu aplicativo, você deve seguir os requisitos de compilação e migração descritos nas seções a seguir.

Requisitos de compilação

Versões compatíveis

A MFC dá suporte a todas as versões dos Controles Comuns. Para obter informações sobre as versões dos Controles Comuns do Windows, consulte Versões de Controle Comum.

Conjuntos de caracteres com suporte

Os Controles Comuns do Windows dão suporte apenas ao conjunto de caracteres Unicode, e não ao conjunto de caracteres ANSI. Se você criar o aplicativo na linha de comando, use as duas opções de compilador define (/D) seguintes para especificar Unicode como o conjunto de caracteres subjacente:

/D_UNICODE /DUNICODE

Se você criar o aplicativo no IDE (ambiente de desenvolvimento integrado) do Visual Studio, especifique a opção Conjunto de Caracteres Unicode da propriedade Conjunto de Caracteres no nó Geral das propriedades do projeto.

Requisitos de migração

Se você usar o IDE do Visual Studio para criar um aplicativo MFC que usa Controles Comuns do Windows, o IDE declarará automaticamente um manifesto apropriado. No entanto, se você migrar um aplicativo MFC existente do Visual Studio 2005 ou anterior e quiser usar os Controles Comuns, o IDE não fornecerá automaticamente informações de manifesto para atualizar o aplicativo. Em vez disso, você precisará inserir manualmente o seguinte código-fonte no arquivo de cabeçalho pré-compilado:

#ifdef UNICODE
#if defined _M_IX86
#pragma comment(linker,"/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='x86' publicKeyToken='6595b64144ccf1df' language='*'\"")
#elif defined _M_IA64
#pragma comment(linker,"/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='ia64' publicKeyToken='6595b64144ccf1df' language='*'\"")
#elif defined _M_X64
#pragma comment(linker,"/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='amd64' publicKeyToken='6595b64144ccf1df' language='*'\"")
#else
#pragma comment(linker,"/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='*' publicKeyToken='6595b64144ccf1df' language='*'\"")
#endif
#endif

Confira também

Tópicos gerais do MFC
Gráfico da hierarquia
APIs ANSI preteridas

Compartilhar via