Klasa CMDIChildWndEx
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
Członkowie
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 | Aktualizacje ikona karty paska 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
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
Aktualizacje 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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla