Estrutura AFX_GLOBAL_DATA

A estrutura AFX_GLOBAL_DATA contém campos e métodos usados para gerenciar a estrutura ou para personalizar a aparência e o comportamento do aplicativo.

Sintaxe

struct AFX_GLOBAL_DATA

Membros

Construtores públicos

Nome	Descrição
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA	Constrói uma estrutura AFX_GLOBAL_DATA.
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA	Destruidor.

Métodos públicos

Nome	Descrição
AFX_GLOBAL_DATA::Limpeza	Libera recursos alocados pela estrutura, como pincéis, fontes e DLLs.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	Cria uma transformação de rotação que gira segundo um ângulo especificado em torno de um ponto especificado.
AFX_GLOBAL_DATA::D rawParentBackground	Desenha a tela de fundo do pai de um controle na área especificada.
AFX_GLOBAL_DATA::D rawTextOnGlass	Desenha o texto especificado no estilo visual do tema especificado.
AFX_GLOBAL_DATA::ExcludeTag	Remove o par de marcas XML especificado de um buffer especificado.
AFX_GLOBAL_DATA::GetColor	Recupera a cor atual do elemento da interface do usuário especificado.
AFX_GLOBAL_DATA::GetDirect2dFactory	Retorna um ponteiro para a interface ID2D1Factory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.
AFX_GLOBAL_DATA::GetHandCursor	Recupera o cursor predefinido que se assemelha a uma mão, cujo identificador é IDC_HAND.
AFX_GLOBAL_DATA::GetITaskbarList	Cria e armazena nos dados globais um ponteiro para a interface ITaskBarList.
AFX_GLOBAL_DATA::GetITaskbarList3	Cria e armazena nos dados globais um ponteiro para a interface ITaskBarList3.
AFX_GLOBAL_DATA::GetNonClientMetrics	Recupera as métricas associadas à área não cliente de janelas não minimizadas.
AFX_GLOBAL_DATA::GetShellAutohideBars	Determina as posições das barras de ocultação automática do Shell.
AFX_GLOBAL_DATA::GetTextHeight	Recupera a altura dos caracteres de texto na fonte atual.
AFX_GLOBAL_DATA::GetWICFactory	Retorna um ponteiro para a interface IWICImagingFactory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.
AFX_GLOBAL_DATA::GetWriteFactory	Retorna um ponteiro para a interface IDWriteFactory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.
AFX_GLOBAL_DATA::InitD2D	Inicializa as fábricas D2D, DirectWrite e WIC. Chame esse método antes que a janela principal seja inicializada.
AFX_GLOBAL_DATA::Is32BitIcons	Indica se há suporte para ícones predefinidos de 32 bits.
AFX_GLOBAL_DATA::IsD2DInitialized	Determina se o D2D foi inicializado.
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Fornece uma maneira simples de chamar o método DwmIsCompositionEnabled do Windows.
AFX_GLOBAL_DATA::IsHighContrastMode	Indica se as imagens estão sendo exibidas em alto contraste.
AFX_GLOBAL_DATA::OnSettingChange	Detecta o estado atual da animação do menu da área de trabalho e dos recursos com ocultação automática da barra de tarefas.
AFX_GLOBAL_DATA::RegisterWindowClass	Registra a classe da janela do MFC especificada.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Libera interfaces obtidas por meio dos métodos GetITaskbarList e GetITaskbarList3.
AFX_GLOBAL_DATA::Currículo	Reinicializa ponteiros de função interna que acessam métodos que dão suporte a temas e estilos visuais do Windows.
AFX_GLOBAL_DATA::SetLayeredAttrib	Fornece uma maneira simples de chamar o método SetLayeredWindowAttributes do Windows.
AFX_GLOBAL_DATA::SetMenuFont	Cria a fonte lógica especificada.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	Cria e inicializa um objeto de item de Shell com base na análise de um nome.
AFX_GLOBAL_DATA::UpdateFonts	Reinicializa as fontes lógicas usadas pela estrutura.
AFX_GLOBAL_DATA::UpdateSysColors	Inicializa as cores, a profundidade de cor, os pincéis, as canetas e as imagens que são usados pela estrutura.

Métodos protegidos

Nome	Descrição
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Habilita ou desabilita o suporte para a Acessibilidade Ativa da Microsoft. A Acessibilidade Ativa fornece métodos confiáveis para expor informações sobre elementos da interface do usuário.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Indica se o suporte para a Acessibilidade Ativa da Microsoft está habilitado.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	Indica se o sistema operacional dá suporte a janelas em camadas.

Membros de dados

Nome	Descrição
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	Indica se o sistema operacional atual dá suporte à combinação alfa.
AFX_GLOBAL_DATA::bIsWindows7	Indica se o aplicativo está sendo executado no sistema operacional Windows 7 ou superior
AFX_GLOBAL_DATA::clrActiveCaptionGradient	Especifica a cor de gradiente da legenda ativa. Geralmente, usado para painéis com encaixe.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	Especifica a cor de gradiente da legenda inativa. Geralmente, usado para painéis com encaixe.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	Indica se a estrutura usa ícones com cores de 32 bits predefinidos ou ícones com uma resolução inferior.
AFX_GLOBAL_DATA::m_bUseSystemFont	Indica se uma fonte do sistema é usada para menus, barras de ferramentas e faixas de opções.
AFX_GLOBAL_DATA::m_hcurHand	Armazena o identificador do cursor de mão.
AFX_GLOBAL_DATA::m_hcurStretch	Armazena o identificador do cursor de alongamento horizontal.
AFX_GLOBAL_DATA::m_hcurStretchVert	Armazena o identificador do cursor de alongamento vertical.
AFX_GLOBAL_DATA::m_hiconTool	Armazena o identificador do ícone de ferramenta.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	Especifica o deslocamento da barra de ferramentas com ocultação automática mais à esquerda na barra de encaixe.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	Especifica a lacuna entre as barras de ferramentas com ocultação automática.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	Especifica a espessura do quadro de arraste usado para comunicar o estado encaixado.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	Especifica a espessura do quadro de arraste usado para comunicar o estado flutuante.

Comentários

A maioria dos dados na estrutura AFX_GLOBAL_DATA é inicializada quando o aplicativo é iniciado.

Hierarquia de herança

AFX_GLOBAL_DATA

Requisitos

Cabeçalho: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Indica se o sistema operacional dá suporte à combinação alfa.

BOOL  bIsOSAlphaBlendingSupport;

Comentários

TRUE indica que há suporte para mesclagem alfa; caso contrário, FALSE.

AFX_GLOBAL_DATA::Limpeza

Libera recursos alocados pela estrutura, como pincéis, fontes e DLLs.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Cria uma transformação de rotação que gira segundo um ângulo especificado em torno de um ponto especificado.

HRESULT D2D1MakeRotateMatrix(
    FLOAT angle,
    D2D1_POINT_2F center,
    D2D1_MATRIX_3X2_F *matrix);

Parâmetros

ângulo
O ângulo da rotação no sentido horário, em graus.

centro
O ponto sobre qual girar.

matriz
Quando retorna, este método contém a nova transformação de rotação. Você deve alocar armazenamento para esse parâmetro.

Valor de retorno

Retorna S_OK se tiver êxito; caso contrário, um valor de erro.

AFX_GLOBAL_DATA::D rawParentBackground

Desenha a tela de fundo do pai de um controle na área especificada.

BOOL DrawParentBackground(
    CWnd* pWnd,
    CDC* pDC,
    LPRECT lpRect = NULL);

Parâmetros

pWnd
[in] Ponteiro para a janela de um controle.

pDC
[in] Ponteiro para um contexto de dispositivo.

lpRect
[in] Ponteiro para um retângulo que limita a área a ser desenhada. O valor padrão é NULL.

Valor de retorno

TRUE se o método for bem-sucedido; caso contrário, FALSE.

AFX_GLOBAL_DATA::D rawTextOnGlass

Desenha o texto especificado no estilo visual do tema especificado.

BOOL DrawTextOnGlass(
    HTHEME hTheme,
    CDC* pDC,
    int iPartId,
    int iStateId,
    CString strText,
    CRect rect,
    DWORD dwFlags,
    int nGlowSize = 0,
    COLORREF clrText = (COLORREF)-1);

Parâmetros

hTheme
[in] Identificador para os dados de tema de uma janela ou NULL. A estrutura usará o tema especificado para desenhar o texto se esse parâmetro não for NULL e se houver suporte para temas. Caso contrário, a estrutura não usará um tema para desenhar o texto.

Use o método OpenThemeData para criar um HTHEME.

pDC
[in] Ponteiro para um contexto de dispositivo.

iPartId
[in] O bloco que tem a aparência de texto desejada. Para obter mais informações, consulte a coluna Blocos da tabela em Blocos e Estados. Se esse valor for 0, o texto será desenhado na fonte padrão, ou uma fonte selecionada no contexto do dispositivo.

iStateId
[in] O estado do controle que tem a aparência de texto desejada. Para obter mais informações, consulte a coluna Estados da tabela em Blocos e Estados.

strText
[in] O texto a ser desenhado.

rect
[in] O limite da área na qual o texto especificado é desenhado.

dwFlags
[in] Uma combinação bit a bit (OR) de sinalizadores que determinam como o texto especificado é desenhado.

Se o parâmetro hTheme for NULL ou se temas não tiverem suporte e não estiverem habilitados, o parâmetro nFormat do método CDC::DrawText descreverá os sinalizadores válidos. Se houver suporte para temas, o parâmetro dwFlags do método DrawThemeTextEx descreverá os sinalizadores válidos.

nGlowSize
[in] O tamanho de um efeito de brilho desenhado em segundo plano antes de desenhar o texto especificado. O valor padrão é 0.

clrTexto
[in] A cor na qual o texto especificado é desenhado. O valor padrão é a cor padrão.

Valor de retorno

TRUE se um tema for usado para desenhar o texto especificado; caso contrário, FALSE.

Comentários

Um tema define o estilo visual de um aplicativo. Um tema não será usado para desenhar o texto se o parâmetro hTheme for NULL ou se o método DrawThemeTextEx não tiver suporte, ou se a composição do DWM (Gerenciador de Janelas da Área de Trabalho) estiver desabilitada.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Habilita ou desabilita o suporte para a Acessibilidade Ativa da Microsoft.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Parâmetros

bEnable
[in] TRUE para habilitar o suporte à acessibilidade; FALSE para desabilitá-lo. O valor padrão é TRUE.

Comentários

A Acessibilidade Ativa é uma tecnologia baseada em COM que aprimora a maneira como os programas e o sistema operacional Windows funcionam em conjunto com produtos de tecnologia adaptativa. Ela fornece métodos confiáveis para expor informações sobre elementos da interface do usuário. No entanto, um modelo de acessibilidade mais recente chamado Automação da Interface do Usuário da Microsoft está disponível. Para ver uma comparação das duas tecnologias, consulte Automação da Interface do Usuário e Acessibilidade Ativa da Microsoft.

Use o método AFX_GLOBAL_DATA::IsAccessibilitySupport para determinar se o suporte à Acessibilidade Ativa da Microsoft está habilitado.

AFX_GLOBAL_DATA::ExcludeTag

Remove o par de marcas XML especificado de um buffer especificado.

BOOL ExcludeTag(
    CString& strBuffer,
    LPCTSTR lpszTag,
    CString& strTag,
    BOOL bIsCharsList = FALSE);

Parâmetros

strBuffer
[in] Um buffer de texto.

lpszTag
[in] O nome de um par de marcas XML de abertura e fechamento.

strTag
[out] Quando esse método é retornado, o parâmetro strTag contém o texto entre as marcas XML de abertura e fechamento nomeadas pelo parâmetro lpszTag. Qualquer espaço em branco à esquerda ou à direita é cortado do resultado.

bIsCharsList
[in] TRUE para converter símbolos de caracteres de escape no parâmetro strTag em caracteres de escape reais; FALSE para não executar a conversão. O valor padrão é FALSE. Para obter mais informações, consulte Comentários.

Valor de retorno

TRUE se o método for bem-sucedido; caso contrário, FALSE.

Comentários

Um par de marcas XML é composto por marcas de abertura e fechamento nomeadas que indicam o início e o fim de uma execução de texto no buffer especificado. O parâmetro strBuffer especifica o buffer e o parâmetro lpszTag especifica o nome das marcas XML.

Use os símbolos na tabela a seguir para codificar um conjunto de caracteres de escape no buffer especificado. Especifique TRUE para o parâmetro bIsCharsList para converter os símbolos no parâmetro strTag em caracteres de escape reais. A tabela a seguir usa a macro _T() para especificar o símbolo e as cadeias de caracteres de escape.

Símbolo	Caractere de escape
_T("\\t")	_T("\t")
_T("\\n")	_T("\n")
_T("\\r")	_T("\r")
_T("\\b")	_T("\b")
_T("LT")	_T("<")
_T("GT")	_T(">")
_T("AMP")	_T("&")

AFX_GLOBAL_DATA::GetColor

Recupera a cor atual do elemento da interface do usuário especificado.

COLORREF GetColor(int nColor);

Parâmetros

nColor
[in] Um valor que especifica um elemento de interface do usuário cuja cor é recuperada. Para obter uma lista de valores válidos, consulte o parâmetro nIndex do método GetSysColor.

Valor de retorno

O valor de cor RGB do elemento da interface do usuário especificado. Para obter mais informações, consulte Comentários.

Comentários

Se o parâmetro nColor estiver fora do intervalo, o valor retornado será zero. Como zero também é um valor RGB válido, você não pode usar esse método para determinar se uma cor do sistema tem suporte do sistema operacional atual. Em vez disso, use o método GetSysColorBrush, que retornará NULL se a cor não tiver suporte.

AFX_GLOBAL_DATA::GetDirect2dFactory

Retorna um ponteiro para a interface ID2D1Factory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.

ID2D1Factory* GetDirect2dFactory();

Valor de retorno

Um ponteiro para a interface ID2D1Factory se a criação de uma fábrica for bem-sucedida ou NULL se a criação falhar ou o sistema operacional atual não tiver suporte para D2D.

AFX_GLOBAL_DATA::GetHandCursor

Recupera o cursor predefinido que se assemelha a uma mão e cujo identificador é IDC_HAND.

HCURSOR GetHandCursor();

Valor de retorno

O identificador do cursor de mão.

AFX_GLOBAL_DATA::GetNonClientMetrics

Recupera as métricas associadas à área não cliente de janelas não minimizadas.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Parâmetros

info
[in, out] Uma estrutura NONCLIENTMETRICS que contém as métricas escalonáveis associadas à área não cliente de uma janela não gerenciada.

Valor de retorno

TRUE se esse método tiver êxito, caso contrário, FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Recupera a altura dos caracteres de texto na fonte atual.

int GetTextHeight(BOOL bHorz = TRUE);

Parâmetros

bHorz
[in] TRUE para recuperar a altura dos caracteres quando o texto é executado horizontalmente; FALSE para recuperar a altura dos caracteres quando o texto é executado verticalmente. O valor padrão é TRUE.

Valor de retorno

A altura da fonte atual, que é medida do ascendente ao descendente.

AFX_GLOBAL_DATA::GetWICFactory

Retorna um ponteiro para a interface IWICImagingFactory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.

IWICImagingFactory* GetWICFactory();

Valor de retorno

Um ponteiro para a interface IWICImagingFactory se a criação de uma fábrica for bem-sucedida ou NULL se a criação falhar ou o sistema operacional atual não tiver suporte para WIC.

AFX_GLOBAL_DATA::GetWriteFactory

Retorna um ponteiro para a interface IDWriteFactory armazenada nos dados globais. Se a interface não for inicializada, ela será criada e terá os parâmetros padrão.

IDWriteFactory* GetWriteFactory();

Valor de retorno

Um ponteiro para a interface IDWriteFactory se a criação de uma fábrica for bem-sucedida ou NULL se a criação falhar ou o sistema operacional atual não tiver suporte para IDWriteFactory.

AFX_GLOBAL_DATA::InitD2D

Inicializa as fábricas D2D, DirectWrite e WIC. Chame esse método antes que a janela principal seja inicializada.

BOOL InitD2D(
    D2D1_FACTORY_TYPE d2dFactoryType = D2D1_FACTORY_TYPE_SINGLE_THREADED,
    DWRITE_FACTORY_TYPE writeFactoryType = DWRITE_FACTORY_TYPE_SHARED);

Parâmetros

d2dFactoryType
O modelo de threading da fábrica D2D e os recursos que ela cria.

writeFactoryType
Um valor que especifica se o objeto write factory será compartilhado ou isolado

Valor de retorno

Retorna TRUE se as fábricas foram inicializadas; caso contrário, retorna FALSE.

AFX_GLOBAL_DATA::Is32BitIcons

Indica se há suporte para ícones predefinidos de 32 bits.

BOOL Is32BitIcons() const;

Valor de retorno

TRUE se houver suporte para ícones predefinidos de 32 bits; caso contrário, FALSE.

Comentários

Esse método retornará TRUE se a estrutura der suporte a ícones internos de 32 bits e se o sistema operacional der suporte a 16 bits por pixel ou mais e as imagens não forem exibidas em alto contraste.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Indica se o suporte para a Acessibilidade Ativa da Microsoft está habilitado.

BOOL IsAccessibilitySupport() const;

Valor de retorno

TRUE se o suporte à acessibilidade estiver habilitado; caso contrário, FALSE.

Comentários

A Acessibilidade Ativa da Microsoft era a solução usada para tornar os aplicativos acessíveis. A Automação da Interface do Usuário da Microsoft é o novo modelo de acessibilidade do Microsoft Windows e se destina a atender às necessidades de produtos de tecnologia adaptativa e ferramentas de teste automatizadas.

Use o método AFX_GLOBAL_DATA::EnableAccessibilitySupport para habilitar ou desabilitar o suporte à Acessibilidade Ativa.

AFX_GLOBAL_DATA::IsD2DInitialized

Determina se o D2D foi inicializado.

BOOL IsD2DInitialized() const;

Valor de retorno

TRUE se D2D foi inicializado; caso contrário, FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Fornece uma maneira simples de chamar o método DwmIsCompositionEnabled do Windows.

BOOL IsDwmCompositionEnabled();

Valor de retorno

TRUE se a composição do DWM (Gerenciador de Janelas da Área de Trabalho) estiver habilitada; caso contrário, FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Indica se as imagens estão sendo exibidas em alto contraste.

BOOL IsHighContrastMode() const;

Valor de retorno

TRUE se as imagens estiverem exibidas no modo de alto contraste preto ou branco; caso contrário, FALSE.

Comentários

No modo de alto contraste preto, as bordas voltadas para a luz são brancas e a tela de fundo é preta. No modo de alto contraste branco, as bordas voltadas para a luz são pretas e a tela de fundo é branca.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Indica se o sistema operacional dá suporte a janelas em camadas.

BOOL IsWindowsLayerSupportAvailable() const;

Valor de retorno

TRUE se houver suporte para janelas em camadas; caso contrário, FALSE.

Comentários

Se houver suporte para janelas em camadas, os marcadores de encaixe inteligente usarão janelas em camadas.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Indica se a estrutura usa ícones com cores de 32 bits predefinidos ou ícones com uma resolução inferior.

BOOL  m_bUseBuiltIn32BitIcons;

Comentários

TRUE especifica que a estrutura usa ícones de cor de 32 bits; FALSE especifica ícones com resolução inferior. O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como TRUE.

Esse membro deve ser definido na inicialização do aplicativo.

AFX_GLOBAL_DATA::m_bUseSystemFont

Indica se uma fonte do sistema é usada para menus, barras de ferramentas e faixas de opções.

BOOL m_bUseSystemFont;

Comentários

TRUE especifica o uso de uma fonte do sistema; caso contrário, FALSE. O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como FALSE.

Testar esse membro não é a única maneira de a estrutura determinar a fonte a ser usada. O método AFX_GLOBAL_DATA::UpdateFonts também testa fontes padrão e alternativas para determinar quais estilos visuais estão disponíveis para serem aplicados a menus, barras de ferramentas e faixas de opções.

AFX_GLOBAL_DATA::m_hcurHand

Armazena o identificador do cursor de mão.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

Armazena o identificador do cursor de alongamento horizontal.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

Armazena o identificador do cursor de alongamento vertical.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Armazena o identificador do ícone de ferramenta.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Especifica o deslocamento da barra de ferramentas com ocultação automática mais à esquerda na barra de encaixe.

int  m_nAutoHideToolBarMargin;

Comentários

O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como 4 pixels.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Especifica a lacuna entre as barras de ferramentas com ocultação automática.

int   m_nAutoHideToolBarSpacing;

Comentários

O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como 14 pixels.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Especifica a espessura do quadro de arraste usado para indicar o estado encaixado.

int  m_nDragFrameThicknessDock;

Comentários

O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como 3 pixels.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Especifica a espessura do quadro de arraste usado para indicar o estado flutuante.

int  m_nDragFrameThicknessFloat;

Comentários

O construtor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa esse membro como 4 pixels.

AFX_GLOBAL_DATA::OnSettingChange

Detecta o estado atual da animação do menu da área de trabalho e dos recursos com ocultação automática da barra de tarefas.

void OnSettingChange();

Comentários

Esse método define variáveis de estrutura relativas ao estado de determinados atributos da área de trabalho do usuário. Ele detecta o estado atual dos recursos de animação do menu, de desbotamento do menu e da ocultação automática da barra de tarefas.

AFX_GLOBAL_DATA::RegisterWindowClass

Registra a classe da janela do MFC especificada.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Parâmetros

lpszClassNamePrefix
[in] O nome da classe de janela a ser registrada.

Valor de retorno

O nome qualificado da classe registrada se esse método for bem-sucedido; caso contrário, uma exceção de recurso.

Comentários

O valor retornado é uma lista delimitada por dois pontos da cadeia de caracteres do parâmetro lpszClassNamePrefix e as representações de texto hexadecimal dos identificadores da instância do aplicativo atual; o cursor do aplicativo, que é o cursor de seta cujo identificador é IDC_ARROW; e o pincel de segundo plano. Para obter mais informações sobre como registrar classes de janela do MFC, consulte AfxRegisterClass.

AFX_GLOBAL_DATA::Currículo

Reinicializa ponteiros de função interna que acessam métodos que dão suporte a temas e estilos visuais do Windows.

BOOL Resume();

Valor de retorno

TRUE se esse método tiver êxito, caso contrário, FALSE. No modo de depuração, esse método declara se o método não foi bem-sucedido.

Comentários

Esse método é chamado quando a estrutura recebe a mensagem WM_POWERBROADCAST.

AFX_GLOBAL_DATA::SetLayeredAttrib

Fornece uma maneira simples de chamar o método SetLayeredWindowAttributes do Windows.

BOOL SetLayeredAttrib(
    HWND hwnd,
    COLORREF crKey,
    BYTE bAlpha,
    DWORD dwFlags);

Parâmetros

hwnd
[in] Identificador da janela em camadas.

crKey
[in] A chave de cor de transparência que o Gerenciador de Janelas da Área de Trabalho usa para compor a janela em camadas.

bAlpha
[in] O valor alfa usado para descrever a opacidade da janela em camadas.

dwFlags
[in] Uma combinação bit a bit (OR) de sinalizadores que especificam quais parâmetros de método usar. Especifique LWA_COLORKEY para usar o parâmetro crKey como a cor da transparência. Especifique LWA_ALPHA usar o parâmetro bAlpha para determinar a opacidade da janela em camadas.

Valor de retorno

TRUE se esse método tiver êxito, caso contrário, FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Cria a fonte lógica especificada.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Parâmetros

lpLogFont
[in] Ponteiro para uma estrutura que contém os atributos de uma fonte.

bHorz
[in] TRUE para especificar que o texto é executado horizontalmente; FALSE para especificar que é executado verticalmente.

Valor de retorno

TRUE se esse método tiver êxito, caso contrário, FALSE. No modo de depuração, esse método declara se o método não foi bem-sucedido.

Comentários

Esse método cria uma fonte regular horizontal, uma fonte sublinhada e uma fonte em negrito usada em itens de menu padrão. Opcionalmente, ele cria uma fonte vertical regular. Para obter mais informações sobre fontes lógicas, consulte CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateFonts

Reinicializa as fontes lógicas usadas pela estrutura.

void UpdateFonts();

Comentários

Para obter mais informações sobre fontes lógicas, consulte CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Inicializa as cores, a profundidade de cor, os pincéis, as canetas e as imagens que são usados pela estrutura.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Indica se o aplicativo está sendo executado no Windows 7 ou superior.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Especifica a cor de gradiente da legenda ativa. Geralmente, usado para painéis com encaixe.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Especifica a cor de gradiente da legenda inativa. Geralmente, usado para painéis com encaixe.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

Cria e armazena nos dados globais um ponteiro para a interface ITaskBarList.

ITaskbarList *GetITaskbarList();

Valor de retorno

Um ponteiro para a interface ITaskbarList se a criação de um objeto de lista de barras de tarefas for bem-sucedida; NULL se a criação falhar ou se o sistema operacional atual for inferior ao Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

Cria e armazena nos dados globais um ponteiro para a interface ITaskBarList3.

ITaskbarList3 *GetITaskbarList3();

Valor de retorno

Um ponteiro para a interface ITaskbarList3 se a criação de um objeto de lista de barras de tarefas for bem-sucedida; NULL se a criação falhar ou se o sistema operacional atual for inferior ao Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Determina as posições das barras de ocultação automática do Shell.

int GetShellAutohideBars();

Valor de retorno

Um valor inteiro com sinalizadores codificados que especificam posições das barras com ocultação automática. Pode combinar os seguintes valores: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Libera interfaces obtidas por meio dos métodos GetITaskbarList e GetITaskbarList3.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Cria e inicializa um objeto de item de Shell com base na análise de um nome.

HRESULT ShellCreateItemFromParsingName(
    PCWSTR pszPath,
    IBindCtx *pbc,
    REFIID riid,
    void **ppv);

Parâmetros

pszPath
[in] Um ponteiro para um nome de exibição.

pbc
Um ponteiro para um contexto de associação que controla a operação de análise.

riid
Uma referência para uma ID de interface.

ppv
[out] Quando retorna, essa função contém o ponteiro de interface solicitado em riid. Normalmente, será IShellItem ou IShellItem2.

Valor de retorno

Retorna S_OK se tiver êxito; caso contrário, um valor de erro.

Confira também

Gráfico da hierarquia
Estruturas, estilos, retornos de chamada e mapas de mensagem
REFERÊNCIA COLORIDA
Partes e estados
CDC::DrawText
DrawThemeTextEx
Gerenciador de Janelas da Área de Trabalho
Habilitar e controlar a composição do DWM
Automação de interface do usuário e Acessibilidade Ativa da Microsoft
Função GetSysColor
GetSysColorBrush
Estrutura NONCLIENTMETRICS
Classe AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes