Classe CMiniFrameWnd

Rappresenta una finestra cornice di mezza altezza visualizzata in genere intorno alle barre degli strumenti mobili.

Sintassi

class CMiniFrameWnd : public CFrameWnd

Membri

Costruttori pubblici

Nome Descrizione
CMiniFrameWnd::CMiniFrameWnd Costruisce un oggetto CMiniFrameWnd.

Metodi pubblici

Nome Descrizione
CMiniFrameWnd::Create Crea un CMiniFrameWnd oggetto dopo la costruzione.
CMiniFrameWnd::CreateEx Crea un CMiniFrameWnd oggetto (con opzioni aggiuntive) dopo la costruzione.

Osservazioni:

Queste finestre mini-frame si comportano come normali finestre cornice, ad eccezione del fatto che non dispongono di pulsanti o menu per ridurre al minimo/ingrandire e si deve solo fare clic con un solo clic sul menu di sistema per ignorarli.

Per usare un CMiniFrameWnd oggetto , definire prima di tutto l'oggetto . Chiamare quindi la funzione Crea membro per visualizzare la finestra mini-frame.

Per altre informazioni su come usare CMiniFrameWnd gli oggetti, vedere l'articolo Ancoraggio e barre degli strumenti mobili.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Requisiti

Intestazione: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

Costruisce un CMiniFrameWnd oggetto , ma non crea la finestra.

CMiniFrameWnd();

Osservazioni:

Per creare la finestra, chiamare CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Crea la finestra mini-frame di Windows e la collega all'oggetto CMiniFrameWnd .

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parametri

lpClassName
Punta a una stringa di caratteri con terminazione Null che denomina la classe Windows. Il nome della classe può essere qualsiasi nome registrato con la funzione AfxRegisterWndClass globale. Se NULL, la classe window verrà registrata automaticamente dal framework. MFC fornisce alla classe predefinita gli stili e gli attributi seguenti:

  • Imposta il bit di stile CS_DBLCLKS, che invia messaggi di doppio clic alla routine della finestra quando l'utente fa doppio clic sul mouse.

  • Imposta i bit di stile CS_HREDRAW e CS_VREDRAW, che indirizzano il contenuto dell'area client da ridisegnare quando la finestra cambia dimensione.

  • Imposta il cursore della classe sul IDC_ARROW standard di Windows.

  • Imposta il pennello di sfondo della classe su NULL, quindi la finestra non cancellerà lo sfondo.

  • Imposta l'icona della classe sull'icona del logo Windows standard con contrassegno ondulato.

  • Imposta la finestra sulla dimensione e la posizione predefinite, come indicato da Windows.

lpWindowName
Punta a una stringa di caratteri con terminazione Null che contiene il nome della finestra.

dwStyle
Specifica gli attributi dello stile della finestra. Questi possono includere stili di finestra standard e uno o più degli stili speciali seguenti:

  • MFS_MOVEFRAME Consente di spostare la finestra con mini-frame facendo clic su qualsiasi bordo della finestra, non solo sulla didascalia.

  • MFS_4THICKFRAME Disabilita il ridimensionamento della finestra mini-frame.

  • MFS_SYNCACTIVE Sincronizza l'attivazione della finestra mini-frame con l'attivazione della finestra padre.

  • MFS_THICKFRAME Consente di ridimensionare la finestra mini-frame come il contenuto dell'area client consentito.

  • MFS_BLOCKSYSMENU Disabilita l'accesso al menu di sistema e al menu di controllo e li converte in parte della didascalia (barra del titolo).

Per una descrizione dei possibili valori dello stile di finestra, vedere CWnd::Create . La combinazione tipica usata per le finestre con mini frame è WS_POPUP|WS_CAPTION|WS_SYSMENU.

rect
Struttura RECT che specifica le dimensioni desiderate della finestra.

pParentWnd
Punta alla finestra padre. Usare NULL per le finestre di primo livello.

nID
Se la finestra mini-frame viene creata come finestra figlio, questo è l'identificatore del controllo figlio; in caso contrario, 0.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Create inizializza il nome della classe e il nome della finestra della finestra e registra i valori predefiniti per lo stile e l'elemento padre.

CMiniFrameWnd::CreateEx

Crea un oggetto CMiniFrameWnd.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parametri

dwExStyle
Specifica lo stile esteso dell'oggetto CMiniFrameWnd creato. Applicare uno qualsiasi degli stili della finestra estesa alla finestra.

lpClassName
Punta a una stringa di caratteri con terminazione Null che denomina la classe Windows (una struttura WNDCLASS ). Il nome della classe può essere qualsiasi nome registrato con la funzione AfxRegisterWndClass globale o uno qualsiasi dei nomi predefiniti della classe di controllo. Non deve essere NULL.

lpWindowName
Punta a una stringa di caratteri con terminazione Null che contiene il nome della finestra.

dwStyle
Specifica gli attributi dello stile della finestra. Per una descrizione dei valori possibili, vedere Stili finestra e CWnd::Create.

rect
Dimensioni e posizione della finestra, nelle coordinate client di pParentWnd.

pParentWnd
Punta all'oggetto finestra padre.

nID
Identificatore della finestra figlio.

Valore restituito

Restituisce TRUE in caso di esito positivo, FALSE in caso di errore.

Osservazioni:

I CreateEx parametri specificano la posizione iniziale WNDCLASS, lo stile della finestra e (facoltativamente) la posizione e le dimensioni iniziali della finestra. CreateEx specifica anche l'elemento padre della finestra (se presente) e l'ID.

Quando CreateEx viene eseguito, Windows invia i messaggi WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE e WM_CREATE alla finestra.

Per estendere la gestione predefinita dei messaggi, derivare una classe da CMiniFrameWnd, aggiungere una mappa messaggi alla nuova classe e fornire funzioni membro per i messaggi precedenti. Eseguire l'override OnCreate, ad esempio, per eseguire l'inizializzazione necessaria per una nuova classe.

Eseguire l'override di altri Ongestori messaggi del messaggio per aggiungere altre funzionalità alla classe derivata.

Se viene specificato lo stile WS_VISIBLE, Windows invia alla finestra tutti i messaggi necessari per attivare e visualizzare la finestra. Se lo stile della finestra specifica una barra del titolo, il titolo della finestra a cui punta il parametro lpszWindowName viene visualizzato nella barra del titolo.

Il parametro dwStyle può essere qualsiasi combinazione di stili di finestra.

Le finestre della casella degli strumenti della casella degli strumenti di stile precedente non sono più supportate. Lo stile precedente, che non dispone di un pulsante di chiusura "X", è stato supportato durante l'esecuzione di un'applicazione MFC nelle versioni precedenti di Windows, ma non è più supportato in Visual C++.NET. È ora supportato solo il nuovo stile WS_EX_TOOLWINDOW; per una descrizione di questo stile, vedere Stili finestra estesa.

Vedi anche

Classe CFrameWnd
Grafico della gerarchia
Classe CFrameWnd