Udostępnij za pośrednictwem

Klasa CMDIChildWndEx

  • Artykuł

Klasa CMDIChildWndEx udostępnia funkcje okna podrzędnego interfejsu wielu dokumentów systemu Windows (MDI). Rozszerza funkcjonalność klasy CMDIChildWnd. Struktura wymaga tej klasy, gdy aplikacja MDI używa niektórych klas MFC.

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMDIChildWndEx : public CMDIChildWnd

Elementy członkowskie

Metody publiczne

Nazwa/nazwisko opis
CMDIChildWndEx::ActivateTopLevelFrame Wywoływana wewnętrznie przez platformę w celu aktywowania ramki najwyższego poziomu, gdy aplikacja powinna zostać aktywowana na karcie paska zadań.
CMDIChildWndEx::AddDockSite Ta metoda nie jest używana ani implementowana.
CMDIChildWndEx::AddPane Dodaje okienko.
CMDIChildWndEx::AddTabbedPane Dodaje okienko z kartami.
CMDIChildWndEx::AdjustDockingLayout Dostosowuje układ dokowania.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs Informuje platformę, czy to podrzędne rozwiązanie MDI może być wyświetlane na kartach paska zadań systemu Windows 7.
CMDIChildWndEx::CanShowOnWindowsList Zwraca wartość TRUE, jeśli nazwę okna podrzędnego MDI można wyświetlić w oknie dialogowym Klasa CMFCWindowsManagerDialog. W przeciwnym razie zwraca wartość FALSE.
CMDIChildWndEx::CreateObject Wywoływana przez platformę w celu utworzenia dynamicznego wystąpienia tego typu klasy.
CMDIChildWndEx::D ockPane Zadokuje okienko.
CMDIChildWndEx::D ockPaneLeftOf Zadokuje jedno okienko po lewej stronie innego okienka.
CMDIChildWndEx::EnableAutoHidePanes Włącza tryb automatycznego ukrywania okienek, gdy są one zadokowane po określonych stronach okna.
CMDIChildWndEx::EnableDocking Umożliwia zadokowanie okna podrzędnego do ramki głównej.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect Włącza lub wyłącza automatyczne wybieranie części obszaru klienta okna w celu wyświetlenia jako miniatury tego okna na pasku zadań.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName Zwraca nazwę dokumentu wyświetlanego w oknie podrzędnym MDI.
CMDIChildWndEx::GetFrameIcon Wywoływana przez platformę w celu pobrania ikony okna podrzędnego MDI.
CMDIChildWndEx::GetFrameText Wywoływana przez platformę w celu pobrania tekstu okna podrzędnego MDI.
CMDIChildWndEx::GetPane Znajduje okienko według określonego identyfikatora kontrolki.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane Zwraca wskaźnik do osadzonego okienka dokowania przekonwertowanego na dokument z kartą.
CMDIChildWndEx::GetTabProxyWnd Zwraca okno serwera proxy karty rzeczywiście zarejestrowane przy użyciu kart paska zadań systemu Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd Wywoływana przez platformę, gdy musi uzyskać okno podrzędne (zazwyczaj okno widoku lub podziału), które ma być wyświetlane na miniaturze karty paska zadań systemu Windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect Wywoływana przez platformę, gdy musi wybrać część obszaru klienta okna, która ma być wyświetlana jako miniatura tego okna na pasku zadań.
CMDIChildWndEx::GetThisClass Wywoływana przez strukturę w celu uzyskania wskaźnika do obiektu CRuntimeClass skojarzonego z tym typem klasy.
CMDIChildWndEx::GetToolbarButtonToolTipText Wywoływana przez strukturę w celu pobrania etykietki narzędzia dla przycisku paska narzędzi.
CMDIChildWndEx::InsertPane Rejestruje określone okienko za pomocą menedżera dokowania.
CMDIChildWndEx::InvalidateIconicBitmaps Unieważnia kultową reprezentację map bitowych elementu podrzędnego MDI.
CMDIChildWndEx::IsPointNearDockSite Określa, czy określony punkt znajduje się w pobliżu lokacji docku.
CMDIChildWndEx::IsReadOnly Zwraca wartość TRUE, jeśli dokument wyświetlany w oknie podrzędnym jest tylko do odczytu. W przeciwnym razie zwraca wartość FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs Zwraca wartość TRUE, jeśli element podrzędny MDI został pomyślnie zarejestrowany na kartach paska zadań systemu Windows 7.
CMDIChildWndEx::IsTabbedPane Zwraca wartość TRUE, jeśli okno podrzędne MDI zawiera okienko dokowania. W przeciwnym razie zwraca wartość FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled Informuje, czy element podrzędny MDI może być wyświetlany na kartach paska zadań systemu Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled Informuje, czy automatyczny wybór części obszaru klienta okna do wyświetlenia jako miniatury tego okna na pasku zadań jest włączony, czy wyłączony.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags Kombinacja flag, która jest przekazywana przez strukturę do metody SetTaskbarTabProperties, gdy karta (element podrzędny MDI) jest rejestrowana przy użyciu kart paska zadań systemu Windows 7. Domyślna kombinacja to STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap Wywoływana przez platformę, gdy musi uzyskać mapę bitową dla dynamicznej wersji zapoznawczej elementu podrzędnego MDI.
CMDIChildWndEx::OnGetIconicThumbnail Wywoływana przez platformę, gdy musi uzyskać mapę bitową dla ikonicznej miniatury elementu podrzędnego MDI.
CMDIChildWndEx::OnMoveMiniFrame Wywoływana przez platformę w celu przeniesienia okna mini-ramka.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton Wywoływana przez platformę, gdy użytkownik naciska przycisk zamknij na miniaturze karty Paska zadań.
CMDIChildWndEx::OnSetPreviewMode Wywoływana przez strukturę w celu wprowadzenia lub zakończenia trybu podglądu wydruku.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate Wywoływana przez platformę, gdy miniatura karty Pasek zadań powinna przetworzyć komunikat WM_ACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate Wywoływana przez platformę, gdy miniatura karty Pasek zadań powinna przetworzyć komunikat WM_MOUSEACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch Wywoływana przez platformę, gdy musi rozciągnąć mapę bitową dla podglądu miniatur na karcie paska zadań systemu Windows 7 podrzędnego MDI.
CMDIChildWndEx::OnUpdateFrameTitle Wywoływana przez strukturę w celu zaktualizowania tytułu ramki. (Przesłania CMDIChildWnd::OnUpdateFrameTitle).
CMDIChildWndEx::P aneFromPoint Zwraca okienko zawierające dany punkt.
CMDIChildWndEx::PreTranslateMessage Używany przez klasę CWinApp do tłumaczenia komunikatów okien przed ich wysłaniem do funkcji TranslateMessage i DispatchMessage systemu Windows. (Przesłonięcia) CWnd::P reTranslateMessage).
CMDIChildWndEx::RecalcLayout Oblicza ponownie układ okna.
CMDIChildWndEx::RegisterTaskbarTab Rejestruje element podrzędny MDI przy użyciu kart paska zadań systemu Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager Usuwa okienko z menedżera dokowania.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive Aktywuje odpowiednią kartę paska zadań systemu Windows 7.
CMDIChildWndEx::SetTaskbarTabOrder Wstawia element podrzędny MDI przed określonym oknem na kartach paska zadań systemu Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties Ustawia właściwości karty paska zadań systemu Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect Wywoływana wewnętrznie przez strukturę, aby ustawić prostokąt wycinków, aby wybrać część obszaru klienta okna, która ma być wyświetlana jako miniatura tego okna na pasku zadań.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab Usuwa element podrzędny MDI z kart paska zadań systemu Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon Aktualizuje ikonę karty pasek zadań systemu Windows 7.

Uwagi

Aby korzystać z rozszerzonych funkcji dokowania w aplikacjach MDI, należy utworzyć klasę okna podrzędnego MDI aplikacji CMDIChildWndEx zamiast CMDIChildWnd.

Przykład

W poniższym przykładzie utworzono klasę z klasy CMDIChildWndEx. Ten fragment kodu pochodzi z przykładu VisualStudioDemo: aplikacja MFC 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()
};

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CFrameWnd

CMDIChildWnd

CMDIChildWndEx

Wymagania

Nagłówek: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Dodaje okienko.

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

Parametry

pControlBar
[in] Wskaźnik do okienka.

bTail
[in] WARTOŚĆ TRUE, aby dodać okienko na końcu listy okienek dla menedżera dokowania; w przeciwnym razie, FAŁSZ.

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie zarejestrowane w menedżerze dokowania; w przeciwnym razie, FAŁSZ.

CMDIChildWndEx::AddTabbedPane

Dodaje okienko z kartami.

void AddTabbedPane(CDockablePane* pControlBar);

Parametry

pControlBar
[in] Wskaźnik do okienka.

CMDIChildWndEx::AdjustDockingLayout

Dostosowuje układ dokowania.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parametry

hdwp
[in] Dojście do struktury odroczonego położenia okna.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Wartość zwracana

Uwagi

CMDIChildWndEx::CanShowOnWindowsList

Określa, czy nazwa okna podrzędnego MDI może być wyświetlana w oknie dialogowym Klasa CMFCWindowsManagerDialog.

virtual BOOL CanShowOnWindowsList();

Wartość zwracana

WARTOŚĆ TRUE, jeśli okno można wyświetlić w oknie dialogowym systemu Windows; w przeciwnym razie wartość FALSE.

Uwagi

Zastąp tę metodę w klasie pochodnej i zwróć wartość FALSE, jeśli okno nie powinno być wyświetlane w oknie dialogowym systemu Windows . Ta funkcja jest wywoływana z .CMFCWindowsManagerDialog

CMDIChildWndEx::D ockPane

Zadokuje okienko.

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

Parametry

Pasek p
[in] Wskaźnik do okienka.

nDockBarID
[in] Identyfikator okienka.

lpRect
[in] Wskaźnik do prostokąta.

Uwagi

Parametr lpRect nie jest używany.

CMDIChildWndEx::D ockPaneLeftOf

Zadokuje jedno okienko po lewej stronie innego okienka.

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

Parametry

Pasek p
Wskaźnik do okienka, który ma być zadokowany.

pLeftOf
Wskaźnik do okienka, który służy jako punkt odniesienia.

Wartość zwracana

PRAWDA w przypadku powodzenia, FALSE w przypadku niepowodzenia.

Uwagi

Ta metoda pobiera okienko określone przez pasek pBar i zadokuje je po lewej stronie okienka określonego przez pLeftOf.

Wywołaj tę metodę, gdy chcesz zadokować kilka okienek w wstępnie zdefiniowanej kolejności.

CMDIChildWndEx::EnableAutoHidePanes

Włącza tryb automatycznego ukrywania okienek, gdy są one zadokowane po określonych stronach okna.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parametry

dwDockStyle
[in] Określa boki głównego okna ramowego, które jest włączone. Użyj co najmniej jednej z następujących flag.

  • CBRS_ALIGN_LEFT

  • CBRS_ALIGN_RIGHT

  • CBRS_ALIGN_TOP

  • CBRS_ALIGN_BOTTOM

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się; w przeciwnym razie FAŁSZ.

CMDIChildWndEx::EnableDocking

Umożliwia zadokowanie okna podrzędnego do ramki głównej.

BOOL EnableDocking(DWORD dwDockStyle);

Parametry

dwDockStyle
[in] Określa wyrównanie dokowania, aby włączyć.

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się; w przeciwnym razie FAŁSZ.

Uwagi

Wywołaj tę metodę, aby umożliwić wyrównanie dokowania do ramki głównej. Możesz przekazać kombinację flag CBRS_ALIGN_ (aby uzyskać więcej informacji, zobacz CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Wartość zwracana

Uwagi

CMDIChildWndEx::GetDocumentName

Zwraca nazwę dokumentu wyświetlanego w oknie podrzędnym MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Wartość zwracana

Wskaźnik do ciągu zawierającego nazwę dokumentu.

Uwagi

Zostanie wyświetlone okno podrzędne MDI. Ogólnie rzecz biorąc, w oknie są wyświetlane dane załadowane z pliku lub zapisane w pliku. W związku z tym nazwa dokumentu jest nazwą pliku. Domyślna implementacja funkcji GetDocumentName zwraca ciąg uzyskany z CDocument::GetPathNameklasy .

Jeśli w oknie zostanie wyświetlony dokument, który nie został załadowany z pliku, przesłoń tę metodę w klasie pochodnej i zwróci unikatowy identyfikator dokumentu.

GetDocumentName program jest wywoływany przez platformę podczas zapisywania stanu wszystkich otwartych dokumentów. Zwrócony ciąg jest zapisywany w rejestrze.

Gdy struktura przywraca stan później, nazwa dokumentu jest odczytywana z rejestru i przekazywana do cmDIFrameWndEx::CreateDocumentWindow. Zastąp tę metodę w klasie pochodnej CMDIFrameWndEx i utwórz lub otwórz dokument o tej nazwie i odczytaj w pliku o tej nazwie. Jeśli dokument nie jest oparty na pliku, utwórz dokument na podstawie samego identyfikatora dokumentu. Powyższe akcje należy wykonać tylko wtedy, gdy zamierzasz zapisywać i przywracać dokumenty.

Przykład

W poniższym przykładzie pokazano użycie GetDocumentName metody . Ten fragment kodu pochodzi z przykładu VisualStudioDemo: aplikacja MFC Visual Studio.

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

CMDIChildWndEx::GetFrameIcon

Wywoływana przez platformę w celu pobrania ikony okna podrzędnego MDI.

virtual HICON GetFrameIcon() const;

Wartość zwracana

Uchwyt do ikony okna.

Uwagi

Ta metoda jest wywoływana przez platformę, aby określić, która ikona ma być wyświetlana na karcie MDI, która zawiera okno ramki podrzędnej MDI.

Domyślnie ta metoda zwraca ikonę okna. Zastąp GetFrameIcon w klasie -pochodnej CMDIChildWndEx, aby dostosować to zachowanie.

CMDIChildWndEx::GetFrameText

Wywoływana przez platformę w celu pobrania tekstu okna podrzędnego MDI.

virtual CString GetFrameText() const;

Wartość zwracana

Ciąg zawierający tekst okna ramki.

Uwagi

Ta metoda jest wywoływana przez platformę w celu określenia tekstu, który ma być wyświetlany na karcie MDI zawierającej okno ramki podrzędnej MDI.

Domyślnie ta metoda zwraca tekst okna. Zastąp GetFrameText w klasie -pochodnej CMDIChildWndEx, aby dostosować to zachowanie.

CMDIChildWndEx::GetPane

Znajduje okienko według określonego identyfikatora kontrolki.

CBasePane* GetPane(UINT nID);

Parametry

Nid
[in] Identyfikator kontrolki okienka do znalezienia.

Wartość zwracana

Wskaźnik do okienka, jeśli zostanie znaleziony, w przeciwnym razie null.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Wartość zwracana

Uwagi

CMDIChildWndEx::GetTabbedPane

Zwraca wskaźnik do okienka dokowania będącego częścią grupy dokumentów z kartami MDI.

CDockablePane* GetTabbedPane() const;

Wartość zwracana

Wskaźnik do okienka dokowania, który jest częścią grupy dokumentów z kartami MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

Wywoływana przez strukturę w celu pobrania etykietki narzędzia dla przycisku paska narzędzi.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Wartość zwracana

Wartość TRUE, jeśli etykietka narzędzia została wyświetlona. Domyślna implementacja zwraca wartość FALSE.

Uwagi

Zastąpi tę metodę, jeśli chcesz wyświetlić niestandardowe porady dotyczące narzędzi dla przycisków paska narzędzi.

CMDIChildWndEx::InsertPane

Rejestruje określone okienko za pomocą menedżera dokowania.

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

Parametry

pControlBar
[in] Wskaźnik do okienka do wstawienia.

pTarget
[in] Wskaźnik do sąsiedniego okienka.

bAfter
[in] Jeśli wartość TRUE, pControlBar zostanie wstawiony po parametrze pTarget. Jeśli wartość FALSE, pControlBar zostanie wstawiony przed parametrem pTarget.

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się, w przeciwnym razie wartość FALSE.

CMDIChildWndEx::IsPointNearDockSite

Określa, czy określony punkt znajduje się w pobliżu lokacji docku.

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

Parametry

punkt
[in] Określony punkt.

dwBarAlignment
[in] Określa krawędź, w której znajduje się punkt. Możliwe wartości to CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP i CBRS_ALIGN_BOTTOM

bOuterEdge
[in] WARTOŚĆ TRUE, jeśli punkt znajduje się w pobliżu zewnętrznej granicy miejsca docka; FAŁSZ w przeciwnym razie.

Wartość zwracana

WARTOŚĆ TRUE, jeśli punkt znajduje się w pobliżu miejsca dokowania; w przeciwnym razie FAŁSZ.

Uwagi

Punkt znajduje się w pobliżu miejsca dokowania, gdy znajduje się w obrębie poufności ustawionej w menedżerze dokowania. Domyślna czułość to 15 pikseli.

CMDIChildWndEx::IsReadOnly

Określa, czy dokument wyświetlany w oknie podrzędnym jest tylko do odczytu.

virtual BOOL IsReadOnly();

Wartość zwracana

WARTOŚĆ TRUE, jeśli dokument jest tylko do odczytu; w przeciwnym razie FAŁSZ.

Uwagi

Ta funkcja służy do zapobiegania zapisywaniu dokumentów tylko do odczytu.

Przykład

W poniższym przykładzie pokazano zastąpienie IsReadOnly metody . Ten fragment kodu pochodzi z przykładu VisualStudioDemo: aplikacja MFC Visual Studio.

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

CMDIChildWndEx::IsTabbedPane

Określa, czy okno podrzędne MDI zawiera okienko dockowania.

BOOL IsTabbedPane() const;

Wartość zwracana

Wartość TRUE, jeśli okno podrzędne MDI zawiera okienko dokowania, które zostało przekonwertowane na dokument z kartami; w przeciwnym razie FAŁSZ.

CMDIChildWndEx::OnMoveMiniFrame

Wywoływana przez platformę w celu przeniesienia okna mini-ramka.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parametry

Ramka pFrame
[in] Wskaźnik do mini-ramy okna.

Wartość zwracana

Wartość TRUE, jeśli metoda powiedzie się, w przeciwnym razie wartość FALSE.

CMDIChildWndEx::OnSetPreviewMode

Wywoływana przez strukturę w celu wprowadzenia lub zakończenia trybu podglądu wydruku.

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

Parametry

bPreview
[in] Jeśli wartość TRUE, wprowadź tryb podglądu wydruku. Jeśli wartość FALSE, zamknij tryb podglądu wydruku.

pState
[in] Wskaźnik do struktury stanu podglądu wydruku.

CMDIChildWndEx::OnUpdateFrameTitle

Wywoływana przez strukturę w celu zaktualizowania tytułu ramki.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parametry

bAddToTitle
[in] Jeśli wartość TRUE, dodaj nazwę dokumentu do tytułu.

CMDIChildWndEx::P aneFromPoint

Zwraca okienko zawierające dany punkt.

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

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

Parametry

punkt
[in] Określa punkt we współrzędnych ekranu, aby sprawdzić.

nSensitivity
[in] Zwiększ obszar wyszukiwania o tę kwotę. Okienko spełnia kryteria wyszukiwania, jeśli dany punkt spadnie w zwiększonym obszarze.

bExactBar
[in] Wartość TRUE, aby zignorować parametr nSensitivity ; w przeciwnym razie wartość FALSE.

pRTCBarType
[in] Jeśli nie ma wartości NULL, metoda wyszukuje tylko okienka określonego typu.

dwAlignment
[in] Jeśli okienko zostanie znalezione w określonym punkcie, ten parametr zawiera stronę okienka znajdującego się najbliżej określonego punktu. Aby uzyskać więcej informacji, zobacz sekcję: Uwagi.

Wartość zwracana

Wskaźnik do CBasePane-pochodnego obiektu, który zawiera dany punkt lub NULL, jeśli nie znaleziono okienka.

Uwagi

Wywołaj tę metodę, aby określić, czy okienko zawiera określony punkt zgodnie z określonymi warunkami, takimi jak klasa środowiska uruchomieniowego i widoczność.

Po znalezieniu funkcji i znalezieniu okienka dwAlignment zawiera wyrównanie określonego punktu. Jeśli na przykład punkt znajdował się najbliżej górnej części okienka, wartość dwAlignment jest ustawiona na wartość CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Oblicza ponownie układ okna.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

bNotify
[in] Jeśli wartość TRUE, aktywny element w miejscu okna otrzyma powiadomienie o zmianie układu.

CMDIChildWndEx::RemovePaneFromDockManager

Usuwa okienko z menedżera dokowania.

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

Parametry

pControlBar
[in] Wskaźnik do okienka do usunięcia.

bDestroy
[in] Jeśli wartość TRUE, usunięte okienko zostanie zniszczone.

bAdjustLayout
[in] Jeśli wartość TRUE, dostosuj układ dokowania natychmiast.

bAutoHide
[in] Jeśli wartość TRUE, układ dokowania jest powiązany z listą pasków automatycznego ukrywania. Jeśli wartość FALSE, układ dokowania jest powiązany z listą zwykłych okienek.

pBarReplacement
[in] Wskaźnik do okienka, który zastępuje usunięte okienko.

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parametry

[in] p

Uwagi

CMDIChildWndEx::ShowPane

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

Parametry

[in] Pasek p

[in] bShow

[in] bDelay

[in] bActivate

Uwagi

CMDIChildWndEx::UpdateTaskbarTabIcon

Aktualizuje ikonę karty pasek zadań systemu Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parametry

hIcon
Uchwyt do ikony do wyświetlenia na karcie paska zadań systemu Windows 7.

Uwagi

CMDIChildWndEx::UnregisterTaskbarTab

Usuwa element podrzędny MDI z kart paska zadań systemu Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parametry

bCheckRegisteredMDIChildCount
Określa, czy ta funkcja musi sprawdzić liczbę elementów podrzędnych MDI zarejestrowanych na kartach MDI. Jeśli ta liczba to 0, ta funkcja usuwa prostokąt wycinków z miniatury paska zadań aplikacji.

Uwagi

CMDIChildWndEx::SetTaskbarThumbnailClipRect

Wywoływana przez strukturę w celu ustawienia prostokąta wycinków w celu wybrania części obszaru klienta okna, która ma być wyświetlana jako miniatura tego okna na pasku zadań.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parametry

Rect
Określa nowy prostokąt wycinków. Jeśli prostokąt jest pusty lub ma wartość null, wycinki zostaną usunięte.

Wartość zwracana

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

CMDIChildWndEx::SetTaskbarTabProperties

Ustawia właściwości karty paska zadań systemu Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parametry

dwFlags
Kombinacja wartości STPFLAG. Aby uzyskać więcej informacji, zobacz ITaskbarList4::SetTabProperties.

Uwagi

CMDIChildWndEx::SetTaskbarTabOrder

Wstawia element podrzędny MDI przed określonym oknem na kartach paska zadań systemu Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parametry

pWndBefore
Wskaźnik do okna podrzędnego MDI, którego miniatura jest wstawiona po lewej stronie. To okno musi być już zarejestrowane za pomocą polecenia RegisterTaskbarTab. Jeśli ta wartość ma wartość NULL, nowa miniatura zostanie dodana na końcu listy.

Uwagi

CMDIChildWndEx::SetTaskbarTabActive

Aktywuje odpowiednią kartę paska zadań systemu Windows 7.

void SetTaskbarTabActive();

Uwagi

CMDIChildWndEx::RegisterTaskbarTab

Rejestruje element podrzędny MDI za pomocą kart paska zadań systemu Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parametry

pWndBefore
Wskaźnik do okna podrzędnego MDI, którego miniatura jest wstawiona po lewej stronie. To okno musi być już zarejestrowane za pomocą polecenia RegisterTaskbarTab. Jeśli ta wartość ma wartość NULL, nowa miniatura zostanie dodana na końcu listy.

Uwagi

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

Wywoływana przez platformę, gdy musi rozciągnąć mapę bitową dla podglądu miniatur karty paska zadań systemu Windows 7 podrzędnego MDI.

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

Parametry

hBmpDst
Uchwyt do docelowej mapy bitowej.

rectDst
Określa prostokąt docelowy.

hBmpSrc
Uchwyt do źródłowej mapy bitowej.

rectSrc
Określa prostokąt źródłowy.

Uwagi

Wymaganie: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

Wywoływana przez platformę, gdy miniatura karty Pasek zadań powinna przetworzyć komunikat WM_MOUSEACTIVATE.

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

Parametry

pDesktopWnd
Określa wskaźnik do okna nadrzędnego najwyższego poziomu aktywowanego okna. Wskaźnik może być tymczasowy i nie powinien być przechowywany.

nHitTest
Określa kod obszaru testu trafień. Test trafienia to test określający lokalizację kursora.

message
Określa numer komunikatu myszy.

Uwagi

Domyślna implementacja aktywuje powiązaną ramkę podrzędną MDI.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

Wywoływana przez platformę, gdy miniatura karty Pasek zadań powinna przetworzyć komunikat WM_ACTIVATE.

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

Parametry

nState
Określa, czy CWnd element jest aktywowany, czy dezaktywowany.

pWndOther
Wskaźnik do CWnd aktywowania lub dezaktywowania. Wskaźnik może mieć wartość NULL i może być tymczasowy.

bMinimized
Określa zminimalizowany stan CWnd aktywowania lub dezaktywowania. Wartość TRUE wskazuje, że okno jest zminimalizowane.

Uwagi

Domyślna implementacja aktywuje powiązaną ramkę podrzędną MDI.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

Wywoływana przez platformę, gdy użytkownik naciska przycisk zamknij na miniaturze karty Pasek zadań.

virtual void OnPressTaskbarThmbnailCloseButton();

Uwagi

CMDIChildWndEx::OnGetIconicThumbnail

Wywoływana przez platformę, gdy musi uzyskać mapę bitową dla ikonicznej miniatury dziecka MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parametry

nWidth
Określa szerokość wymaganej mapy bitowej.

nHeight
Określa wysokość wymaganej mapy bitowej.

Uwagi

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

Wywoływana przez platformę, gdy musi uzyskać mapę bitową na żywo w wersji zapoznawczej elementu podrzędnego MDI.

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

Parametry

bIsMDIChildActive
Ten parametr ma wartość TRUE, jeśli mapa bitowa jest żądana dla elementu podrzędnego MDI, który jest obecnie aktywny, a okno główne nie jest zminimalizowane. Domyślne przetwarzanie w tym przypadku tworzy migawkę okna głównego.

ptLocation
Określa lokalizację mapy bitowej we współrzędnych klienta okna głównego (najwyższego poziomu). Ten punkt powinien być dostarczany przez obiekt wywoływany.

Wartość zwracana

W przypadku przetworzenia zwraca uchwyt do prawidłowej mapy bitowej 32bpp, w przeciwnym razie wartość NULL.

Uwagi

Zastąp tę metodę w klasie pochodnej i zwróć prawidłową mapę bitową 32bpp dla dynamicznej wersji zapoznawczej elementu podrzędnego MDI. Ta metoda jest wywoływana tylko wtedy, gdy element podrzędny MDI jest wyświetlany na kartach paska zadań systemu Windows 7. Jeśli zwracasz wartość NULL, MFC wywołuje domyślne programy obsługi i uzyskuje mapy bitowe przy użyciu metody PrintClient lub PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Kombinacja flag, która jest przekazywana przez platformę do SetTaskbarTabProperties metody, gdy karta (element podrzędny MDI) jest rejestrowana przy użyciu kart paska zadań systemu Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Uwagi

Domyślna kombinacja to STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Informuje, czy automatyczny wybór części obszaru klienta okna do wyświetlenia jako miniatury tego okna na pasku zadań jest włączony, czy wyłączony.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Wartość zwracana

Zwraca wartość TRUE, jeśli jest włączony automatyczny wybór części obszaru klienta okna do wyświetlenia; w przeciwnym razie FAŁSZ.

Uwagi

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Informuje, czy element podrzędny MDI może być wyświetlany na kartach paska zadań systemu Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Wartość zwracana

Wartość TRUE, jeśli element podrzędny MDI może być wyświetlany na kartach paska zadań systemu Windows 7; FAŁSZ, jeśli element podrzędny MDI nie może pojawić się na kartach paska zadań systemu Windows 7.

Uwagi

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Zwraca wartość TRUE, jeśli element podrzędny MDI został pomyślnie zarejestrowany na kartach paska zadań systemu Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Wartość zwracana

Wartość TRUE, jeśli element podrzędny MDI jest zarejestrowany na kartach paska zadań systemu Windows 7; w przeciwnym razie FAŁSZ.

Uwagi

CMDIChildWndEx::InvalidateIconicBitmaps

Unieważnia ikoniczną reprezentację elementu podrzędnego MDI na mapie bitowej.

BOOL InvalidateIconicBitmaps();

Wartość zwracana

Zwraca wartość FALSE, jeśli obsługa paska zadań systemu Windows 7 jest wyłączona lub element podrzędny MDI nie jest zarejestrowany na kartach paska zadań systemu Windows 7; w przeciwnym razie zwraca wartość TRUE.

Uwagi

Powinna być wywoływana, gdy zawartość na żywo lub rozmiar elementu podrzędnego MDI uległ zmianie.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

Wywoływana przez platformę, gdy musi wybrać część obszaru klienta okna, która ma być wyświetlana jako miniatura tego okna na pasku zadań.

virtual CRect GetTaskbarThumbnailClipRect() const;

Wartość zwracana

Prostokąt we współrzędnych okien. Ten prostokąt jest mapowany na obszar klienta ramki najwyższego poziomu. Prostokąt powinien być pusty, aby wyczyścić prostokąt wycinkowy.

Uwagi

CMDIChildWndEx::GetTaskbarPreviewWnd

Wywoływana przez platformę, gdy musi uzyskać okno podrzędne (zazwyczaj okno widoku lub podziału), które ma być wyświetlane na miniaturze karty paska zadań systemu Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Wartość zwracana

Powinien zwrócić prawidłowy wskaźnik do CWnd obiektu, którego podgląd powinien być wyświetlany na karcie paska zadań systemu Windows 7 powiązanego z tym elementem podrzędnym MDI. Domyślna implementacja zwraca okno podrzędne tego podrzędnego elementu podrzędnego MDI z identyfikatorem kontrolki AFX_IDW_PANE_FIRST (zwykle jest to klasa pochodna CView).

Uwagi

CMDIChildWndEx::GetTabProxyWnd

Zwraca okno serwera proxy karty zarejestrowane na kartach paska zadań systemu Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Wartość zwracana

Wskaźnik do obiektu zarejestrowanego CMDITabProxyWnd za pomocą kart paska zadań systemu Windows 7.

Uwagi

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Włącza lub wyłącza automatyczne wybieranie części obszaru klienta okna w celu wyświetlenia jako miniatury tego okna na pasku zadań.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parametry

bEnable
Określa, czy włączyć (PRAWDA) lub wyłączyć automatyczny wybór części obszaru klienta okna do wyświetlenia.

Uwagi

CMDIChildWndEx::CanShowOnTaskBarTabs

Informuje platformę, czy to podrzędne rozwiązanie MDI może być wyświetlane na kartach paska zadań systemu Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Wartość zwracana

Wartość TRUE, jeśli zawartość elementu podrzędnego MDI może być wyświetlana na miniaturach paska zadań systemu Windows 7.

Uwagi

Zastąp tę metodę w klasie pochodnej i zwróć wartość FALSE, aby wyłączyć wygląd tego elementu podrzędnego MDI na kartach paska zadań systemu Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

Wywoływana przez platformę w celu aktywowania ramki najwyższego poziomu po aktywowaniu aplikacji na karcie paska zadań.

virtual void ActivateTopLevelFrame();

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMDIChildWnd
Klasa CMFCWindowsManagerDialog
Klasa CMDIFrameWndEx