Classe CMDIChildWndEx

Articolo
08/04/2024

La CMDIChildWndEx classe fornisce la funzionalità di una finestra figlio MDI (Multiple Document Interface) di Windows. Estende la funzionalità della classe CMDIChildWnd. Il framework richiede questa classe quando un'applicazione MDI utilizza determinate classi MFC.

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMDIChildWndEx : public CMDIChildWnd

Membri

Metodi pubblici

Nome	Descrizione
CMDIChildWndEx::ActivateTopLevelFrame	Chiamato internamente dal framework per attivare il frame di primo livello quando l'applicazione deve essere attivata da una scheda della barra delle applicazioni.
`CMDIChildWndEx::AddDockSite`	Questo metodo non viene usato o implementato.
CMDIChildWndEx::AddPane	Aggiunge un riquadro.
CMDIChildWndEx::AddTabbedPane	Aggiunge un riquadro a schede.
CMDIChildWndEx::AdjustDockingLayout	Regola il layout di ancoraggio.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Indica al framework se questo figlio MDI può essere visualizzato nelle schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::CanShowOnWindowsList	Restituisce TRUE se il nome della finestra figlio MDI può essere visualizzato nella finestra di dialogo Classe CMFCWindowsManagerDialog. In caso contrario restituisce FALSE.
`CMDIChildWndEx::CreateObject`	Chiamato dal framework per creare un'istanza dinamica di questo tipo di classe.
CMDIChildWndEx::D ockPane	Ancora un riquadro.
CMDIChildWndEx::D ockPaneLeftOf	Ancora un riquadro a sinistra di un altro riquadro.
CMDIChildWndEx::EnableAutoHidePanes	Abilita la modalità nascondi automaticamente per i riquadri quando vengono ancorati ai lati specificati della finestra.
CMDIChildWndEx::EnableDocking	Abilita l'ancoraggio della finestra figlio al frame principale.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Abilita o disabilita la selezione automatica di una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Restituisce il nome del documento visualizzato nella finestra figlio MDI.
CMDIChildWndEx::GetFrameIcon	Chiamato dal framework per recuperare l'icona della finestra figlio MDI.
CMDIChildWndEx::GetFrameText	Chiamato dal framework per recuperare il testo per la finestra figlio MDI.
CMDIChildWndEx::GetPane	Trova un riquadro in base all'ID di controllo specificato.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Restituisce un puntatore a un riquadro di ancoraggio incorporato convertito in un documento a schede.
CMDIChildWndEx::GetTabProxyWnd	Restituisce la finestra proxy scheda effettivamente registrata con le schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd	Chiamato dal framework quando deve ottenere una finestra figlio (in genere una finestra di visualizzazione o di divisione) da visualizzare nell'anteprima della scheda della barra delle applicazioni di Windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Chiamato dal framework quando è necessario selezionare una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.
`CMDIChildWndEx::GetThisClass`	Chiamato dal framework per ottenere un puntatore all'oggetto CRuntimeClass associato a questo tipo di classe.
CMDIChildWndEx::GetToolbarButtonToolTipText	Chiamato dal framework per recuperare una descrizione comando per un pulsante della barra degli strumenti.
CMDIChildWndEx::InsertPane	Registra il riquadro specificato con il gestore di ancoraggio.
CMDIChildWndEx::InvalidateIconicBitmaps	Invalida la rappresentazione bitmap iconica dell'elemento figlio MDI.
CMDIChildWndEx::IsPointNearDockSite	Determina se un punto specificato si trova vicino al sito di ancoraggio.
CMDIChildWndEx::IsReadOnly	Restituisce TRUE se il documento visualizzato nella finestra figlio è di sola lettura. In caso contrario restituisce FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Restituisce TRUE se l'elemento figlio MDI è stato registrato correttamente con le schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::IsTabbedPane	Restituisce TRUE se la finestra figlio MDI contiene un riquadro di ancoraggio. In caso contrario restituisce FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Indica se l'elemento figlio MDI può essere visualizzato nelle schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Indica se la selezione automatica di una parte dell'area client di una finestra da visualizzare come l'anteprima della finestra nella barra delle applicazioni è abilitata o disabilitata.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Combinazione di flag, che viene passata dal framework al metodo SetTaskbarTabProperties, quando viene registrata una scheda (figlio MDI) con le schede della barra delle applicazioni di Windows 7. La combinazione predefinita è `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Chiamato dal framework quando deve ottenere una bitmap per l'anteprima dinamica del figlio MDI.
CMDIChildWndEx::OnGetIconicThumbnail	Chiamato dal framework quando deve ottenere una bitmap per l'icona dell'anteprima figlio MDI.
CMDIChildWndEx::OnMoveMiniFrame	Chiamato dal framework per spostare una finestra mini-frame.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Chiamato dal framework quando l'utente preme il pulsante di chiusura nell'anteprima della scheda della barra delle applicazioni.
CMDIChildWndEx::OnSetPreviewMode	Chiamato dal framework per attivare o uscire dalla modalità di anteprima di stampa.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Chiamato dal framework quando l'anteprima della scheda della barra delle applicazioni deve elaborare WM_ACTIVATE messaggio.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Chiamato dal framework quando l'anteprima della scheda della barra delle applicazioni deve elaborare WM_MOUSEACTIVATE messaggio.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Chiamato dal framework quando deve estendere una bitmap per l'anteprima della scheda della scheda della barra delle applicazioni di Windows 7 dell'elemento figlio MDI.
CMDIChildWndEx::OnUpdateFrameTitle	Chiamato dal framework per aggiornare il titolo del frame. Esegue l'override di `CMDIChildWnd::OnUpdateFrameTitle`.
CMDIChildWndEx::P aneFromPoint	Restituisce il riquadro che contiene il punto specificato.
`CMDIChildWndEx::PreTranslateMessage`	Usato dalla classe CWinApp per convertire i messaggi della finestra prima che vengano inviati alle funzioni Windows TranslateMessage e DispatchMessage . Esegue l'override di CWnd::PreTranslateMessage.
CMDIChildWndEx::RecalcLayout	Ricalcola il layout della finestra.
CMDIChildWndEx::RegisterTaskbarTab	Registra un figlio MDI con le schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager	Rimuove un riquadro dal gestore di ancoraggio.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Attiva la scheda corrispondente della barra delle applicazioni di Windows 7.
CMDIChildWndEx::SetTaskbarTabOrder	Inserisce figlio MDI prima della finestra specificata nelle schede della barra delle applicazioni di Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties	Imposta le proprietà per una scheda della barra delle applicazioni di Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Chiamato internamente dal framework per impostare il rettangolo di ritaglio per selezionare una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Rimuove le schede figlio MDI dalla barra delle applicazioni di Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon	Aggiorna l'icona della scheda della barra delle applicazioni di Windows 7.

Osservazioni:

Per sfruttare le funzionalità di ancoraggio estese nelle applicazioni MDI, derivare la classe della finestra figlio MDI dell'applicazione anziché CMDIChildWndEx CMDIChildWnd.

Esempio

Nell'esempio seguente viene derivata una classe da CMDIChildWndEx. Questo frammento di codice proviene dall'esempio di VisualStudioDemo: Applicazione Visual Studio MFC.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

   // Implementation
public:
   virtual ~CChildFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Gerarchia di ereditarietà

Requisiti

Intestazione: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Aggiunge un riquadro.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail = TRUE);

Parametri

pControlBar
[in] Puntatore al riquadro.

bTail
[in] TRUE per aggiungere il riquadro alla fine dell'elenco di riquadri per il gestore di ancoraggio; in caso contrario, FALSE.

Valore restituito

TRUE se il riquadro è stato registrato correttamente con il gestore di ancoraggio; in caso contrario, FALSE.

CMDIChildWndEx::AddTabbedPane

Aggiunge un riquadro a schede.

void AddTabbedPane(CDockablePane* pControlBar);

Parametri

pControlBar
[in] Puntatore al riquadro.

CMDIChildWndEx::AdjustDockingLayout

Regola il layout di ancoraggio.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parametri

hdwp
[in] Handle in una struttura di posizione della finestra posticipata.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Valore restituito

Osservazioni:

CMDIChildWndEx::CanShowOnWindowsList

Specifica se il nome della finestra figlio MDI può essere visualizzato nella finestra di dialogo Classe CMFCWindowsManagerDialog.

virtual BOOL CanShowOnWindowsList();

Valore restituito

TRUE se la finestra può essere visualizzata nella finestra di dialogo di Windows ; in caso contrario, FALSE.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata e restituire FALSE se la finestra non deve essere visualizzata nella finestra di dialogo di Windows . Questa funzione viene chiamata da CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Ancora un riquadro.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Parametri

pBar
[in] Puntatore al riquadro.

nDockBarID
[in] ID del riquadro.

lpRect
[in] Puntatore a un rettangolo.

Osservazioni:

Il parametro lpRect non viene utilizzato.

CMDIChildWndEx::D ockPaneLeftOf

Ancora un riquadro a sinistra di un altro riquadro.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parametri

pBar
Puntatore al riquadro da ancorare.

pLeftOf
Puntatore al riquadro che funge da punto di riferimento.

Valore restituito

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

Osservazioni:

Questo metodo accetta il riquadro specificato da pBar e lo ancora a sinistra del riquadro specificato da pLeftOf.

Chiama questo metodo quando vuoi ancorare diversi riquadri in ordine predefinito.

CMDIChildWndEx::EnableAutoHidePanes

Abilita la modalità nascondi automaticamente per i riquadri quando vengono ancorati ai lati specificati della finestra.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametri

dwDockStyle
[in] Specifica i lati della finestra cornice principale abilitata. Usare uno o più flag seguenti.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Valore restituito

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

CMDIChildWndEx::EnableDocking

Abilita l'ancoraggio della finestra figlio al frame principale.

BOOL EnableDocking(DWORD dwDockStyle);

Parametri

dwDockStyle
[in] Specifica l'allineamento dell'ancoraggio da abilitare.

Valore restituito

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

Osservazioni:

Chiamare questo metodo per abilitare l'allineamento dell'ancoraggio al fotogramma principale. È possibile passare una combinazione di flag CBRS_ALIGN_ (per altre informazioni, vedere CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Valore restituito

Osservazioni:

CMDIChildWndEx::GetDocumentName

Restituisce il nome del documento visualizzato nella finestra figlio MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Valore restituito

Puntatore a una stringa contenente il nome di un documento.

Osservazioni:

Un documento è il contenuto visualizzato nella finestra figlio MDI. In genere, nella finestra vengono visualizzati i dati caricati da o salvati in un file. Pertanto, il nome del documento è il nome del file. L'implementazione predefinita di GetDocumentName restituisce una stringa ottenuta da CDocument::GetPathName.

Se nella finestra viene visualizzato un documento non caricato da un file, eseguire l'override di questo metodo in una classe derivata e restituire un identificatore di documento univoco.

GetDocumentName viene chiamato dal framework quando salva lo stato di tutti i documenti aperti. La stringa restituita viene scritta nel Registro di sistema.

Quando il framework ripristina lo stato in un secondo momento, il nome del documento viene letto dal Registro di sistema e passato a CMDIFrameWndEx::CreateDocumentWindow. Eseguire l'override di questo metodo in una classe derivata da CMDIFrameWndEx e creare o aprire un documento con questo nome e leggere nel file con questo nome. Se il documento non è basato su un file, creare il documento in base all'identificatore del documento stesso. È consigliabile eseguire le azioni precedenti solo se si intende salvare e ripristinare i documenti.

Esempio

Nell'esempio seguente viene illustrato l'uso del metodo GetDocumentName. Questo frammento di codice proviene dall'esempio di VisualStudioDemo: Applicazione Visual Studio MFC.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

Chiamato dal framework per recuperare l'icona della finestra figlio MDI.

virtual HICON GetFrameIcon() const;

Valore restituito

Handle per l'icona della finestra.

Osservazioni:

Questo metodo viene chiamato dal framework per determinare quale icona visualizzare nella scheda MDI contenente la finestra cornice figlio MDI.

Per impostazione predefinita, questo metodo restituisce l'icona della finestra. Eseguire l'override GetFrameIcon in una classe derivata da per CMDIChildWndExpersonalizzare questo comportamento.

CMDIChildWndEx::GetFrameText

Chiamato dal framework per recuperare il testo per la finestra figlio MDI.

virtual CString GetFrameText() const;

Valore restituito

Stringa contenente il testo della finestra cornice.

Osservazioni:

Questo metodo viene chiamato dal framework per determinare il testo da visualizzare nella scheda MDI contenente la finestra cornice figlio MDI.

Per impostazione predefinita, questo metodo restituisce il testo della finestra. Eseguire l'override GetFrameText in una classe derivata da per CMDIChildWndExpersonalizzare questo comportamento.

CMDIChildWndEx::GetPane

Trova un riquadro in base all'ID di controllo specificato.

CBasePane* GetPane(UINT nID);

Parametri

nID
[in] ID del controllo del riquadro da trovare.

Valore restituito

Puntatore al riquadro se trovato; in caso contrario, NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Valore restituito

Osservazioni:

CMDIChildWndEx::GetTabbedPane

Restituisce un puntatore a un riquadro di ancoraggio che fa parte di un gruppo di documenti a schede MDI.

CDockablePane* GetTabbedPane() const;

Valore restituito

Puntatore a un riquadro di ancoraggio che fa parte di un gruppo di documenti a schede MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Chiamato dal framework per recuperare una descrizione comando per un pulsante della barra degli strumenti.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Valore restituito

TRUE se la descrizione comando è stata visualizzata. L'implementazione predefinita restituisce FALSE.

Osservazioni:

Eseguire l'override di questo metodo se si desidera visualizzare suggerimenti personalizzati per i pulsanti della barra degli strumenti.

CMDIChildWndEx::InsertPane

Registra il riquadro specificato con il gestore di ancoraggio.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter = TRUE);

Parametri

pControlBar
[in] Puntatore al riquadro da inserire.

pTarget
[in] Puntatore al riquadro adiacente.

bAfter
[in] Se TRUE, pControlBar viene inserito dopo pTarget. Se FALSE, pControlBar viene inserito prima di pTarget.

Valore restituito

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

CMDIChildWndEx::IsPointNearDockSite

Determina se un punto specificato si trova vicino al sito di ancoraggio.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parametri

point
[in] Punto specificato.

dwBarAlignment
[in] Specifica il bordo vicino al punto. I valori possibili sono CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP e CBRS_ALIGN_BOTTOM

bOuterEdge
[in] TRUE se il punto si trova vicino al bordo esterno del sito di ancoraggio; FALSE in caso contrario.

Valore restituito

TRUE se il punto si trova vicino al sito di ancoraggio; in caso contrario FALSE.

Osservazioni:

Il punto si trova vicino al sito dock quando si trova all'interno del set di riservatezza nel gestore di ancoraggio. La sensibilità predefinita è di 15 pixel.

CMDIChildWndEx::IsReadOnly

Specifica se il documento visualizzato nella finestra figlio è di sola lettura.

virtual BOOL IsReadOnly();

Valore restituito

TRUE se il documento è di sola lettura; in caso contrario FALSE.

Osservazioni:

Questa funzione viene usata per impedire il salvataggio di documenti di sola lettura.

Esempio

Nell'esempio seguente viene illustrato l'override del IsReadOnly metodo . Questo frammento di codice proviene dall'esempio di VisualStudioDemo: Applicazione Visual Studio MFC.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

Specifica se la finestra figlio MDI contiene un riquadro di ancoraggio.

BOOL IsTabbedPane() const;

Valore restituito

TRUE se la finestra figlio MDI contiene un riquadro di ancoraggio convertito in un documento a schede; in caso contrario FALSE.

CMDIChildWndEx::OnMoveMiniFrame

Chiamato dal framework per spostare una finestra mini-frame.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametri

pFrame
[in] Puntatore a una finestra con mini frame.

Valore restituito

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

CMDIChildWndEx::OnSetPreviewMode

Chiamato dal framework per attivare o uscire dalla modalità di anteprima di stampa.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parametri

bPreview
[in] Se TRUE, immettere la modalità anteprima di stampa. Se FALSE, uscire dalla modalità anteprima di stampa.

pState
[in] Puntatore alla struttura dello stato dell'anteprima di stampa.

CMDIChildWndEx::OnUpdateFrameTitle

Chiamato dal framework per aggiornare il titolo del frame.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parametri

bAddToTitle
[in] Se TRUE, aggiungere il nome del documento al titolo.

CMDIChildWndEx::P aneFromPoint

Restituisce il riquadro che contiene il punto specificato.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parametri

point
[in] Specifica il punto, nelle coordinate dello schermo, da controllare.

nSensitivity
[in] Aumentare l'area di ricerca di questo importo. Un riquadro soddisfa i criteri di ricerca se il punto specificato rientra nell'area aumentata.

bExactBar
[in] TRUE per ignorare il parametro nSensitivity ; in caso contrario, FALSE.

pRTCBarType
[in] Se non è NULL, il metodo cerca solo riquadri del tipo specificato.

dwAlignment
[in] Se viene trovato un riquadro nel punto specificato, questo parametro contiene il lato del riquadro più vicino al punto specificato. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Puntatore all'oggetto CBasePanederivato da che contiene il punto specificato o NULL se non è stato trovato alcun riquadro.

Osservazioni:

Chiamare questo metodo per determinare se un riquadro contiene il punto specificato in base alle condizioni specificate, ad esempio la classe di runtime e la visibilità.

Quando la funzione restituisce e viene trovato un riquadro, dwAlignment contiene l'allineamento del punto specificato. Ad esempio, se il punto è più vicino alla parte superiore del riquadro, dwAlignment è impostato su CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Ricalcola il layout della finestra.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametri

bNotify
[in] Se TRUE, l'elemento sul posto attivo per la finestra riceve la notifica della modifica del layout.

CMDIChildWndEx::RemovePaneFromDockManager

Rimuove un riquadro dal gestore di ancoraggio.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parametri

pControlBar
[in] Puntatore al riquadro da rimuovere.

bDestroy
[in] Se TRUE, il riquadro rimosso viene eliminato definitivamente.

bAdjustLayout
[in] Se TRUE, regolare immediatamente il layout di ancoraggio.

bAutoHide
[in] Se TRUE, il layout di ancoraggio è correlato all'elenco delle barre di espansione automatica. Se FALSE, il layout di ancoraggio è correlato all'elenco dei riquadri normali.

pBarReplacement
[in] Puntatore a un riquadro che sostituisce il riquadro rimosso.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parametri

[in] p

Osservazioni:

CMDIChildWndEx::ShowPane

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametri

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Osservazioni:

CMDIChildWndEx::UpdateTaskbarTabIcon

Aggiorna l'icona della scheda della barra delle applicazioni di Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parametri

hIcon
Handle a un'icona da visualizzare nella scheda della barra delle applicazioni di Windows 7.

Osservazioni:

CMDIChildWndEx::UnregisterTaskbarTab

Rimuove il figlio MDI dalle schede della barra delle applicazioni di Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parametri

bCheckRegisteredMDIChildCount
Specifica se questa funzione deve controllare il numero di figli MDI registrati con le schede MDI. Se questo numero è 0, questa funzione rimuove il rettangolo di ritaglio dall'anteprima della barra delle applicazioni dell'applicazione.

Osservazioni:

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Chiamato dal framework per impostare il rettangolo di ritaglio per selezionare una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parametri

rect
Specifica il nuovo rettangolo di ritaglio. Se il rettangolo è vuoto o Null, il ritaglio viene rimosso.

Valore restituito

TRUE se l'operazione riesce; in caso contrario, FALSE.

Osservazioni:

CMDIChildWndEx::SetTaskbarTabProperties

Imposta le proprietà per una scheda della barra delle applicazioni di Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parametri

dwFlags
Combinazione di valori STPFLAG. Per altre informazioni, vedere ITaskbarList4::SetTabProperties.

Osservazioni:

CMDIChildWndEx::SetTaskbarTabOrder

Inserisce l'elemento figlio MDI prima della finestra specificata nelle schede della barra delle applicazioni di Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parametri

pWndBefore
Puntatore alla finestra figlio MDI la cui anteprima viene inserita a sinistra. Questa finestra deve essere già registrata tramite RegisterTaskbarTab. Se questo valore è NULL, la nuova anteprima viene aggiunta alla fine dell'elenco.

Osservazioni:

CMDIChildWndEx::SetTaskbarTabActive

Attiva la scheda corrispondente della barra delle applicazioni di Windows 7.

void SetTaskbarTabActive();

Osservazioni:

CMDIChildWndEx::RegisterTaskbarTab

Registra il figlio MDI con le schede della barra delle applicazioni di Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parametri

Osservazioni:

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Chiamato dal framework quando è necessario estendere una bitmap per un'anteprima della scheda della scheda della barra delle applicazioni di Windows 7 dell'elemento figlio MDI.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Parametri

hBmpDst
Handle di una bitmap di destinazione.

rectDst
Specifica il rettangolo di destinazione.

hBmpSrc
Handle per una bitmap di origine.

rectSrc
Specifica il rettangolo di origine.

Osservazioni:

Requisito: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Chiamato dal framework quando l'anteprima della scheda della barra delle applicazioni deve elaborare il messaggio WM_MOUSEACTIVATE.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Parametri

pDesktopWnd
Specifica un puntatore alla finestra padre principale della finestra da attivare. Il puntatore può essere temporaneo e non deve essere archiviato.

nHitTest
Specifica il codice dell'area hit test. Un hit test è un test che determina la posizione del cursore.

message
Specifica il numero del messaggio del mouse.

Osservazioni:

L'implementazione predefinita attiva il frame figlio MDI correlato.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Chiamato dal framework quando l'anteprima della scheda della barra delle applicazioni deve elaborare il messaggio di WM_ACTIVATE.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parametri

nState
Specifica se l'oggetto CWnd viene attivato o disattivato.

pWndOther
Puntatore all'oggetto CWnd attivato o disattivato. Il puntatore può essere NULL e può essere temporaneo.

bMinimized
Specifica lo stato ridotto al minimo dell'oggetto CWnd attivato o disattivato. Il valore TRUE indica che la finestra è ridotta a icona.

Osservazioni:

L'implementazione predefinita attiva il frame figlio MDI correlato.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Chiamato dal framework quando l'utente preme il pulsante di chiusura nell'anteprima della scheda Della barra delle applicazioni.

virtual void OnPressTaskbarThmbnailCloseButton();

Osservazioni:

CMDIChildWndEx::OnGetIconicThumbnail

Chiamato dal framework quando deve ottenere una bitmap per l'icona di anteprima del figlio MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parametri

nWidth
Specifica la larghezza della bitmap richiesta.

nHeight
Specifica l'altezza della bitmap richiesta.

Osservazioni:

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Chiamato dal framework quando deve ottenere una bitmap per l'anteprima dinamica del figlio MDI.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Parametri

bIsMDIChildActive
Questo parametro è TRUE se la bitmap è richiesta per l'elemento figlio MDI, che è attualmente attivo e la finestra principale non è ridotta a icona. L'elaborazione predefinita in questo caso crea uno snapshot della finestra principale.

ptLocation
Specifica la posizione della bitmap nelle coordinate client della finestra principale (di primo livello). Questo punto deve essere fornito dal chiamato.

Valore restituito

Se elaborato, restituisce un handle a una bitmap 32bpp valida, altrimenti NULL.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata e restituire una bitmap 32bpp valida per l'anteprima dinamica del figlio MDI. Questo metodo viene chiamato solo quando l'elemento figlio MDI viene visualizzato nelle schede della barra delle applicazioni di Windows 7. Se si restituisce NULL, MFC chiama i gestori predefiniti e ottiene bitmap usando PrintClient o PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Combinazione di flag, che viene passato dal framework al SetTaskbarTabProperties metodo , quando viene registrata una scheda (figlio MDI) con le schede della barra delle applicazioni di Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Osservazioni:

La combinazione predefinita è STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Indica se la selezione automatica di una parte dell'area client di una finestra da visualizzare come l'anteprima della finestra nella barra delle applicazioni è abilitata o disabilitata.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Valore restituito

Restituisce TRUE se la selezione automatica di una parte dell'area client di una finestra da visualizzare è abilitata; in caso contrario FALSE.

Osservazioni:

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Indica se l'elemento figlio MDI può essere visualizzato nelle schede della barra delle applicazioni di Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Valore restituito

TRUE se l'elemento figlio MDI può essere visualizzato nelle schede della barra delle applicazioni di Windows 7; FALSE se l'elemento figlio MDI non può essere visualizzato nelle schede della barra delle applicazioni di Windows 7.

Osservazioni:

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Restituisce TRUE se l'elemento figlio MDI è stato registrato correttamente con le schede della barra delle applicazioni di Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Valore restituito

TRUE se l'elemento figlio MDI è registrato con le schede della barra delle applicazioni di Windows 7; in caso contrario FALSE.

Osservazioni:

CMDIChildWndEx::InvalidateIconicBitmaps

Invalida una rappresentazione bitmap iconica di un figlio MDI.

BOOL InvalidateIconicBitmaps();

Valore restituito

Restituisce FALSE se il supporto della barra delle applicazioni di Windows 7 è disabilitato o l'elemento figlio MDI non è registrato con le schede della barra delle applicazioni di Windows 7; in caso contrario restituisce TRUE.

Osservazioni:

Deve essere chiamato quando il contenuto live o le dimensioni di un figlio MDI è cambiato.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Chiamato dal framework quando è necessario selezionare una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.

virtual CRect GetTaskbarThumbnailClipRect() const;

Valore restituito

Rettangolo nelle coordinate delle finestre. Questo rettangolo viene mappato all'area client del frame di livello superiore. Il rettangolo deve essere vuoto per cancellare il rettangolo di ritaglio.

Osservazioni:

CMDIChildWndEx::GetTaskbarPreviewWnd

Chiamato dal framework quando deve ottenere una finestra figlio (in genere una finestra di visualizzazione o di divisione) da visualizzare in un'anteprima della scheda della barra delle applicazioni di Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Valore restituito

Deve restituire un puntatore valido a un CWnd oggetto, la cui anteprima deve essere visualizzata in una scheda della barra delle applicazioni di Windows 7 correlata a questo figlio MDI. L'implementazione predefinita restituisce una finestra figlio di questo oggetto figlio MDI con AFX_IDW_PANE_FIRST ID di controllo (che in genere è una CViewclasse derivata da ).

Osservazioni:

CMDIChildWndEx::GetTabProxyWnd

Restituisce la finestra proxy della scheda registrata con le schede della barra delle applicazioni di Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Valore restituito

Puntatore a un CMDITabProxyWnd oggetto registrato con le schede della barra delle applicazioni di Windows 7.

Osservazioni:

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Abilita o disabilita la selezione automatica di una parte dell'area client di una finestra da visualizzare come anteprima della finestra nella barra delle applicazioni.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parametri

bEnable
Specifica se abilitare (TRUE) o disabilitare la selezione automatica (FALSE) di una parte dell'area client di una finestra da visualizzare.

Osservazioni:

CMDIChildWndEx::CanShowOnTaskBarTabs

Indica al framework se questo figlio MDI può essere visualizzato nelle schede della barra delle applicazioni di Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Valore restituito

TRUE se il contenuto dell'elemento figlio MDI può essere visualizzato nelle anteprime della barra delle applicazioni di Windows 7.

Osservazioni:

Eseguire l'override di questo metodo in una classe derivata e restituire FALSE per disabilitare l'aspetto di questo figlio MDI nelle schede della barra delle applicazioni di Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Chiamato dal framework per attivare il frame di primo livello quando l'applicazione viene attivata da una scheda della barra delle applicazioni.

virtual void ActivateTopLevelFrame();

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CMDIChildWnd
Classe CMFCWindowsManagerDialog
Classe CMDIFrameWndEx

Condividi tramite

Classe CMDIChildWndEx

Sintassi

Membri

Metodi pubblici

Osservazioni:

Esempio

Gerarchia di ereditarietà

Requisiti

CMDIChildWndEx::AddPane

Parametri

Valore restituito

CMDIChildWndEx::AddTabbedPane

Parametri

CMDIChildWndEx::AdjustDockingLayout

Parametri

CMDIChildWndEx::CanShowOnMDITabs

Valore restituito

Osservazioni:

CMDIChildWndEx::CanShowOnWindowsList

Valore restituito

Osservazioni:

CMDIChildWndEx::D ockPane

Parametri

Osservazioni:

CMDIChildWndEx::D ockPaneLeftOf

Parametri

Valore restituito

Osservazioni:

CMDIChildWndEx::EnableAutoHidePanes

Parametri

Valore restituito

CMDIChildWndEx::EnableDocking

Parametri

Valore restituito

Osservazioni:

CMDIChildWndEx::GetDockingManager

Valore restituito

Osservazioni:

CMDIChildWndEx::GetDocumentName

Valore restituito

Osservazioni:

Esempio

CMDIChildWndEx::GetFrameIcon

Valore restituito

Osservazioni:

CMDIChildWndEx::GetFrameText

Valore restituito

Osservazioni:

CMDIChildWndEx::GetPane

Parametri

Valore restituito

CMDIChildWndEx::GetRelatedTabGroup

Valore restituito

Osservazioni:

CMDIChildWndEx::GetTabbedPane

Valore restituito

CMDIChildWndEx::GetToolbarButtonToolTipText

Valore restituito

Osservazioni:

CMDIChildWndEx::InsertPane

Parametri

Valore restituito

CMDIChildWndEx::IsPointNearDockSite

Parametri

Valore restituito

Osservazioni:

CMDIChildWndEx::IsReadOnly

Valore restituito

Osservazioni:

Esempio

CMDIChildWndEx::IsTabbedPane

Valore restituito

CMDIChildWndEx::OnMoveMiniFrame

Parametri

Valore restituito

CMDIChildWndEx::OnSetPreviewMode

Parametri

CMDIChildWndEx::OnUpdateFrameTitle

Parametri