CMDIChildWndEx – třída

Článek
11/19/2024

Třída CMDIChildWndEx poskytuje funkce podřízeného okna rozhraní MDI (Windows multiple document interface). Rozšiřuje funkčnost třídy CMDIChildWnd. Architektura vyžaduje tuto třídu, pokud aplikace MDI používá určité třídy MFC.

Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMDIChildWndEx : public CMDIChildWnd

Členové

Veřejné metody

Název	Popis
CMDIChildWndEx::ActivateTopLevelFrame	Volá se interně rozhraním pro aktivaci rámce nejvyšší úrovně při aktivaci aplikace z karty hlavního panelu.
`CMDIChildWndEx::AddDockSite`	Tato metoda se nepoužívá nebo implementuje.
CMDIChildWndEx::AddPane	Přidá podokno.
CMDIChildWndEx::AddTabbedPane	Přidá podokno s kartami.
CMDIChildWndEx::AdjustDockingLayout	Upraví rozložení ukotvení.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Informuje architekturu, zda lze toto podřízené mdI zobrazit na kartách hlavního panelu Windows 7.
CMDIChildWndEx::CanShowOnWindowsList	Vrátí hodnotu TRUE, pokud lze v dialogovém okně TŘÍDY CMFCWindowsManagerDialog zobrazit název podřízeného okna MDI. V opačném případě vrátí hodnotu FALSE.
`CMDIChildWndEx::CreateObject`	Volá se rozhraním pro vytvoření dynamické instance tohoto typu třídy.
CMDIChildWndEx::D ockPane	Ukotví podokno.
CMDIChildWndEx::D ockPaneLeftOf	Ukotví jedno podokno vlevo od jiného podokna.
CMDIChildWndEx::EnableAutoHidePanes	Povolí režim automatického skrytí pro podokna, když jsou ukotveny na zadaných stranách okna.
CMDIChildWndEx::EnableDocking	Umožňuje ukotvit podřízené okno do hlavního rámce.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Povolí nebo zakáže automatický výběr části klientské oblasti okna, aby se zobrazila jako miniatura tohoto okna na hlavním panelu.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Vrátí název dokumentu, který se zobrazí v podřízené okně MDI.
CMDIChildWndEx::GetFrameIcon	Volá se rozhraním pro načtení ikony podřízeného okna MDI.
CMDIChildWndEx::GetFrameText	Volá se rozhraním pro načtení textu pro podřízené okno MDI.
CMDIChildWndEx::GetPane	Vyhledá podokno podle zadaného ID ovládacího prvku.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Vrátí ukazatel na vložené ukotvené podokno, které bylo převedeno na dokument s kartami.
CMDIChildWndEx::GetTabProxyWnd	Vrátí okno proxy karet skutečně zaregistrované na kartách hlavního panelu Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd	Volané architekturou, když potřebuje získat podřízené okno (obvykle zobrazení nebo rozdělené okno), které se má zobrazit na kartě hlavního panelu Windows 7 miniatury.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	Volá se rozhraním, když potřebuje vybrat část klientské oblasti okna, která se má zobrazit jako miniatura tohoto okna na hlavním panelu.
`CMDIChildWndEx::GetThisClass`	Volá se architekturou k získání ukazatele na CRuntimeClass objektu, který je přidružen k tomuto typu třídy.
CMDIChildWndEx::GetToolbarButtonToolTipText	Volá se rozhraním, které načte popis tlačítka panelu nástrojů.
CMDIChildWndEx::InsertPane	Zaregistruje zadané podokno ve správci ukotvení.
CMDIChildWndEx::InvalidateIconicBitmaps	Zneplatní ikonické rastrové znázornění podřízeného mdi.
CMDIChildWndEx::IsPointNearDockSite	Určuje, zda je zadaný bod blízko doku.
CMDIChildWndEx::IsReadOnly	Vrátí hodnotu TRUE, pokud je dokument zobrazený v podřízeném okně jen pro čtení. V opačném případě vrátí hodnotu FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Vrátí hodnotu TRUE, pokud byla podřízená položka MDI úspěšně zaregistrována na kartách hlavního panelu Windows 7.
CMDIChildWndEx::IsTabbedPane	Vrátí hodnotu TRUE, pokud podřízené okno MDI obsahuje ukotvené podokno. V opačném případě vrátí hodnotu FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Určuje, jestli se podřízená položka MDI může zobrazit na kartách hlavního panelu Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Určuje, jestli je povolený nebo zakázaný automatický výběr části klientské oblasti okna, která se má zobrazit jako miniatura daného okna na hlavním panelu.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Kombinace příznaků, které se předávají rozhraním metodě SetTaskbarTabProperties při registraci karty (podřízené MDI) na kartách hlavního panelu Systému Windows 7. Výchozí kombinace je `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	Volá se architekturou, když potřebuje získat rastrový obrázek pro dynamický náhled podřízeného mdi.
CMDIChildWndEx::OnGetIconicThumbnail	Volá se architekturou, když potřebuje získat rastrový obrázek pro ikonickou miniaturu dítěte MDI.
CMDIChildWndEx::OnMoveMiniFrame	Volá se rozhraním pro přesunutí okna s mini rámečkem.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	Volá se rozhraním, když uživatel stiskne tlačítko zavřít na kartě Hlavní panel thumbnail..
CMDIChildWndEx::OnSetPreviewMode	Volal rozhraní pro vstup nebo ukončení režimu náhledu tisku.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	Volá se architekturou, když by miniatura karty Hlavní panel měla zpracovat WM_ACTIVATE zprávu.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	Volá se rozhraním, když by miniatura karty Hlavní panel měla zpracovat WM_MOUSEACTIVATE zprávu.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	Volá se podle architektury, když potřebuje roztáhnout rastrový obrázek pro miniaturu karty hlavního panelu Windows 7 náhled podřízené MDI.
CMDIChildWndEx::OnUpdateFrameTitle	Volá se rozhraním pro aktualizaci názvu rámce. (Přepsání `CMDIChildWnd::OnUpdateFrameTitle`.)
CMDIChildWndEx::P aneFromPoint	Vrátí podokno, které obsahuje daný bod.
`CMDIChildWndEx::PreTranslateMessage`	Třída CWinApp k překladu oken zprávy před jejich odesláním do Funkce TranslateMessage a DispatchMessage Windows. (Přepsání CWnd::P reTranslateMessage.)
CMDIChildWndEx::PřepočetLayout	Přepočítá rozložení okna.
CMDIChildWndEx::RegisterTaskbarTab	Zaregistruje podřízenou položku MDI na kartách hlavního panelu Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager	Odebere podokno ze správce ukotvení.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Aktivuje odpovídající kartu hlavního panelu Windows 7.
CMDIChildWndEx::SetTaskbarTabOrder	Vloží podřízenou položku MDI před zadaným oknem na kartách hlavního panelu Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties	Nastaví vlastnosti pro kartu hlavního panelu Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	Volá se interně podle architektury pro nastavení obdélníku výřezu pro výběr části klientské oblasti okna, která se má zobrazit jako miniatura tohoto okna na hlavním panelu.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Odebere podřízenou položku MDI z karet hlavního panelu Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon	Aktualizuje ikonu karty hlavního panelu Windows 7.

Poznámky

Pokud chcete využít výhod rozšířených dokovacích funkcí v aplikacích MDI, odvozujte třídu podřízených oken MDI vaší aplikace místo CMDIChildWndEx CMDIChildWnd.

Příklad

Následující příklad odvozuje třídu z CMDIChildWndEx. Tento fragment kódu pochází z ukázky VisualStudioDemo: APLIKACE SADY MFC sady Visual Studio.

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()
};

Hierarchie dědičnosti

Požadavky

Hlavička: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Přidá podokno.

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

Parametry

pControlBar
[v] Ukazatel na podokno.

bTail
[v] TRUE pro přidání podokna na konec seznamu podoken pro dokovací správce; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud podokno bylo úspěšně zaregistrováno u dokovací správce; jinak NEPRAVDA.

CMDIChildWndEx::AddTabbedPane

Přidá podokno s kartami.

void AddTabbedPane(CDockablePane* pControlBar);

Parametry

pControlBar
[v] Ukazatel na podokno.

CMDIChildWndEx::AdjustDockingLayout

Upraví rozložení ukotvení.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parametry

hdwp
[v] Umožňuje zpracovat strukturu odložené pozice okna.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Návratová hodnota

Poznámky

CMDIChildWndEx::CanShowOnWindowsList

Určuje, zda lze název podřízeného okna MDI zobrazit v CMFCWindowsManagerDialog Třída dialogové okno.

virtual BOOL CanShowOnWindowsList();

Návratová hodnota

TRUE, pokud se okno může zobrazit v dialogovém okně Windows ; jinak NEPRAVDA.

Poznámky

Tuto metodu přepište v odvozené třídě a vrátit HODNOTU FALSE, pokud by okno nemělo být zobrazeno v dialogovém okně Windows . Tato funkce je volána z CMFCWindowsManagerDialog.

CMDIChildWndEx::D ockPane

Ukotví podokno.

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

Parametry

pBar
[v] Ukazatel na podokno.

nDockBarID
[v] ID podokna.

lpRect
[v] Ukazatel na obdélník.

Poznámky

Parametr lpRect se nepoužívá.

CMDIChildWndEx::D ockPaneLeftOf

Ukotví jedno podokno vlevo od jiného podokna.

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

Parametry

pBar
Ukazatel na podokno, které se má ukotvit.

pLeftOf
Ukazatel na podokno, které slouží jako bod odkazu.

Návratová hodnota

PRAVDA při úspěchu, NEPRAVDA při selhání.

Poznámky

Tato metoda vezme podokno určené pBar a ukotví ho na levé straně podokna určeného pLeftOf.

Tuto metodu zavolejte, pokud chcete dokovat několik podoken v předdefinovaném pořadí.

CMDIChildWndEx::EnableAutoHidePanes

Povolí režim automatického skrytí pro podokna, když jsou ukotveny na zadaných stranách okna.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametry

dwDockStyle
[v] Určuje strany okna hlavního rámce, které je povoleno. Použijte jeden nebo více následujících příznaků.

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Návratová hodnota

TRUE, pokud metoda uspěje; jinak NEPRAVDA.

CMDIChildWndEx::EnableDocking

Umožňuje ukotvit podřízené okno do hlavního rámce.

BOOL EnableDocking(DWORD dwDockStyle);

Parametry

dwDockStyle
[v] Určuje ukotvit zarovnání, které se má povolit.

Návratová hodnota

TRUE, pokud metoda uspěje; jinak NEPRAVDA.

Poznámky

Voláním této metody povolíte ukotvení zarovnání do hlavního rámce. Můžete předat kombinaci příznaků CBRS_ALIGN_ (další informace najdete v tématu CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Návratová hodnota

Poznámky

CMDIChildWndEx::GetDocumentName

Vrátí název dokumentu, který se zobrazí v podřízené okně MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Návratová hodnota

Ukazatel na řetězec, který obsahuje název dokumentu.

Poznámky

Dokument je to, co zobrazuje podřízené okno MDI. Obecně platí, že okno zobrazuje data načtená ze souboru nebo uložená do souboru. Název dokumentu je proto název souboru. Výchozí implementace GetDocumentName vrátí řetězec získaný z CDocument::GetPathName.

Pokud okno zobrazí dokument, který není načten ze souboru, přepište tuto metodu v odvozené třídě a vraťte jedinečný identifikátor dokumentu.

GetDocumentName volá se architekturou, když uloží stav všech otevřených dokumentů. Vrácený řetězec se zapíše do registru.

Při pozdějším obnovení stavu architektury se název dokumentu načte z registru a předá cmDIFrameWndEx::CreateDocumentWindow. Přepsat tuto metodu v CMDIFrameWndEx odvozené třídy a vytvořit nebo otevřít dokument, který má tento název a číst v souboru s tímto názvem. Pokud dokument není založený na souboru, vytvořte dokument na základě samotného identifikátoru dokumentu. Předchozí akce byste měli provést pouze v případě, že máte v úmyslu ukládat a obnovovat dokumenty.

Příklad

Následující příklad ukazuje použití GetDocumentName metody. Tento fragment kódu pochází z ukázky VisualStudioDemo: APLIKACE SADY MFC sady Visual Studio.

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

CMDIChildWndEx::GetFrameIcon

Volá se rozhraním pro načtení ikony podřízeného okna MDI.

virtual HICON GetFrameIcon() const;

Návratová hodnota

Úchyt ikony okna.

Poznámky

Tato metoda je volána architekturou k určení, jaká ikona se má zobrazit na kartě MDI, která obsahuje okno podřízeného rámce MDI.

Ve výchozím nastavení tato metoda vrátí ikonu okna. Přepsat GetFrameIcon v -odvozené CMDIChildWndExtřídě přizpůsobit toto chování.

CMDIChildWndEx::GetFrameText

Volá se rozhraním pro načtení textu pro podřízené okno MDI.

virtual CString GetFrameText() const;

Návratová hodnota

Řetězec, který obsahuje text okna rámečku.

Poznámky

Tato metoda je volána architekturou k určení textu, který se má zobrazit na kartě MDI, která obsahuje okno podřízeného rámce MDI.

Ve výchozím nastavení tato metoda vrátí text okna. Přepsat GetFrameText v -odvozené CMDIChildWndExtřídě přizpůsobit toto chování.

CMDIChildWndEx::GetPane

Vyhledá podokno podle zadaného ID ovládacího prvku.

CBasePane* GetPane(UINT nID);

Parametry

Nid
[v] ID ovládacího prvku podokna, které chcete najít.

Návratová hodnota

Ukazatel na podokno, pokud je nalezen, jinak NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Návratová hodnota

Poznámky

CMDIChildWndEx::GetTabbedPane

Vrátí ukazatel na ukotvené podokno, které je součástí skupiny dokumentů s kartami MDI.

CDockablePane* GetTabbedPane() const;

Návratová hodnota

Ukazatel na ukotvené podokno, které je součástí skupiny dokumentů s kartami MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Volá se rozhraním, které načte popis tlačítka panelu nástrojů.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Návratová hodnota

TRUE, pokud byl zobrazen popis. Výchozí implementace vrátí hodnotu FALSE.

Poznámky

Tuto metodu přepište, pokud chcete zobrazit vlastní popisy tlačítek panelu nástrojů.

CMDIChildWndEx::InsertPane

Zaregistruje zadané podokno ve správci ukotvení.

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

Parametry

pControlBar
[v] Ukazatel na podokno, které chcete vložit.

pTarget
[v] Ukazatel na sousední podokno.

bAfter
[v] Pokud true, pControlBar je vložen za pTarget. Pokud false, pControlBar je vložen před pTarget.

Návratová hodnota

TRUE, pokud metoda bude úspěšná, jinak NEPRAVDA.

CMDIChildWndEx::IsPointNearDockSite

Určuje, zda je zadaný bod blízko doku.

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

Parametry

bod
[v] Zadaný bod.

dwBarAlignment
[v] Určuje, který okraj je bod blízko. Možné hodnoty jsou CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP a CBRS_ALIGN_BOTTOM

bOuterEdge
[v] PRAVDA, pokud je bod blízko vnějšího okraje dokovací lokality; JINAK NEPRAVDA.

Návratová hodnota

TRUE, pokud je bod blízko dokovací lokality; jinak NEPRAVDA.

Poznámky

Bod se nachází v blízkosti dokovací lokality, když je uvnitř citlivosti nastavené ve správci ukotvení. Výchozí citlivost je 15 pixelů.

CMDIChildWndEx::IsReadOnly

Určuje, jestli je dokument zobrazený v podřízeném okně jen pro čtení.

virtual BOOL IsReadOnly();

Návratová hodnota

TRUE, pokud je dokument jen pro čtení; jinak NEPRAVDA.

Poznámky

Tato funkce slouží k zabránění ukládání dokumentů jen pro čtení.

Příklad

Následující příklad ukazuje přepsání IsReadOnly metody. Tento fragment kódu pochází z ukázky VisualStudioDemo: APLIKACE SADY MFC sady Visual Studio.

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

CMDIChildWndEx::IsTabbedPane

Určuje, jestli podřízené okno MDI obsahuje ukotvené podokno.

BOOL IsTabbedPane() const;

Návratová hodnota

TRUE Pokud podřízené okno MDI obsahuje ukotvené podokno, které bylo převedeno na dokument s kartami; jinak NEPRAVDA.

CMDIChildWndEx::OnMoveMiniFrame

Volá se rozhraním pro přesunutí okna s mini rámečkem.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametry

pFrame
[v] Ukazatel na okno s mini rámečkem

Návratová hodnota

TRUE, pokud je metoda úspěšná, jinak NEPRAVDA.

CMDIChildWndEx::OnSetPreviewMode

Volal rozhraní pro vstup nebo ukončení režimu náhledu tisku.

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

Parametry

bPreview
[v] Pokud je pravda, zadejte režim náhledu tisku. Pokud je hodnota FALSE, ukončete režim náhledu tisku.

pState
[v] Ukazatel na strukturu stavu náhledu tisku.

CMDIChildWndEx::OnUpdateFrameTitle

Volá se rozhraním pro aktualizaci názvu rámce.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parametry

bAddToTitle
[v] Pokud je hodnota TRUE, přidejte název dokumentu do názvu.

CMDIChildWndEx::P aneFromPoint

Vrátí podokno, které obsahuje daný bod.

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

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

Parametry

bod
[v] Určuje bod, který se má zkontrolovat, v souřadnicích obrazovky.

NSensitivity
[v] Zvětšete oblast hledání o tuto částku. Podokno splňuje kritéria hledání, pokud daný bod spadá do zvýšené oblasti.

bExactBar
[v] Hodnota TRUE ignoruje parametr nSensitivity , jinak NEPRAVDA.

pRTCBarType
[v] Pokud není null, metoda hledá pouze podokna zadaného typu.

dwAlignment
[v] Pokud se v zadaném bodě najde podokno, tento parametr obsahuje stranu podokna, které bylo nejblíže zadanému bodu. Další informace najdete v části Poznámky.

Návratová hodnota

Ukazatel na CBasePane-odvozený objekt, který obsahuje daný bod, nebo NULL, pokud nebyl nalezen žádný podokno.

Poznámky

Voláním této metody určíte, zda podokno obsahuje zadaný bod podle zadaných podmínek, jako je třída modulu runtime a viditelnost.

Když funkce vrátí hodnotu a bylo nalezeno podokno, dwAlignment obsahuje zarovnání zadaného bodu. Pokud byl například bod nejblíže horní části podokna, je hodnota dwAlignment nastavená na CBRS_ALIGN_TOP.

CMDIChildWndEx::PřepočetLayout

Přepočítá rozložení okna.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

bNotify
[v] Pokud je hodnota TRUE, aktivní místní položka okna obdrží oznámení o změně rozložení.

CMDIChildWndEx::RemovePaneFromDockManager

Odebere podokno ze správce ukotvení.

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

Parametry

pControlBar
[v] Ukazatel na podokno, které chcete odebrat.

bDestroy
[v] Pokud je hodnota TRUE, odstraní se odebrané podokno.

bAdjustLayout
[v] Pokud je hodnota TRUE, upravte rozložení ukotvení okamžitě.

bAutoHide
[v] Pokud je hodnota TRUE, rozložení ukotvení souvisí se seznamem automaticky skrytých pruhů. Pokud je hodnota FALSE, rozložení ukotvení souvisí se seznamem běžných podoken.

pBarReplacement
[v] Ukazatel na podokno, které nahrazuje odebrané podokno.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parametry

[v] p

Poznámky

CMDIChildWndEx::ShowPane

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

Parametry

[v] pBar

[v] BShow

[v] bDelay

[v] bActivate

Poznámky

CMDIChildWndEx::UpdateTaskbarTabIcon

Aktualizuje ikonu karty hlavního panelu Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parametry

hIcon
Úchyt ikony, která se zobrazí na kartě hlavního panelu Windows 7.

Poznámky

CMDIChildWndEx::UnregisterTaskbarTab

Odebere podřízenou položku MDI z karet hlavního panelu Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parametry

bCheckRegisteredMDIChildCount
Určuje, jestli tato funkce potřebuje zkontrolovat počet podřízených objektů MDI zaregistrovaných na kartách MDI. Pokud je toto číslo 0, tato funkce odebere obdélník výřezu z miniatury hlavního panelu aplikace.

Poznámky

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Volal rozhraní pro nastavení obdélníku výřezu pro výběr části klientské oblasti okna, která se má zobrazit jako miniatura tohoto okna na hlavním panelu.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parametry

Rect
Určuje nový obdélník výřezu. Pokud je obdélník prázdný nebo má hodnotu null, oříznutí se odebere.

Návratová hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

CMDIChildWndEx::SetTaskbarTabProperties

Nastaví vlastnosti pro kartu hlavního panelu Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parametry

dwFlags
Kombinace hodnot STPFLAG. Další informace naleznete v tématu ITaskbarList4::SetTabProperties.

Poznámky

CMDIChildWndEx::SetTaskbarTabOrder

Vloží podřízenou položku MDI před zadané okno na kartách hlavního panelu Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parametry

pWndBefore
Ukazatel na podřízené okno MDI, jehož miniatura se vloží doleva. Toto okno již musí být registrováno prostřednictvím RegisterTaskbarTab. Pokud je tato hodnota NULL, přidá se nová miniatura na konec seznamu.

Poznámky

CMDIChildWndEx::SetTaskbarTabActive

Aktivuje odpovídající kartu hlavního panelu Windows 7.

void SetTaskbarTabActive();

Poznámky

CMDIChildWndEx::RegisterTaskbarTab

Zaregistruje podřízenou položku MDI na kartách hlavního panelu Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parametry

Poznámky

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Volá se podle architektury, když potřebuje roztáhnout rastrový obrázek pro miniaturu karty hlavního panelu Windows 7 náhled podřízené MDI.

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

Parametry

hBmpDst
Popisovač cílového rastrového obrázku.

rectDst
Určuje cílový obdélník.

hBmpSrc
Popisovač zdrojového rastrového obrázku.

rectSrc
Určuje zdrojový obdélník.

Poznámky

Požadavek: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Volá se rozhraním, když by miniatura karty Hlavní panel měla zpracovat zprávu WM_MOUSEACTIVATE.

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

Parametry

pDesktopWnd
Určuje ukazatel na nadřazené okno nejvyšší úrovně aktivovaného okna. Ukazatel může být dočasný a neměl by být uložen.

nHitTest
Určuje směrové číslo oblasti hit-test. Test hitu je test, který určuje umístění kurzoru.

message
Určuje číslo zprávy myši.

Poznámky

Výchozí implementace aktivuje související podřízený rámec MDI.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Volá se rozhraním, když by miniatura karty Hlavní panel měla zpracovat zprávu WM_ACTIVATE.

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

Parametry

nState
Určuje, jestli CWnd se aktivuje nebo deaktivuje.

pWndOther
Ukazatel na CWnd aktivovanou nebo deaktivovanou akci. Ukazatel může mít hodnotu NULL a může být dočasný.

bMinimized
Určuje minimalizovaný stav CWnd aktivace nebo deaktivace. Hodnota TRUE označuje, že okno je minimalizované.

Poznámky

Výchozí implementace aktivuje související podřízený rámec MDI.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Volá se rozhraním, když uživatel stiskne tlačítko Zavřít na kartě Hlavní panel miniatury.

virtual void OnPressTaskbarThmbnailCloseButton();

Poznámky

CMDIChildWndEx::OnGetIconicThumbnail

Volá se podle architektury, když potřebuje získat rastrový obrázek pro ikonickou miniaturu dítěte MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parametry

nWidth
Určuje šířku požadovaného rastrového obrázku.

nHeight
Určuje výšku požadovaného rastrového obrázku.

Poznámky

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Volá se architekturou, když potřebuje získat rastrový obrázek pro dynamický náhled podřízeného mdi.

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

Parametry

bIsMDIChildActive
Tento parametr má hodnotu TRUE, pokud je rastrový obrázek požadován pro podřízenou položku MDI, která je aktuálně aktivní a hlavní okno není minimalizované. Výchozí zpracování v tomto případě pořídí snímek hlavního okna.

ptLocation
Určuje umístění rastrového obrázku v souřadnicích klienta hlavní (nejvyšší úrovně). Tento bod by měl poskytnout volaný.

Návratová hodnota

Při zpracování vrátí popisovač platnému rastru 32bpp, jinak NULL.

Poznámky

Přepsat tuto metodu v odvozené třídě a vrátit platný rastrový obrázek 32bpp pro živý náhled podřízené MDI. Tato metoda se volá pouze v případě, že je podřízená položka MDI zobrazena na kartách hlavního panelu Windows 7. Pokud vrátíte hodnotu NULL, MFC volá výchozí obslužné rutiny a získává rastrové obrázky pomocí PrintClient nebo PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Kombinace příznaků, které architektura předává SetTaskbarTabProperties metodě, když je záložka (podřízená mdi) zaregistrována na kartách hlavního panelu Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Poznámky

Výchozí kombinace je STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Určuje, jestli je povolený nebo zakázaný automatický výběr části klientské oblasti okna, která se má zobrazit jako miniatura daného okna na hlavním panelu.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Návratová hodnota

Vrátí hodnotu TRUE, pokud je povolen automatický výběr části klientské oblasti okna, která se má zobrazit; jinak NEPRAVDA.

Poznámky

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Určuje, jestli se podřízená položka MDI může zobrazit na kartách hlavního panelu Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Návratová hodnota

TRUE, pokud mdI podřízený může zobrazit na kartách hlavního panelu Systému Windows 7; NEPRAVDA, pokud se podřízená položka MDI nemůže zobrazit na kartách hlavního panelu Windows 7.

Poznámky

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Vrátí hodnotu TRUE, pokud se podřízená položka MDI úspěšně zaregistrovala na kartách hlavního panelu Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Návratová hodnota

TRUE, pokud je podřízená mdI zaregistrovaná na kartách hlavního panelu Systému Windows 7; jinak NEPRAVDA.

Poznámky

CMDIChildWndEx::InvalidateIconicBitmaps

Zneplatní ikonickou rastrovou reprezentaci podřízeného objektu MDI.

BOOL InvalidateIconicBitmaps();

Návratová hodnota

Vrátí hodnotu FALSE, pokud je podpora hlavního panelu Systému Windows 7 zakázaná nebo podřízená položka MDI není zaregistrovaná na kartách hlavního panelu Systému Windows 7; v opačném případě vrátí hodnotu PRAVDA.

Poznámky

Mělo by se volat, když se změnil živý obsah nebo velikost podřízeného mdi.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Volá se rozhraním, když potřebuje vybrat část klientské oblasti okna, která se má zobrazit jako miniatura tohoto okna na hlavním panelu.

virtual CRect GetTaskbarThumbnailClipRect() const;

Návratová hodnota

Obdélník v souřadnicích oken. Tento obdélník se mapuje do klientské oblasti rámce nejvyšší úrovně. Obdélník by měl být prázdný, aby byl obdélník výřezu prázdný.

Poznámky

CMDIChildWndEx::GetTaskbarPreviewWnd

Volané architekturou, když potřebuje získat podřízené okno (obvykle zobrazení nebo rozdělené okno), které se má zobrazit na miniaturě karty hlavního panelu Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Návratová hodnota

Měl by vrátit platný ukazatel na CWnd objekt, jehož náhled by se měl zobrazit na kartě hlavního panelu Windows 7 související s tímto podřízeným objektem MDI. Výchozí implementace vrátí podřízené okno tohoto podřízeného MDI s ID ovládacího prvku AFX_IDW_PANE_FIRST (což je obvykle CView-odvozená třída).

Poznámky

CMDIChildWndEx::GetTabProxyWnd

Vrátí okno proxy karet zaregistrované na kartách hlavního panelu Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Návratová hodnota

Ukazatel na CMDITabProxyWnd objekt, který je zaregistrovaný na kartách hlavního panelu Windows 7.

Poznámky

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Povolí nebo zakáže automatický výběr části klientské oblasti okna, aby se zobrazila jako miniatura tohoto okna na hlavním panelu.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parametry

bEnable
Určuje, jestli se má povolit (PRAVDA) nebo zakázat automatický výběr části klientské oblasti okna(NEPRAVDA).

Poznámky

CMDIChildWndEx::CanShowOnTaskBarTabs

Informuje architekturu, zda lze toto podřízené mdI zobrazit na kartách hlavního panelu Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Návratová hodnota

TRUE, pokud lze obsah podřízeného mdI zobrazit na miniaturách hlavního panelu Windows 7.

Poznámky

Přepsat tuto metodu v odvozené třídě a vrátit HODNOTU FALSE zakázat vzhled tohoto podřízeného MDI na kartách hlavního panelu Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Volal rozhraní pro aktivaci rámce nejvyšší úrovně při aktivaci aplikace z karty hlavního panelu.

virtual void ActivateTopLevelFrame();

Poznámky

Viz také

Graf hierarchie
Třídy
CMDIChildWnd – třída
CMFCWindowsManagerDialog – třída
CMDIFrameWndEx – třída

Sdílet prostřednictvím

CMDIChildWndEx – třída

Syntaxe

Členové

Veřejné metody

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMDIChildWndEx::AddPane

Parametry

Návratová hodnota

CMDIChildWndEx::AddTabbedPane

Parametry

CMDIChildWndEx::AdjustDockingLayout

Parametry

CMDIChildWndEx::CanShowOnMDITabs

Návratová hodnota

Poznámky

CMDIChildWndEx::CanShowOnWindowsList

Návratová hodnota

Poznámky

CMDIChildWndEx::D ockPane

Parametry

Poznámky

CMDIChildWndEx::D ockPaneLeftOf

Parametry

Návratová hodnota

Poznámky

CMDIChildWndEx::EnableAutoHidePanes

Parametry

Návratová hodnota

CMDIChildWndEx::EnableDocking

Parametry

Návratová hodnota

Poznámky

CMDIChildWndEx::GetDockingManager

Návratová hodnota

Poznámky

CMDIChildWndEx::GetDocumentName

Návratová hodnota

Poznámky

Příklad

CMDIChildWndEx::GetFrameIcon

Návratová hodnota

Poznámky

CMDIChildWndEx::GetFrameText

Návratová hodnota

Poznámky

CMDIChildWndEx::GetPane

Parametry

Návratová hodnota

CMDIChildWndEx::GetRelatedTabGroup

Návratová hodnota

Poznámky

CMDIChildWndEx::GetTabbedPane

Návratová hodnota

CMDIChildWndEx::GetToolbarButtonToolTipText

Návratová hodnota

Poznámky

CMDIChildWndEx::InsertPane

Parametry

Návratová hodnota

CMDIChildWndEx::IsPointNearDockSite

Parametry

Návratová hodnota

Poznámky

CMDIChildWndEx::IsReadOnly

Návratová hodnota

Poznámky

Příklad

CMDIChildWndEx::IsTabbedPane

Návratová hodnota

CMDIChildWndEx::OnMoveMiniFrame

Parametry

Návratová hodnota

CMDIChildWndEx::OnSetPreviewMode

Parametry

CMDIChildWndEx::OnUpdateFrameTitle

Parametry