Struttura AFX_GLOBAL_DATA

La struttura AFX_GLOBAL_DATA contiene i campi e i metodi usati per gestire il framework o per personalizzare l'aspetto e il comportamento dell'applicazione.

Sintassi

struct AFX_GLOBAL_DATA

Membri

Costruttori pubblici

Nome	Descrizione
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA	Costruisce una struttura AFX_GLOBAL_DATA .
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA	Distruttore.

Metodi pubblici

Nome	Descrizione
AFX_GLOBAL_DATA::CleanUp	Rilascia le risorse allocate dal framework, ad esempio pennelli, tipi di carattere e DLL.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	Crea una trasformazione di rotazione che ruota di un angolo specificato intorno a un punto definito.
AFX_GLOBAL_DATA::D rawParentBackground	Disegna lo sfondo dell'elemento padre di un controllo nell'area specificata.
AFX_GLOBAL_DATA::D rawTextOnGlass	Disegna il testo specificato nello stile di visualizzazione del tema specificato.
AFX_GLOBAL_DATA::ExcludeTag	Rimuove la coppia di tag XML specificata da un determinato buffer.
AFX_GLOBAL_DATA::GetColor	Recupera il colore corrente dell'elemento dell'interfaccia utente specificato.
AFX_GLOBAL_DATA::GetDirect2dFactory	Restituisce un puntatore all'interfaccia ID2D1Factory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.
AFX_GLOBAL_DATA::GetHandCursor	Recupera il cursore predefinito che rappresenta una mano e il cui identificatore è IDC_HAND.
AFX_GLOBAL_DATA::GetITaskbarList	Crea e archivia nei dati globali un puntatore all'interfaccia ITaskBarList.
AFX_GLOBAL_DATA::GetITaskbarList3	Crea e archivia nei dati globali un puntatore all'interfaccia ITaskBarList3.
AFX_GLOBAL_DATA::GetNonClientMetrics	Recupera la metrica associata all'area non client delle finestre non ridotte a icona.
AFX_GLOBAL_DATA::GetShellAutohideBars	Determina le posizioni delle barre della Shell che si nascondono automaticamente.
AFX_GLOBAL_DATA::GetTextHeight	Recupera l'altezza dei caratteri di testo nel tipo di carattere corrente.
AFX_GLOBAL_DATA::GetWICFactory	Restituisce un puntatore all'interfaccia IWICImagingFactory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.
AFX_GLOBAL_DATA::GetWriteFactory	Restituisce un puntatore all'interfaccia IDWriteFactory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.
AFX_GLOBAL_DATA::InitD2D	Inizializza le factory D2D, DirectWritee WIC . Chiamare questo metodo prima dell'inizializzazione della finestra principale.
AFX_GLOBAL_DATA::Is32BitIcons	Indica se sono supportate le icone a 32 bit predefinite.
AFX_GLOBAL_DATA::IsD2DInitialized	Determina se la factory D2D è stata inizializzata.
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Offre un modo semplice per chiamare il metodo DwmIsCompositionEnabled di Windows.
AFX_GLOBAL_DATA::IsHighContrastMode	Indica se le immagini sono attualmente visualizzate con contrasto elevato.
AFX_GLOBAL_DATA::OnSettingChange	Rileva lo stato corrente delle funzionalità di animazione del menu del desktop e della barra delle applicazioni che si nasconde automaticamente.
AFX_GLOBAL_DATA::RegisterWindowClass	Registra la classe di finestre MFC specificata.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Rilascia le interfacce ottenute tramite i metodi GetITaskbarList e GetITaskbarList3.
AFX_GLOBAL_DATA::Resume	Reinizializza i puntatori a funzione interna che hanno accesso ai metodi che supportano temi e stili di visualizzazionedi Windows.
AFX_GLOBAL_DATA::SetLayeredAttrib	Offre un modo semplice per chiamare il metodo SetLayeredWindowAttributes di Windows.
AFX_GLOBAL_DATA::SetMenuFont	Crea il tipo di carattere logico specificato.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	Crea e inizializza un oggetto Shell da un nome di analisi.
AFX_GLOBAL_DATA::UpdateFonts	Reinizializza i tipi di carattere logici usati dal framework.
AFX_GLOBAL_DATA::UpdateSysColors	Inizializza i colori, l'intensità di colore, i pennelli, le penne e le immagini usati dal framework.

Metodi protetti

Nome	Descrizione
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Abilita o disabilita il supporto di Microsoft Active Accessibility. In Active Accessibility sono disponibili metodi affidabili per l'esposizione di informazioni sugli elementi dell'interfaccia utente.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Indica se il supporto di Microsoft Active Accessibility è abilitato.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	Indica se il sistema operativo supporta le finestre sovrapposte.

Membri dei dati

Nome	Descrizione
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	Indica se il sistema operativo corrente supporta la fusione alfa.
AFX_GLOBAL_DATA::bIsWindows7	Indica se l'applicazione è in esecuzione in un sistema operativo Windows 7 o versione successiva.
AFX_GLOBAL_DATA::clrActiveCaptionGradient	Specifica il colore sfumato della didascalia attiva. Viene in genere usato per i riquadri ancorabili.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	Specifica il colore sfumato della didascalia inattiva. Viene in genere usato per i riquadri ancorabili.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	Indica se il framework usa icone predefinite con colori a 32 bit o icone con una risoluzione più bassa.
AFX_GLOBAL_DATA::m_bUseSystemFont	Indica se un tipo di carattere di sistema viene usato per i menu, le barre degli strumenti e le barre multifunzione.
AFX_GLOBAL_DATA::m_hcurHand	Archivia l'handle per il cursore a forma di mano.
AFX_GLOBAL_DATA::m_hcurStretch	Archivia l'handle per il cursore di adattamento orizzontale.
AFX_GLOBAL_DATA::m_hcurStretchVert	Archivia l'handle per il cursore di adattamento verticale.
AFX_GLOBAL_DATA::m_hiconTool	Archivia l'handle per l'icona dello strumento.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	Specifica l'offset dalla barra degli strumenti che si nasconde automaticamente più a sinistra nel lato sinistro della barra ancorabile.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	Specifica la distanza tra le barre degli strumenti che si nascondono automaticamente.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	Specifica lo spessore del frame di trascinamento usato per comunicare lo stato ancorato.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	Specifica lo spessore del frame di trascinamento usato per comunicare lo stato mobile.

Osservazioni:

La maggior parte dei dati della struttura AFX_GLOBAL_DATA viene inizializzata all'avvio dell'applicazione.

Gerarchia di ereditarietà

AFX_GLOBAL_DATA

Requisiti

Intestazione: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Indica se il sistema operativo supporta la fusione alfa.

BOOL  bIsOSAlphaBlendingSupport;

Osservazioni:

TRUE indica che la fusione alfa è supportata; in caso contrario, FALSE.

AFX_GLOBAL_DATA::CleanUp

Rilascia le risorse allocate dal framework, ad esempio pennelli, tipi di carattere e DLL.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Crea una trasformazione di rotazione che ruota di un angolo specificato intorno a un punto definito.

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

Parametri

angolo
Angolo di rotazione in senso orario, espresso in gradi.

centro
Punto su cui ruotare.

matrice
Quando termina, questo metodo contiene la nuova trasformazione di rotazione. È necessario allocare spazio di archiviazione per questo parametro.

Valore restituito

Restituisce S_OK in caso di esito positivo o un valore di errore in caso contrario.

AFX_GLOBAL_DATA::D rawParentBackground

Disegna lo sfondo dell'elemento padre di un controllo nell'area specificata.

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

Parametri

pWnd
[in] Puntatore alla finestra di un controllo.

pDC
[in] Puntatore a un contesto di dispositivo.

lpRect
[in] Puntatore a un rettangolo che delimita l'area da disegnare. Il valore predefinito è NULL.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

AFX_GLOBAL_DATA::D rawTextOnGlass

Disegna il testo specificato nello stile di visualizzazione del tema specificato.

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

Parametri

hTheme
[in] Handle per i dati del tema di una finestra o NULL. Il framework usa il tema specificato per disegnare il testo se questo parametro non è NULL e i temi sono supportati. In caso contrario, il framework non usa un tema per disegnare il testo.

Utilizzare il metodo OpenThemeData per creare un HTHEME.

pDC
[in] Puntatore a un contesto di dispositivo.

iPartId
[in] Parte del controllo con l'aspetto del testo desiderato. Per altre informazioni vedere la colonna Parti della tabella in Parti e stati. Se questo valore è 0, il testo viene disegnato nel tipo di carattere predefinito o in un tipo di carattere selezionato nel contesto di dispositivo.

iStateId
[in] Stato del controllo con l'aspetto del testo desiderato. Per altre informazioni vedere la colonna Stati della tabella in Parti e stati.

strText
[in] Testo da disegnare.

rect
[in] Limite dell'area in cui viene disegnato il testo specificato.

dwFlags
[in] Combinazione bit per bit (OR) di flag che specificano la modalità di disegno del testo specificato.

Se il parametro hTheme è NULL o se i temi non sono supportati e abilitati, il parametro nFormat del metodo CDC::D rawText descrive i flag validi. Se i temi sono supportati, il parametro dwFlags del metodo DrawThemeTextEx descrive i flag validi.

nGlowSize
[in] Dimensione di un effetto alone disegnato sullo sfondo prima di disegnare il testo specificato. Il valore predefinito è 0.

clrText
[in] Colore in cui viene disegnato il testo specificato. Il valore predefinito è il colore predefinito.

Valore restituito

TRUE se viene utilizzato un tema per disegnare il testo specificato; in caso contrario, FALSE.

Osservazioni:

Un tema definisce lo stile di visualizzazione di un'applicazione. Un tema non viene utilizzato per disegnare il testo se il parametro hTheme è NULL o se il metodo DrawThemeTextEx non è supportato o se la composizione di Desktop Window Manager (DWM) è disabilitata.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Abilita o disabilita il supporto di Microsoft Active Accessibility.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Parametri

bEnable
[in] TRUE per abilitare il supporto per l'accessibilità; FALSE per disabilitare il supporto per l'accessibilità. Il valore predefinito è TRUE.

Osservazioni:

L'accessibilità attiva è una tecnologia basata su COM che migliora il modo in cui i programmi e il sistema operativo Windows lavorano insieme ai prodotti di Assistive Technology. Fornisce metodi affidabili per l'esposizione di informazioni sugli elementi dell'interfaccia utente. Tuttavia, è ora disponibile un nuovo modello di accessibilità denominato Automazione dell'interfaccia utente Microsoft. Per un confronto delle due tecnologie, vedere Automazione interfaccia utente e Microsoft Active Accessibility.

Usare il metodo AFX_GLOBAL_DATA::IsAccessibilitySupport per determinare se il supporto di Microsoft Active Accessibility è abilitato.

AFX_GLOBAL_DATA::ExcludeTag

Rimuove la coppia di tag XML specificata da un determinato buffer.

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

Parametri

strBuffer
[in] Buffer di testo.

lpszTag
[in] Nome di una coppia di tag XML di apertura e chiusura.

strTag
[out] Quando termina, il parametro strTag contiene il testo compreso tra i tag XML di apertura e chiusura denominati dal parametro lpszTag . Qualsiasi spazio vuoto iniziale o finale viene tagliato dal risultato.

bIsCharsList
[in] TRUE per convertire i simboli per i caratteri di escape nel parametro strTag in caratteri di escape effettivi; FALSE non per eseguire la conversione. Il valore predefinito è FALSE. Per altre informazioni, vedere la sezione Note.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Una coppia di tag XML è costituita da tag di apertura e chiusura denominati che indicano l'inizio e la fine di una sequenza di testo nel buffer specificato. Il parametro strBuffer specifica il buffer e il parametro lpszTag specifica il nome dei tag XML.

Usare i simboli nella tabella seguente per codificare un set di caratteri di escape nel buffer specificato. Specificare TRUE per il parametro bIsCharsList per convertire i simboli nel parametro strTag in caratteri di escape effettivi. Nella tabella seguente viene utilizzata la macro _T() per specificare i simboli e le stringhe di caratteri di escape.

Simbolo	Carattere di 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 il colore corrente dell'elemento dell'interfaccia utente specificato.

COLORREF GetColor(int nColor);

Parametri

nColor
[in] Valore che specifica un elemento dell'interfaccia utente il cui colore viene recuperato. Per un elenco di valori validi, vedere il parametro nIndex del metodo GetSysColor .

Valore restituito

Valore di colore RGB dell'elemento dell'interfaccia utente specificato. Per altre informazioni, vedere la sezione Note.

Osservazioni:

Se il parametro nColor non è compreso nell'intervallo, il valore restituito è zero. Poiché anche zero è un valore RGB valido, non è possibile utilizzare questo metodo per determinare se un colore di sistema è supportato dal sistema operativo corrente. Usare invece il metodo GetSysColorBrush , che restituisce NULL se il colore non è supportato.

AFX_GLOBAL_DATA::GetDirect2dFactory

Restituisce un puntatore all'interfaccia ID2D1Factory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.

ID2D1Factory* GetDirect2dFactory();

Valore restituito

Puntatore all'interfaccia ID2D1Factory se la creazione di una factory ha esito positivo oppure NULL se la creazione non riesce o il sistema operativo corrente non supporta D2D.

AFX_GLOBAL_DATA::GetHandCursor

Recupera il cursore predefinito simile a una mano e il cui identificatore è IDC_HAND.

HCURSOR GetHandCursor();

Valore restituito

Handle del cursore della mano.

AFX_GLOBAL_DATA::GetNonClientMetrics

Recupera la metrica associata all'area non client delle finestre non ridotte a icona.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Parametri

info
[in, out] Struttura NONCLIENTMETRICS che contiene le metriche scalabili associate all'area non client di una finestra non ridotta a icona.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Recupera l'altezza dei caratteri di testo nel tipo di carattere corrente.

int GetTextHeight(BOOL bHorz = TRUE);

Parametri

bHorz
[in] TRUE per recuperare l'altezza dei caratteri quando il testo viene eseguito orizzontalmente; FALSE per recuperare l'altezza dei caratteri quando il testo viene eseguito verticalmente. Il valore predefinito è TRUE.

Valore restituito

Altezza del tipo di carattere corrente, misurata dal relativo ascendente al relativo discendente.

AFX_GLOBAL_DATA::GetWICFactory

Restituisce un puntatore all'interfaccia IWICImagingFactory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.

IWICImagingFactory* GetWICFactory();

Valore restituito

Puntatore all'interfaccia IWICImagingFactory se la creazione di una factory ha esito positivo o NULL se la creazione non riesce o il sistema operativo corrente non dispone del supporto wic.

AFX_GLOBAL_DATA::GetWriteFactory

Restituisce un puntatore all'interfaccia IDWriteFactory archiviata nei dati globali. Se l'interfaccia non è inizializzata, viene creata con i parametri predefiniti.

IDWriteFactory* GetWriteFactory();

Valore restituito

Puntatore all'interfaccia IDWriteFactory se la creazione di una factory ha esito positivo oppure NULL se la creazione non riesce o il sistema operativo corrente non dispone del supporto directWrite.

AFX_GLOBAL_DATA::InitD2D

Inizializza le factory D2D, DirectWrite e WIC. Chiamare questo metodo prima dell'inizializzazione della finestra principale.

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

Parametri

d2dFactoryType
Modello di threading della factory D2D e delle risorse create.

writeFactoryType
Valore che specifica se l'oggetto factory di scrittura verrà condiviso o isolato

Valore restituito

Restituisce TRUE se le factory erano intilalizrd, FALSE; in caso contrario,

AFX_GLOBAL_DATA::Is32BitIcons

Indica se sono supportate le icone a 32 bit predefinite.

BOOL Is32BitIcons() const;

Valore restituito

TRUE se sono supportate icone a 32 bit predefinite; in caso contrario, FALSE.

Osservazioni:

Questo metodo restituisce TRUE se il framework supporta icone predefinite a 32 bit e se il sistema operativo supporta 16 bit per pixel o più e se le immagini non vengono visualizzate a contrasto elevato.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Indica se il supporto di Microsoft Active Accessibility è abilitato.

BOOL IsAccessibilitySupport() const;

Valore restituito

TRUE se il supporto per l'accessibilità è abilitato; in caso contrario, FALSE.

Osservazioni:

Microsoft Active Accessibility era la soluzione precedente per rendere accessibili le applicazioni. Automazione interfaccia utente Microsoft è il nuovo modello di accessibilità per Microsoft Windows ed è progettato per soddisfare le esigenze dei prodotti assistive technology e degli strumenti di test automatizzati.

Usare il metodo AFX_GLOBAL_DATA::EnableAccessibilitySupport per abilitare o disabilitare il supporto per l'accessibilità attiva.

AFX_GLOBAL_DATA::IsD2DInitialized

Determina se il D2D è stato inizializzato

BOOL IsD2DInitialized() const;

Valore restituito

TRUE se D2D è stato inizializzato; in caso contrario FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Offre un modo semplice per chiamare il metodo DwmIsCompositionEnabled di Windows.

BOOL IsDwmCompositionEnabled();

Valore restituito

TRUE se la composizione di Desktop Window Manager (DWM) è abilitata; in caso contrario, FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Indica se le immagini sono attualmente visualizzate con contrasto elevato.

BOOL IsHighContrastMode() const;

Valore restituito

TRUE se le immagini sono attualmente visualizzate in modalità a contrasto elevato nero o bianco; in caso contrario, FALSE.

Osservazioni:

In modalità a contrasto elevato nero, i bordi che si affacciano sulla luce sono bianchi e lo sfondo è nero. In modalità a contrasto elevato bianco, i bordi che si affacciano sulla luce sono neri e lo sfondo è bianco.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Indica se il sistema operativo supporta le finestre sovrapposte.

BOOL IsWindowsLayerSupportAvailable() const;

Valore restituito

TRUE se le finestre a più livelli sono supportate; in caso contrario, FALSE.

Osservazioni:

Se sono supportate finestre a più livelli, gli indicatori di ancoraggio intelligente usano finestre a più livelli.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Indica se il framework usa icone predefinite con colori a 32 bit o icone con una risoluzione più bassa.

BOOL  m_bUseBuiltIn32BitIcons;

Osservazioni:

TRUE specifica che il framework usa icone a colori a 32 bit; FALSE specifica le icone a risoluzione inferiore. Il AFX_GLOBAL_DATA::AFX_GLOBAL_DATA costruttore inizializza questo membro su TRUE.

Questo membro deve essere impostato all'avvio dell'applicazione.

AFX_GLOBAL_DATA::m_bUseSystemFont

Indica se un tipo di carattere di sistema viene usato per i menu, le barre degli strumenti e le barre multifunzione.

BOOL m_bUseSystemFont;

Osservazioni:

TRUE specifica di utilizzare un tipo di carattere di sistema; in caso contrario, FALSE. Il AFX_GLOBAL_DATA::AFX_GLOBAL_DATA costruttore inizializza il membro su FALSE.

Il test di questo membro non è l'unico modo per determinare il tipo di carattere da usare. Il AFX_GLOBAL_DATA::UpdateFonts metodo testa anche i tipi di carattere predefiniti e alternativi per determinare quali stili di visualizzazione sono disponibili per essere applicati a menu, barre degli strumenti e barre multifunzione.

AFX_GLOBAL_DATA::m_hcurHand

Archivia l'handle per il cursore a forma di mano.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

Archivia l'handle per il cursore di adattamento orizzontale.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

Archivia l'handle per il cursore di adattamento verticale.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Archivia l'handle per l'icona dello strumento.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Specifica l'offset dalla barra degli strumenti a scomparsa automatica che si trova più a sinistra al lato sinistro della barra ancorabile a schede.

int  m_nAutoHideToolBarMargin;

Osservazioni:

Il costruttore AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inizializza il membro a 4 pixel.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Specifica la distanza tra le barre degli strumenti che si nascondono automaticamente.

int   m_nAutoHideToolBarSpacing;

Osservazioni:

Il AFX_GLOBAL_DATA::AFX_GLOBAL_DATA costruttore inizializza questo membro a 14 pixel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Specifica lo spessore del frame di trascinamento utilizzato per indicare lo stato ancorato.

int  m_nDragFrameThicknessDock;

Osservazioni:

Il AFX_GLOBAL_DATA::AFX_GLOBAL_DATA costruttore inizializza il membro in 3 pixel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Specifica lo spessore del frame di trascinamento utilizzato per indicare lo stato mobile.

int  m_nDragFrameThicknessFloat;

Osservazioni:

Il costruttore AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inizializza il membro a 4 pixel.

AFX_GLOBAL_DATA::OnSettingChange

Rileva lo stato corrente delle funzionalità di animazione del menu del desktop e della barra delle applicazioni che si nasconde automaticamente.

void OnSettingChange();

Osservazioni:

Questo metodo imposta le variabili del framework sullo stato di determinati attributi del desktop dell'utente. Questo metodo rileva lo stato corrente dell'animazione del menu, della dissolvenza del menu e delle funzionalità di visualizzazione automatica della barra delle applicazioni.

AFX_GLOBAL_DATA::RegisterWindowClass

Registra la classe di finestre MFC specificata.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Parametri

lpszClassNamePrefix
[in] Nome della classe della finestra da registrare.

Valore restituito

Nome completo della classe registrata se questo metodo ha esito positivo; in caso contrario, un'eccezione di risorsa.

Osservazioni:

Il valore restituito è un elenco delimitato da due punti della stringa del parametro lpszClassNamePrefix e le rappresentazioni di testo esadecimali degli handle dell'istanza dell'applicazione corrente, il cursore dell'applicazione, ovvero il cursore freccia il cui identificatore è IDC_ARROW e il pennello di sfondo. Per altre informazioni sulla registrazione delle classi di finestre MFC, vedere AfxRegisterClass.

AFX_GLOBAL_DATA::Resume

Reinizializza i puntatori a funzione interna che hanno accesso ai metodi che supportano temi e stili di visualizzazionedi Windows.

BOOL Resume();

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE. In modalità di debug, questo metodo asserisce se questo metodo non riesce.

Osservazioni:

Questo metodo viene chiamato quando il framework riceve il messaggio di WM_POWERBROADCAST .

AFX_GLOBAL_DATA::SetLayeredAttrib

Offre un modo semplice per chiamare il metodo SetLayeredWindowAttributes di Windows.

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

Parametri

hwnd
[in] Handle per la finestra a più livelli.

crKey
[in] Chiave colore trasparenza usata da Desktop Window Manager per comporre la finestra a più livelli.

bAlpha
[in] Valore alfa utilizzato per descrivere l'opacità della finestra a più livelli.

dwFlags
[in] Combinazione bit per bit (OR) di flag che specificano i parametri del metodo da usare. Specificare LWA_COLORKEY per usare il parametro crKey come colore di trasparenza. Specificare LWA_ALPHA per usare il parametro bAlpha per determinare l'opacità della finestra a più livelli.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Crea il tipo di carattere logico specificato.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Parametri

lpLogFont
[in] Puntatore a una struttura che contiene gli attributi di un tipo di carattere.

bHorz
[in] TRUE per specificare che il testo viene eseguito orizzontalmente; FALSE per specificare che il testo viene eseguito verticalmente.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario, FALSE. In modalità di debug, questo metodo asserisce se questo metodo non riesce.

Osservazioni:

Questo metodo crea un tipo di carattere regolare orizzontale, un tipo di carattere sottolineato e un carattere in grassetto utilizzato nelle voci di menu predefinite. Questo metodo crea facoltativamente un tipo di carattere verticale normale. Per altre informazioni sui tipi di carattere logici, vedere CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateFonts

Reinizializza i tipi di carattere logici usati dal framework.

void UpdateFonts();

Osservazioni:

Per altre informazioni sui tipi di carattere logici, vedere CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Inizializza i colori, l'intensità di colore, i pennelli, le penne e le immagini usati dal framework.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Indica se l'applicazione viene eseguita in Windows 7 o versione successiva.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Specifica il colore sfumato della didascalia attiva. Viene in genere usato per i riquadri ancorabili.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Specifica il colore sfumato della didascalia inattiva. Viene in genere usato per i riquadri ancorabili.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

Crea e archivia nei dati globali un puntatore all'interfaccia ITaskBarList .

ITaskbarList *GetITaskbarList();

Valore restituito

Puntatore all'interfaccia ITaskbarList se la creazione di un oggetto elenco barra delle applicazioni ha esito positivo; NULL se la creazione non riesce o se il sistema operativo corrente è minore di Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

Crea e archivia nei dati globali un puntatore all'interfaccia ITaskBarList3 .

ITaskbarList3 *GetITaskbarList3();

Valore restituito

Puntatore all'interfaccia ITaskbarList3 se la creazione di un oggetto elenco barra delle applicazioni ha esito positivo; NULL se la creazione non riesce o se il sistema operativo corrente è minore di Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Determina le posizioni delle barre della Shell che si nascondono automaticamente.

int GetShellAutohideBars();

Valore restituito

Valore intero con flag codificati che specificano le posizioni delle barre nascoste automaticamente. Può combinare i valori seguenti: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Rilascia le interfacce ottenute tramite i GetITaskbarList metodi e GetITaskbarList3 .

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Crea e inizializza un oggetto Shell da un nome di analisi.

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

Parametri

pszPath
[in] Puntatore a un nome visualizzato.

Pbc
Puntatore a un contesto di associazione che controlla l'operazione di analisi.

riid
Riferimento a un ID di interfaccia.

ppv
[out] Quando questa funzione viene restituita, contiene il puntatore dell'interfaccia richiesto in riid. In genere IShellItem sarà o IShellItem2.

Valore restituito

Restituisce S_OK se ha esito positivo; un valore di errore in caso contrario.

Vedi anche

Grafico della gerarchia
Strutture, stili, callback e mappe messaggi
COLORREF
Parti e stati
CDC::D rawText
DrawThemeTextEx
Gestione finestre desktop
Abilitare e controllare la composizione DWM
Automazione interfaccia utente e Microsoft Active Accessibility
Funzione GetSysColor
GetSysColorBrush
Struttura NONCLIENTMETRICS
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes