Udostępnij za pośrednictwem

Klasa CBasePane

  • Artykuł

Klasa bazowa dla wszystkich okienek w MFC.

Składnia

class CBasePane : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CBasePane::CBasePane Konstruktor domyślny.
CBasePane::~CBasePane Destruktor.

Metody publiczne

Nazwa/nazwisko opis
CBasePane::accHitTest Wywoływana przez platformę w celu pobrania elementu podrzędnego lub obiektu podrzędnego w danym punkcie na ekranie. (Przesłonięcia) CWnd::accHitTest).
CBasePane::accLocation Wywoływana przez strukturę w celu pobrania bieżącej lokalizacji ekranu dla określonego obiektu. (Przesłonięcia) CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent CBasePane nie używa tej metody.
CBasePane::accSelect Wywoływana przez strukturę w celu zmodyfikowania zaznaczenia lub przeniesienia fokusu klawiatury określonego obiektu. (Przesłonięcia) CWnd::accSelect.)
CBasePane::AddPane Dodaje okienko do menedżera dokowania.
CBasePane::AdjustDockingLayout Przekierowuje wywołanie do menedżera dokowania w celu dostosowania układu dokowania.
CBasePane::AdjustLayout Wywoływana przez strukturę, gdy okienko powinno dostosować układ wewnętrzny.
CBasePane::CalcFixedLayout Oblicza rozmiar poziomy paska sterowania.
CBasePane::CanAcceptPane Określa, czy można zadokować kolejne okienko do okienka.
CBasePane::CanAutoHide Określa, czy okienko obsługuje tryb automatycznego ukrywania.
CBasePane::CanBeAttached Określa, czy okienko można zadokować do innego okienka.
CBasePane::CanBeClosed Określa, czy okienko można zamknąć.
CBasePane::CanBeDocked Określa, czy okienko można zadokować do innego okienka.
CBasePane::CanBeResized Określa, czy można zmienić rozmiar okienka.
CBasePane::CanBeTabbedDocument Określa, czy okienko można przekonwertować na dokument z kartami MDI.
CBasePane::CanFloat Określa, czy okienko może upłynąć zmiennoprzecinkowe.
CBasePane::CanFocus Określa, czy okienko może odbierać fokus.
CBasePane::CopyState Kopiuje stan danego okienka.
CBasePane::CreateDefaultMiniframe Jeśli okienko może unosić się, tworzy mini-ramowe okno.
CBasePane::CreateEx Tworzy kontrolkę okienka.
CBasePane::D ockPane Zadokuje okienko do innego okienka lub okna ramowego.
CBasePane::D ockPaneUsingRTTI Zadokuje okienko przy użyciu informacji o typie czasu wykonywania.
CBasePane::D ockToFrameWindow Zadokuje dokowalne okienko do ramki.
CBasePane::D oesAllowDynInsertBefore Określa, czy inne okienko może być dynamicznie wstawione między tym okienkem a ramką nadrzędną.
CBasePane::EnableDocking Umożliwia zadokowanie okienka do ramki głównej.
CBasePane::EnableGripper Włącza lub wyłącza uchwyt. Jeśli uchwyt jest włączony, użytkownik może przeciągnąć go, aby zmienić położenie okienka.
CBasePane::FillWindowRect Używane wewnętrznie.
CBasePane::FloatPane Unosi okienko.
CBasePane::get_accChild Wywoływana przez strukturę w celu pobrania adresu interfejsu IDispatch dla określonego elementu podrzędnego. (Przesłonięcia) CWnd::get_accChild.)
CBasePane::get_accChildCount Wywoływana przez strukturę w celu pobrania liczby elementów podrzędnych należących do tego obiektu. (Przesłonięcia) CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction Wywoływana przez platformę w celu pobrania ciągu opisującego domyślną akcję obiektu. (Przesłonięcia) CWnd::get_accDefaultAction.)
CBasePane::get_accDescription Wywoływana przez platformę w celu pobrania ciągu opisującego wygląd wizualizacji określonego obiektu. (Przesłonięcia) CWnd::get_accDescription.)
CBasePane::get_accFocus Wywoływana przez strukturę w celu pobrania obiektu, który ma fokus klawiatury. (Przesłonięcia) CWnd::get_accFocus.)
CBasePane::get_accHelp Wywoływana przez platformę w celu pobrania ciągu właściwości Pomocy dla obiektu. (Przesłonięcia) CWnd::get_accHelp.)
CBasePane::get_accHelpTopic Wywoływana przez platformę w celu pobrania pełnej ścieżki pliku WinHelp skojarzonego z określonym obiektem i identyfikatorem odpowiedniego tematu w tym pliku. (Przesłonięcia) CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut Wywoływana przez strukturę w celu pobrania określonego skrótu dla obiektu. (Przesłonięcia) CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName Wywoływana przez strukturę w celu pobrania nazwy określonego obiektu. (Przesłonięcia) CWnd::get_accName.)
CBasePane::get_accParent Wywoływana przez strukturę w celu pobrania IDispatch interfejsu dla obiektu nadrzędnego obiektu. (Przesłonięcia) CWnd::get_accParent.)
CBasePane::get_accRole Wywoływana przez platformę w celu pobrania informacji opisujących rolę określonego obiektu. (Przesłonięcia) CWnd::get_accRole.)
CBasePane::get_accSelection Wywoływana przez strukturę w celu pobrania wybranych elementów podrzędnych tego obiektu. (Przesłonięcia) CWnd::get_accSelection.)
CBasePane::get_accState Wywoływana przez strukturę w celu pobrania bieżącego stanu określonego obiektu. (Przesłonięcia) CWnd::get_accState.)
CBasePane::get_accValue Wywoływana przez strukturę w celu pobrania wartości określonego obiektu. (Przesłonięcia) CWnd::get_accValue.)
CBasePane::GetCaptionHeight Zwraca wysokość podpisu.
CBasePane::GetControlBarStyle Zwraca styl paska sterowania.
CBasePane::GetCurrentAlignment Zwraca wyrównanie bieżącego okienka.
CBasePane::GetDockingMode Zwraca bieżący tryb dokowania dla okienka.
CBasePane::GetDockSiteFrameWnd Zwraca wskaźnik do okna, w którym znajduje się witryna docku dla okienka.
CBasePane::GetEnabledAlignment Zwraca style CBRS_ALIGN_ stosowane do okienka.
CBasePane::GetMFCStyle Zwraca style okienka specyficzne dla MFC.
CBasePane::GetPaneIcon Zwraca uchwyt do ikony okienka.
CBasePane::GetPaneRect Używane wewnętrznie.
CBasePane::GetPaneRow Zwraca wskaźnik do obiektu CDockingPanesRow, w którym okienko jest zadokowane.
CBasePane::GetPaneStyle Zwraca styl okienka.
CBasePane::GetParentDockSite Zwraca wskaźnik do nadrzędnej lokacji dokowania.
CBasePane::GetParentMiniFrame Zwraca wskaźnik do nadrzędnego okna miniramowania.
CBasePane::GetParentTabbedPane Zwraca wskaźnik do okienka z kartami nadrzędnymi.
CBasePane::GetParentTabWnd Zwraca wskaźnik do okna nadrzędnego znajdującego się wewnątrz karty.
CBasePane::GetRecentVisibleState Struktura wywołuje tę metodę, gdy okienko zostanie przywrócone z archiwum.
CBasePane::HideInPrintPreviewMode Określa, czy okienko jest ukryte w podglądzie wydruku.
CBasePane::InsertPane Rejestruje określone okienko za pomocą menedżera dokowania.
CBasePane::IsAccessibilityCompatible Określa, czy okienko obsługuje aktywne ułatwienia dostępu.
CBasePane::IsAutoHideMode Określa, czy okienko jest w trybie automatycznego ukrywania.
CBasePane::IsDialogControl Określa, czy okienko jest kontrolką okna dialogowego.
CBasePane::IsDocked Określa, czy okienko jest zadokowane.
CBasePane::IsFloating Określa, czy okienko jest przestawne.
CBasePane::IsHorizontal Określa, czy okienko jest zadokowane w poziomie.
CBasePane::IsInFloatingMultiPaneFrameWnd Określa, czy okienko znajduje się w oknie ramki z wieloma okienkami.
CBasePane::IsMDITabbed Określa, czy okienko zostało dodane do okna podrzędnego MDI jako dokument z kartą.
CBasePane::IsPaneVisible Określa, czy flaga WS_VISIBLE jest ustawiona dla okienka.
CBasePane::IsPointNearDockSite Określa, czy określony punkt znajduje się w pobliżu lokacji docku.
CBasePane::IsResizable Określa, czy można zmienić rozmiar okienka.
CBasePane::IsRestoredFromRegistry Określa, czy okienko jest przywracane z rejestru.
CBasePane::IsTabbed Określa, czy okienko zostało wstawione w kontrolce karty okna z kartą.
CBasePane::IsTooltipTopmost Używane wewnętrznie.
CBasePane::IsVisible Określa, czy okienko jest widoczne.
CBasePane::LoadState Ładuje stan okienka z rejestru.
CBasePane::MoveWindow Przenosi okienko.
CBasePane::OnAfterChangeParent Wywoływana przez strukturę, gdy element nadrzędny okienka został zmieniony.
CBasePane::OnBeforeChangeParent Wywoływana przez platformę tuż przed zmianą okna nadrzędnego okienka.
CBasePane::OnDrawCaption Struktura wywołuje tę metodę, gdy podpis zostanie narysowany.
CBasePane::OnMovePaneDivider Ta metoda nie jest obecnie używana.
CBasePane::OnPaneContextMenu Wywoływana przez platformę podczas kompilowania menu zawierającego listę okienek.
CBasePane::OnRemoveFromMiniFrame Wywoływana przez platformę, gdy okienko zostanie usunięte z nadrzędnego mini okna ramek.
CBasePane::OnSetAccData CBasePane nie używa tej metody.
CBasePane::OnUpdateCmdUI Używane wewnętrznie.
CBasePane::P aneFromPoint Zwraca okienko zawierające dany punkt.
CBasePane::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).
CBasePane::RecalcLayout CBasePane nie używa tej metody.
CBasePane::RemovePaneFromDockManager Wyrejestrowuje okienko i usuwa je z listy w menedżerze dokowania.
CBasePane::SaveState Zapisuje stan okienka w rejestrze.
CBasePane::SelectDefaultFont Wybiera czcionkę domyślną dla danego kontekstu urządzenia.
CBasePane::Serialize Odczytuje lub zapisuje ten obiekt z lub do archiwum. (Przesłonięcia) CObject::Serialize.)
CBasePane::SetControlBarStyle Ustawia styl paska sterowania.
CBasePane::SetDockingMode Ustawia tryb dokowania dla okienka.
CBasePane::SetMDITabbed Używane wewnętrznie.
CBasePane::SetPaneAlignment Ustawia wyrównanie okienka.
CBasePane::SetPaneRect Używane wewnętrznie.
CBasePane::SetPaneStyle Ustawia styl okienka.
CBasePane::SetRestoredFromRegistry Używane wewnętrznie.
CBasePane::SetWindowPos Zmienia rozmiar, położenie i kolejność Z okienka.
CBasePane::ShowPane Wyświetla lub ukrywa okienko.
CBasePane::StretchPane Rozciąga okienko w pionie lub w poziomie.
CBasePane::UndockPane Usuwa okienko z witryny docka, suwak domyślny lub okno miniramki, w którym jest obecnie zadokowany.

Metody chronione

Nazwa/nazwisko opis
CBasePane::D oPaint Wypełnia tło okienka.

Uwagi

Jeśli chcesz utworzyć klasę okienka, która obsługuje rozszerzone funkcje dokowania dostępne w MFC, musisz utworzyć ją z CBasePane klasy CPane lub z niej.

Porady dotyczące dostosowywania

Następujące porady dotyczące dostosowywania odnoszą się do CBasePane Class klas i, które dziedziczą z niej:

  • Podczas tworzenia okienka można zastosować kilka nowych stylów:

    • AFX_CBRS_FLOAT sprawia, że okienko jest zmiennoprzecinkowe.

    • AFX_CBRS_AUTOHIDE włącza tryb automatycznego ukrywania.

    • AFX_CBRS_CLOSE umożliwia zamknięcie okienka (ukryte).

    Są to flagi, które można połączyć z bitową operacją OR.

CBasePane Implementuje następujące wirtualne metody logiczne odzwierciedlające następujące flagi: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Można je zastąpić w klasach pochodnych, aby dostosować ich zachowanie.

  • Zachowanie dokowania można dostosować przez zastąpienie CBasePane::CanAcceptPane. Aby okienko zwróciło wartość FALSE z tej metody, aby uniemożliwić zadokowaniu do niego innego okienka.

  • Jeśli chcesz utworzyć okienko statyczne, które nie może upłynąć zmiennoprzecinkowe i które uniemożliwia zadokowanie dowolnego innego okienka przed nim (podobnie jak w przykładzie OutlookDemo), utwórz je jako przestawną i przesłonięć wartość CBasePane::D oesAllowDynInsertBefore , aby zwrócić wartość FALSE. Domyślna implementacja zwraca wartość FALSE, jeśli okienko zostanie utworzone bez stylu AFX_CBRS_FLOAT.

  • Utwórz wszystkie okienka z identyfikatorami innymi niż -1.

  • Aby określić widoczność okienka, użyj CBasePane::IsVisible. Prawidłowo obsługuje stan widoczności w trybach kart i automatycznego ukrywania.

  • Jeśli chcesz utworzyć okienko z możliwością zmiany rozmiaru, utwórz je bez stylu AFX_CBRS_FLOAT i wywołaj element CFrameWnd::D ockControlBar.

  • Aby wykluczyć okienko z układu dokowania lub usunąć pasek narzędzi z paska docka, wywołaj metodę CBasePane::UndockPane. Nie należy wywoływać tej metody dla okienek w trybie automatycznego ukrywania ani okienek znajdujących się na kartach okien z kartami.

  • Jeśli chcesz oddokować lub oddokować okienko, które jest w trybie automatycznego ukrywania, musisz wywołać funkcję CDockablePane::SetAutoHideMode z wartością FALSE jako pierwszy argument przed wywołaniem CBasePane::FloatPane lub CBasePane::UndockPane.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CBasePane klasie . W tym przykładzie pokazano, jak pobrać okienko z CFrameWndEx klasy i jak ustawić tryb dokowania, wyrównanie okienka i styl okienka. Kod pochodzi z przykładu programu Word Pad.

// This CMainFrame class extends the CFrameWndEx class.
// GetPane is a method in the CFrameWndEx class which
// Returns a pointer to the pane that has the specified ID.
CBasePane *pBar = GetPane(ID_VIEW_FORMATBAR);
if (pBar != NULL)
{
    // Set the docking mode, the pane alignment, and the pane style.
    pBar->SetDockingMode(DT_STANDARD);
    pBar->SetPaneAlignment(CBRS_ALIGN_LEFT);
    pBar->SetPaneStyle(pBar->GetCurrentAlignment() | CBRS_TOOLTIPS);
    pBar->ShowPane(TRUE, FALSE, FALSE);
}

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CBasePane

Wymagania

Nagłówek: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane nie używa tej metody.

virtual void AccNotifyObjectFocusEvent(int);

Parametry

int
[in] Nieużytne.

CBasePane::AddPane

Dodaje okienko do menedżera dokowania.

void AddPane(CBasePane* pBar);

Parametry

Pasek p
[in] Wskaźnik do okienka do dodania.

Uwagi

Jest to metoda wygody, która dodaje okienko do menedżera dokowania. Korzystając z tej metody, nie trzeba pisać kodu, który analizuje typ ramki nadrzędnej.

Aby uzyskać więcej informacji, zobacz Klasa CDockingManager i CMDIFrameWndEx::AddPane.

CBasePane::AdjustDockingLayout

Przekierowuje wywołanie do menedżera dokowania w celu dostosowania układu dokowania.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parametry

hdwp
[out] Uchwyt do struktury zawierającej wiele pozycji okien.

Uwagi

Jest to metoda wygody, która dostosowuje układ dokowania. Korzystając z tej metody, nie trzeba pisać kodu, który analizuje typ ramki nadrzędnej.

Aby uzyskać więcej informacji, zobacz CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

Wywoływana przez strukturę w celu dostosowania wewnętrznego układu okienka.

virtual void AdjustLayout();

Uwagi

Struktura wywołuje tę metodę, gdy okienko musi dostosować układ wewnętrzny. Implementacja podstawowa nic nie robi.

CBasePane::CalcFixedLayout

Oblicza rozmiar poziomy paska sterowania.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

bStretch
[in] Wskazuje, czy słupek powinien być rozciągnięty do rozmiaru ramki. Parametr bStretch jest niezerowy, gdy pasek nie jest paskiem dokowania (niedostępnym do dokowania) i jest 0, gdy jest zadokowany lub pływający (dostępny do zadokowania).

bHorz
[in] Wskazuje, że pasek jest w poziomie lub w pionie. Parametr bHorz jest niezerowy, jeśli słupek jest zorientowany poziomo i jest 0, jeśli jest zorientowany pionowo.

Wartość zwracana

Rozmiar paska sterowania w pikselach CSize obiektu.

Uwagi

Zobacz sekcję uwagi w CControlBar ::CalcFixedLayout

CBasePane::CanAcceptPane

Określa, czy można zadokować kolejne okienko do okienka.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parametry

Pasek p
[in] Wskaźnik do okienka w celu zadokowania.

Wartość zwracana

Wartość TRUE, jeśli można zaakceptować inne okienko; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, zanim zadokuje okienko określone przez pasek pBar do bieżącego okienka.

Użyj tej metody i metody CBasePane::CanBeDocked , aby kontrolować sposób dokowania okienek do innych okienek w aplikacji.

Domyślna implementacja zwraca wartość FALSE.

CBasePane::CanAutoHide

Określa, czy okienko obsługuje tryb automatycznego ukrywania.

virtual BOOL CanAutoHide() const;

Wartość zwracana

Wartość TRUE, jeśli to okienko obsługuje tryb automatycznego ukrywania; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę funkcję, aby określić, czy okienko obsługuje tryb automatycznego ukrywania.

Podczas budowy można ustawić tę możliwość, przekazując flagę AFX_CBRS_AUTOHIDE do CBasePane::CreateEx.

Domyślna implementacja sprawdza flagę AFX_CBRS_AUTOHIDE. Zastąp tę metodę w klasie pochodnej, aby dostosować to zachowanie.

CBasePane::CanBeAttached

Określa, czy okienko może być zadokowane do innego okienka lub okna ramki.

virtual BOOL CanBeAttached() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko można zadokować do innego okienka lub okna ramowego; w przeciwnym razie FAŁSZ.

Uwagi

Domyślna implementacja zwraca wartość FALSE. Zastąp tę metodę w klasie pochodnej, aby włączyć lub wyłączyć możliwość dokowania bez wywoływania CBasePane::EnableDocking.

CBasePane::CanBeClosed

Określa, czy okienko można zamknąć.

virtual BOOL CanBeClosed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko można zamknąć; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy okienko można zamknąć. Jeśli metoda zwróci wartość TRUE, przycisk Zamknij zostanie dodany do paska tytułu okienka lub, jeśli okienko jest przestawne, na pasku tytułu okna miniframe okienka.

Podczas budowy można ustawić tę możliwość, przekazując flagę AFX_CBRS_CLOSE do CBasePane::CreateEx.

Domyślna implementacja sprawdza flagę AFX_CBRS_CLOSE.

CBasePane::CanBeDocked

Określa, czy okienko można zadokować do innego okienka.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parametry

pDockBar
[in] Wskaźnik do innego okienka.

Wartość zwracana

Wartość TRUE, jeśli to okienko można zadokować do innego okienka; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, zanim zadokuje okienko określone przez pDockBar do bieżącego okienka.

Użyj tej metody i metody CBasePane::CanAcceptPane , aby kontrolować sposób dokowania okienek do innych okienek w aplikacji.

Domyślna implementacja zwraca wartość FALSE.

CBasePane::CanBeResized

Określa, czy można zmienić rozmiar okienka.

virtual BOOL CanBeResized() const;

Wartość zwracana

Wartość TRUE, jeśli można zmienić rozmiar okienka; w przeciwnym razie, FAŁSZ.

Uwagi

Ta metoda sprawdza flagę AFX_CBRS_RESIZE, która jest domyślnie określona w pliku CBasePane::OnCreate. Jeśli ta flaga nie zostanie określona, menedżer dokowania flaguje okienko wewnętrznie jako nieruchome zamiast zadokować.

CBasePane::CanBeTabbedDocument

Określa, czy okienko można przekonwertować na dokument z kartami MDI.

virtual BOOL CanBeTabbedDocument() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko można przekonwertować na dokument z kartami; w przeciwnym razie, FAŁSZ. CBasePane::CanBeTabbedDocument zawsze zwraca wartość FALSE.

Uwagi

Tylko obiekty niektórych CBasePanetypów pochodnych, takich jak klasa CDockablePane, mogą być konwertowane na dokumenty z kartami.

CBasePane::CanFloat

Określa, czy okienko może upłynąć zmiennoprzecinkowe.

virtual BOOL CanFloat() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko może upłynąć zmiennoprzecinkowe; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy okienko może upłynąć zmiennoprzecinkowe.

Podczas budowy można ustawić tę możliwość, przekazując flagę AFX_CBRS_FLOAT do CBasePane::CreateEx.

Uwaga

W strukturze założono, że okienka inne niż przestawne są statyczne i że ich stan dokowania nie może ulec zmianie. W związku z tym struktura nie zapisuje stanu zadokowania nieprzecinkowych okienek.

Domyślna implementacja sprawdza styl AFX_CBRS_FLOAT.

CBasePane::CanFocus

Określa, czy okienko może odbierać fokus.

virtual BOOL CanFocus() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko może uzyskać fokus; w przeciwnym razie FAŁSZ.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby kontrolować fokus. Na przykład, ponieważ paski narzędzi nie mogą odbierać fokusu, ta metoda zwraca wartość FALSE, gdy jest wywoływana na obiektach paska narzędzi.

Platforma próbuje ustawić fokus danych wejściowych, gdy okienko jest zadokowane lub zmiennoprzecinkowe.

CBasePane::CopyState

Kopiuje stan danego okienka.

virtual void CopyState(CBasePane* pOrgBar);

Parametry

pOrgBar
[in] Wskaźnik do innego okienka.

Uwagi

Ta metoda kopiuje stan z paska pOrgBar do tego okienka.

CBasePane::CreateDefaultMiniframe

Jeśli okienko może upłynąć zmiennoprzecinkowe, ta metoda tworzy dla niego mini-ramowe okno.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parametry

rectInitial
[in] Określa współrzędne początkowe okna miniramki.

Wartość zwracana

Wskaźnik do nowego okna miniramki lub wartości NULL, jeśli tworzenie nie powiodło się.

Uwagi

Platforma wywołuje tę metodę, gdy okienko przełącza się na stan zmiennoprzecinkowa. Metoda tworzy mini-ramowe okno i dołącza okienko do tego okna.

Domyślna implementacja zwraca wartość NULL.

CBasePane::CreateEx

Tworzy kontrolkę okienka.

virtual BOOL CreateEx(
    DWORD dwStyleEx,
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    DWORD dwControlBarStyle=0,
    CCreateContext* pContext=NULL);

Parametry

dwStyleEx
[in] Style rozszerzone (zobacz CWnd::CreateEx , aby uzyskać więcej informacji).

lpszClassName
[in] Nazwa klasy okna.

lpszWindowName
[in] Nazwa okna.

dwStyle
[in] Styl okna (zobacz CWnd::CreateEx).

Rect
[in] Początkowy prostokąt.

pParentWnd
[in] Wskaźnik do okna nadrzędnego.

Nid
[in] Określa identyfikator okienka. Musi być unikatowa.

dwControlBarStyle
[in] Flagi stylu dla okienek.

pContext
[in] Wskaźnik do CcreateContext

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie utworzone; w przeciwnym razie FAŁSZ.

Uwagi

Tworzy okno klasy lpszClassName. Jeśli określisz WS_CAPTION, ta metoda wyczyści bit WS_CAPTION stylu i ustawi wartość CBasePane::m_bHasCaption TRUE, ponieważ biblioteka nie obsługuje okienek z podpisami.

Można użyć dowolnej kombinacji stylów okien podrzędnych i stylów paska sterowania MFC (CBRS_).

Biblioteka dodaje kilka nowych stylów dla okienek. W poniższej tabeli opisano nowe style:

Styl opis
AFX_CBRS_FLOAT Okienko może upłynąć zmiennoprzecinkowe.
AFX_CBRS_AUTOHIDE Okienko obsługuje tryb automatycznego ukrywania
AFX_CBRS_RESIZE Rozmiar okienka można zmienić. Ważne: ten styl nie jest implementowany.
AFX_CBRS_CLOSE Okienko można zamknąć.
AFX_CBRS_AUTO_ROLLUP Okienko można zwijać, gdy unosi się.
AFX_CBRS_REGULAR_TABS Gdy jedno okienko dokuje do innego okienka, które ma ten styl, zostanie utworzone regularne okno z kartami. (Aby uzyskać więcej informacji, zobacz Klasa CTabbedPane).
AFX_CBRS_OUTLOOK_TABS Gdy jedno okienko dokuje do innego okienka, które ma ten styl, zostanie utworzone okno z kartami w stylu programu Outlook. (Aby uzyskać więcej informacji, zobacz Klasa CMFCOutlookBar).

Aby użyć nowych stylów, określ je w dwControlBarStyle.

CBasePane::D ockPane

Zadokuje okienko do innego okienka lub okna ramowego.

virtual BOOL DockPane(
    CBasePane* pDockBar,
    LPCRECT lpRect,
    AFX_DOCK_METHOD dockMethod);

Parametry

pDockBar
[in] Wskaźnik do innego okienka.

lpRect
[in] Określa prostokąt docelowy.

dockMethod
[in] Określa metodę dokowania.

Wartość zwracana

Wartość TRUE, jeśli pasek sterowania został pomyślnie zadokowany; w przeciwnym razie, FAŁSZ.

Uwagi

Wywołaj tę funkcję, aby zadokować okienko do innego okienka lub paska docku ( klasa CDockSite), który jest określony przez pDockBar, lub do ramki głównej, jeśli pDockBar ma wartość NULL.

dockMethod określa sposób zadokowania okienka. Aby uzyskać listę możliwych wartości, zobacz CPane::D ockPane .

CBasePane::D ockPaneUsingRTTI

Zadokuje okienko przy użyciu informacji o typie czasu wykonywania.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Parametry

bUseDockSite
[in] Jeśli wartość TRUE, zadokuj do lokacji dokowania. Jeśli wartość FALSE, zadokuj do ramki nadrzędnej.

CBasePane::D ockToFrameWindow

Zadokuje dokowalne okienko do ramki.

virtual BOOL DockToFrameWindow(
    DWORD dwAlignment,
    LPCRECT lpRect = NULL,
    DWORD dwDockFlags = DT_DOCK_LAST,
    CBasePane* pRelativeBar = NULL,
    int nRelativeIndex = -1,
    BOOL bOuterEdge = FALSE);

Parametry

dwAlignment
[in] Bok ramki nadrzędnej, do której chcesz zadokować okienko.

lpRect
[in] Żądany rozmiar.

dwDockFlags
[in] Ignorowane.

Pasek pRelative
[in] Ignorowane.

nRelativeIndex
[in] Ignorowane.

bOuterEdge
[in] Jeśli wartość TRUE i istnieją inne okienka z możliwością dokowania po stronie określonej przez dwAlignment, okienko jest zadokowane poza innymi okienkami, bliżej krawędzi ramki nadrzędnej. Jeśli wartość FALSE, okienko jest zadokowane bliżej środka obszaru klienta.

Wartość zwracana

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

Uwagi

Ta metoda kończy się niepowodzeniem, jeśli nie można utworzyć klasy dzielenia okienka ( klasa CPaneDivider). W przeciwnym razie zawsze zwraca wartość TRUE.

CBasePane::D oesAllowDynInsertBefore

Określa, czy inne okienko może być dynamicznie wstawione między tym okienkem a ramką nadrzędną.

virtual BOOL DoesAllowDynInsertBefore() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli użytkownik może wstawić inne okienko; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy użytkownik może dynamicznie wstawić okienko przed tym okienkiem.

Załóżmy na przykład, że aplikacja tworzy okienko zadokowane po lewej stronie ramki (np. pasek programu Outlook). Aby uniemożliwić użytkownikowi zadokowanie innego okienka po lewej stronie pierwszego okienka, przesłoń tę metodę i zwróć wartość FALSE.

Zalecamy zastąpienie tej metody i zwrócenie wartości FALSE dla nieprzecinkowych okienek pochodzących z klasy CDockablePane.

Domyślna implementacja zwraca wartość TRUE.

CBasePane::D oPaint

Wypełnia tło okienka.

virtual void DoPaint(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia.

Uwagi

Domyślna implementacja wywołuje bieżącego menedżera wizualizacji, aby wypełnić tło ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Umożliwia zadokowanie okienka do ramki głównej.

virtual void EnableDocking(DWORD dwAlignment);

Parametry

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

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).

EnableDocking Ustawia flagę CBasePane::m_dwEnabledAlignment wewnętrzną, a platforma sprawdza tę flagę po zadokowaniu okienka.

Wywołaj metodę CBasePane::GetEnabledAlignment, aby określić wyrównanie dokowania dla okienka.

CBasePane::EnableGripper

Włącza lub wyłącza uchwyt. Jeśli uchwyt jest włączony, użytkownik może przeciągnąć go, aby zmienić położenie okienka.

virtual void EnableGripper(BOOL bEnable);

Parametry

bEnable
[in] WARTOŚĆ TRUE w celu włączenia uchwytu; Wartość FALSE, aby ją wyłączyć.

Uwagi

Struktura używa tej metody, aby umożliwić chwytanie zamiast używać stylu WS_CAPTION.

CBasePane::FloatPane

Unosi okienko.

virtual BOOL FloatPane(
    CRect rectFloat,
    AFX_DOCK_METHOD dockMethod=DM_UNKNOWN,
    bool bShow=true);

Parametry

rectFloat
[in] Określa współrzędne ekranu, na których pojawia się przestawne okienko.

dockMethod
[in] Określa metodę dock do użycia w celu upłynięcia okienka.

bShow
[in] Określa, czy okienko przestawne jest widoczne (PRAWDA), czy ukryte (FALSE).

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało pomyślnie ułożone; w przeciwnym razie FAŁSZ.

Uwagi

Wywołaj tę metodę, aby unosić okienko na pozycji ekranu określonej przez rectFloat.

CBasePane::get_accHelpTopic

Struktura wywołuje tę metodę, aby pobrać pełną ścieżkę pliku WinHelp , który jest skojarzony z określonym obiektem i identyfikatorem odpowiedniego tematu w tym pliku.

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parametry

pszHelpFile
[in] Adres BSTR, który odbiera pełną ścieżkę pliku WinHelp skojarzonego z określonym obiektem, jeśli istnieje.

varChild
[in] Określa, czy temat Pomocy, który ma zostać pobrany, jest obiektem, czy jednym z elementów podrzędnych obiektu. Ten parametr może być CHILDID_SELF (aby uzyskać temat Pomocy dla obiektu) lub identyfikator podrzędny (aby uzyskać temat Pomocy dla jednego z elementów podrzędnych obiektu).

pidTopic
[in] Identyfikuje temat pliku Pomocy skojarzony z określonym obiektem.

Wartość zwracana

CBasePane nie implementuje tej metody. CBasePane::get_accHelpTopic Dlatego zawsze zwraca S_FALSE.

Uwagi

Ta funkcja jest częścią obsługi aktywnych ułatwień dostępu w MFC. Zastąp tę funkcję w klasie pochodnej, aby udostępnić informacje o obiekcie.

CBasePane::get_accSelection

Struktura wywołuje tę metodę, aby pobrać wybrane elementy podrzędne tego obiektu.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametry

pvarChildren
[in] Odbiera informacje identyfikujące wybrane elementy podrzędne.

Wartość zwracana

CBasePane nie implementuje tej metody. Jeśli wartość pvarChildren ma wartość NULL, ta metoda zwraca E_INVALIDARG. W przeciwnym razie ta metoda zwraca DISP_E_MEMBERNOTFOUND.

Uwagi

Ta funkcja jest częścią obsługi aktywnych ułatwień dostępu w MFC. Zastąp tę funkcję w klasie pochodnej, jeśli nie są oknem elementów interfejsu użytkownika innych niż kontrolki ActiveX bez okien.

CBasePane::GetCaptionHeight

Zwraca wysokość podpisu.

virtual int GetCaptionHeight() const;

Wartość zwracana

Wysokość podpisu.

CBasePane::GetControlBarStyle

Zwraca styl paska sterowania.

virtual DWORD GetControlBarStyle() const

Wartość zwracana

Bitowe or kombinacja flag AFX_CBRS_.

Uwagi

Wartość zwracana jest kombinacją następujących możliwych wartości.

Styl opis
AFX_CBRS_FLOAT Sprawia, że pasek sterowania jest zmiennoprzecinkowy.
AFX_CBRS_AUTOHIDE Włącza tryb automatycznego ukrywania.
AFX_CBRS_RESIZE Umożliwia zmianę rozmiaru paska sterowania. Po ustawieniu tej flagi pasek sterowania można umieścić w okienku dokowania.
AFX_CBRS_CLOSE Włącza ukrywanie paska sterowania.

CBasePane::GetCurrentAlignment

Zwraca wyrównanie bieżącego okienka.

virtual DWORD GetCurrentAlignment() const;

Wartość zwracana

Bieżące wyrównanie paska sterowania. W poniższej tabeli przedstawiono możliwe wartości:

Wartość Wyrównanie
CBRS_ALIGN_LEFT Wyrównanie do lewej.
CBRS_ALIGN_RIGHT Wyrównanie do prawej.
CBRS_ALIGN_TOP Wyrównanie górne.
CBRS_ALIGN_BOTTOM Wyrównanie do dołu.

CBasePane::GetDockingMode

Zwraca bieżący tryb dokowania dla okienka.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Wartość zwracana

DT_STANDARD, jeśli przeciąganie okienka jest wskazywane na ekranie przez prostokąt przeciągania. DT_IMMEDIATE, jeśli zawartość okienka zostanie przeciągnięta.

Uwagi

Struktura wywołuje tę metodę, aby określić bieżący tryb dokowania okienka.

Jeśli CBasePane::m_dockMode jest niezdefiniowany (DT_UNDEFINED), tryb dockowania jest pobierany z trybu dokowania globalnego (AFX_GLOBAL_DATA::m_dockModeGlobal).

Ustawiając m_dockMode lub przesłaniającGetDockingMode, możesz kontrolować tryb dokowania dla każdego okienka.

CBasePane::GetDockSiteFrameWnd

Zwraca wskaźnik do obiektu CDockingPanesRow, w którym okienko jest zadokowane.

virtual CWnd* GetDockSiteFrameWnd() const;

Wartość zwracana

Wskaźnik do witryny docku okienka.

Uwagi

Wywołaj tę metodę, aby pobrać wskaźnik do lokacji dock okienka. Witryna docku może być głównym oknem ramowym, jeśli okienko jest zadokowane do głównej ramki, lub mini-ramowe okno, jeśli okienko jest przestawne.

CBasePane::GetEnabledAlignment

Zwraca style CBRS_ALIGN_ stosowane do okienka.

virtual DWORD GetEnabledAlignment() const;

Wartość zwracana

Kombinacja stylów CBRS_ALIGN_. W poniższej tabeli przedstawiono możliwe style:

Flaga Włączone wyrównanie
CBRS_ALIGN_LEFT Lewy.
CBRS_ALIGN_RIGHT Racja.
CBRS_ALIGN_TOP Do góry.
CBRS_ALIGN_BOTTOM Dno.
CBRS_ALIGN_ANY Kombinacja wszystkich flag.

Uwagi

Wywołaj tę metodę, aby określić włączone wyrównanie dla okienka. Włączone wyrównanie oznacza boki głównego okna ramowego, do którego można zadokować okienko.

Włącz wyrównanie dokowania przy użyciu CBasePane ::EnableDocking.

CBasePane::GetMFCStyle

Zwraca style okienka specyficzne dla MFC.

virtual DWORD GetMFCStyle() const;

Wartość zwracana

Kombinacja stylów okienka specyficznego dla biblioteki (AFX_CBRS_).

CBasePane::GetPaneIcon

Zwraca uchwyt do ikony okienka.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Parametry

bBigIcon
[in] Określa ikonę 32 pikseli na 32 pikseli, jeśli prawda; Określa 16 pikseli na 16 pikseli ikona, jeśli FAŁSZ.

Wartość zwracana

Uchwyt do ikony okienka. Jeśli błąd nie powiedzie się, zwraca wartość NULL.

Uwagi

Domyślna implementacja wywołuje CWnd ::GetIcon.

CBasePane::GetPaneRow

Zwraca wskaźnik do obiektu CDockingPanesRow, w którym okienko jest zadokowane.

CDockingPanesRow* GetPaneRow();

Wartość zwracana

Wskaźnik, jeśli CDockingPanesRow okienko jest zadokowane, lub null, jeśli jest zmienna.

Uwagi

Wywołaj tę metodę, aby uzyskać dostęp do wiersza, w którym jest zadokowane okienko. Aby na przykład rozmieścić okienka w określonym wierszu, wywołaj metodę , a następnie wywołaj metodę GetPaneRow CDockingPanesRow::ArrangePanes.

CBasePane::GetPaneStyle

Zwraca styl okienka.

virtual DWORD GetPaneStyle() const;

Wartość zwracana

Kombinacja stylów paska sterowania (w tym stylów CBRS_), które zostały ustawione przez metodę CBasePane::SetPaneStyle w czasie tworzenia.

CBasePane::GetParentDockSite

Zwraca wskaźnik do nadrzędnej lokacji dokowania.

virtual CDockSite* GetParentDockSite() const;

Wartość zwracana

Nadrzędna witryna docku.

CBasePane::GetParentMiniFrame

Zwraca wskaźnik do nadrzędnego okna miniramowania.

virtual CPaneFrameWnd* GetParentMiniFrame(BOOL bNoAssert=FALSE) const;

Parametry

bNoAssert
[in] Jeśli wartość TRUE, ta metoda nie sprawdza nieprawidłowych wskaźników. Jeśli wywołasz tę metodę, gdy aplikacja zakończy działanie, ustaw ten parametr na wartość TRUE.

Wartość zwracana

Prawidłowy wskaźnik do nadrzędnego okna miniramki, jeśli okienko jest przestawne; w przeciwnym razie wartość NULL.

Uwagi

Wywołaj tę funkcję, aby pobrać wskaźnik do nadrzędnego okna miniramki. Ta metoda iteruje wszystkie elementy nadrzędne i sprawdza obiekt pochodzący z klasy CPaneFrameWnd.

Użyj GetParentMiniFrame polecenia , aby określić, czy okienko jest przestawne.

CBasePane::GetParentTabbedPane

Zwraca wskaźnik do okienka z kartami nadrzędnymi.

CBaseTabbedPane* GetParentTabbedPane() const;

Wartość zwracana

Wskaźnik do okienka z kartami nadrzędnymi, jeśli istnieje; w przeciwnym razie wartość NULL.

CBasePane::GetParentTabWnd

Zwraca wskaźnik do okna nadrzędnego znajdującego się wewnątrz karty.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Parametry

hWndTab
[out] Jeśli wartość zwracana nie ma wartości NULL, ten parametr zawiera dojście do okna z kartami nadrzędnymi.

Wartość zwracana

Prawidłowy wskaźnik do okna z kartami nadrzędnymi lub wartości NULL.

Uwagi

Użyj tej funkcji, aby pobrać wskaźnik do okna z kartami nadrzędnymi. Czasami nie wystarczy wywołać GetParentmetodę , ponieważ okienko może znajdować się wewnątrz otoki dokowania ( klasa CDockablePaneAdapter) lub wewnątrz adaptera okienka ( Klasa CDockablePaneAdapter). Za pomocą GetParentTabWnd polecenia będzie można pobrać prawidłowy wskaźnik w tych przypadkach (przy założeniu, że element nadrzędny jest oknem z kartami).

CBasePane::GetRecentVisibleState

Struktura wywołuje tę metodę, gdy okienko zostanie przywrócone z archiwum.

virtual BOOL GetRecentVisibleState() const;

Wartość zwracana

Wartość LOGICZNA określająca ostatnio widoczny stan. Jeśli wartość TRUE, okienko było widoczne po serializacji i powinno być widoczne po przywróceniu. Jeśli wartość FALSE, okienko zostało ukryte podczas serializacji i powinno być ukryte po przywróceniu.

CBasePane::HideInPrintPreviewMode

Określa, czy okienko jest ukryte w podglądzie wydruku.

virtual BOOL HideInPrintPreviewMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko nie jest wyświetlane w podglądzie wydruku; w przeciwnym razie, FAŁSZ.

Uwagi

Okienka podstawowe nie są wyświetlane w podglądzie wydruku. W związku z tym ta metoda zawsze zwraca wartość TRUE.

CBasePane::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.

CBasePane::IsAccessibilityCompatible

Określa, czy okienko obsługuje aktywne ułatwienia dostępu.

virtual BOOL IsAccessibilityCompatible();

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko obsługuje aktywne ułatwienia dostępu; w przeciwnym razie, FAŁSZ.

CBasePane::IsAutoHideMode

Określa, czy okienko jest w trybie automatycznego ukrywania.

virtual BOOL IsAutoHideMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko jest w trybie automatycznego ukrywania; w przeciwnym razie, FAŁSZ.

Uwagi

Okienka podstawowe nie mogą się automatycznie ukrywać. Ta metoda zawsze zwraca wartość FALSE.

CBasePane::IsDialogControl

Określa, czy okienko jest kontrolką okna dialogowego.

BOOL IsDialogControl() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko jest kontrolką okna dialogowego; w przeciwnym razie, FAŁSZ.

Uwagi

Struktura używa tej metody, aby zapewnić spójność układu dla wszystkich okienek.

CBasePane::IsDocked

Określa, czy okienko jest zadokowane.

virtual BOOL IsDocked() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli element nadrzędny okienka nie jest mini-ramką lub jeśli okienko unosi się w mini-ramce z innym okienkiem; w przeciwnym razie, FAŁSZ.

CBasePane::IsFloating

Określa, czy okienko jest przestawne.

virtual BOOL IsFloating() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko jest przestawne; w przeciwnym razie, FAŁSZ.

Uwagi

Ta metoda zwraca przeciwną wartość CBasePane::IsDocked.

CBasePane::IsHorizontal

Określa, czy okienko jest zadokowane w poziomie.

virtual BOOL IsHorizontal() const;

Wartość zwracana

Wartość TRUE, jeśli okienko jest zadokowane w poziomie; w przeciwnym razie FAŁSZ.

Uwagi

Domyślna implementacja sprawdza bieżące wyrównanie dokowania dla CBRS_ORIENT_HORZ.

CBasePane::IsInFloatingMultiPaneFrameWnd

Określa, czy okienko znajduje się w oknie ramowym z wieloma okienkami ( Klasa CMultiPaneFrameWnd).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko znajduje się w oknie ramki z wieloma okienkami; w przeciwnym razie, FAŁSZ.

Uwagi

Tylko zadokowalne okienka mogą unosić się w oknie ramowym z wieloma okienkami. W związku z CBasePane::IsInFloatingMultiPaneFrameWnd tym zawsze zwraca wartość FALSE.

CBasePane::IsMDITabbed

Określa, czy okienko zostało dodane do okna podrzędnego MDI jako dokument z kartą.

virtual BOOL IsMDITabbed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało dodane do okna podrzędnego MDI jako dokument z kartami; w przeciwnym razie, FAŁSZ.

CBasePane::IsPaneVisible

Określa, czy flaga WS_VISIBLE jest ustawiona dla okienka.

BOOL IsPaneVisible() const;

Wartość zwracana

Wartość TRUE, jeśli WS_VISIBLE jest ustawiona; w przeciwnym razie, FAŁSZ.

Uwagi

Użyj CBasePane::IsVisible , aby określić widoczność okienka.

CBasePane::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
[out] 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
[out] 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.

CBasePane::IsResizable

Określa, czy można zmienić rozmiar okienka.

virtual BOOL IsResizable() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli rozmiar okienka można zmienić przez użytkownika; w przeciwnym razie, FAŁSZ.

Uwagi

Rozmiar okienek klasy CDockablePane można zmienić.

Nie można zmienić rozmiaru paska stanu ( klasa CMFCStatusBar) i paska docku ( klasa CDockSite).

CBasePane::IsRestoredFromRegistry

Określa, czy okienko jest przywracane z rejestru.

virtual BOOL IsRestoredFromRegistry() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko zostało przywrócone z rejestru; w przeciwnym razie, FAŁSZ.

CBasePane::IsTabbed

Określa, czy okienko zostało wstawione w kontrolce karty okna z kartą.

virtual BOOL IsTabbed() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pasek sterowania jest wstawiany na karcie okna z kartą; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda pobiera wskaźnik do bezpośredniego elementu nadrzędnego i określa, czy klasa środowiska uruchomieniowego elementu nadrzędnego to KLASA CMFCBaseTabCtrl.

CBasePane::IsVisible

Określa, czy okienko jest widoczne.

virtual BOOL IsVisible() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli okienko jest widoczne; w przeciwnym razie FAŁSZ.

Uwagi

Użyj tej metody, aby określić widoczność okienka. Nie używaj polecenia ::IsWindowVisible.

Jeśli okienko nie jest kartowane (zobacz CBasePane::IsTabbed), ta metoda sprawdza styl WS_VISIBLE. Jeśli okienko jest kartami, ta metoda sprawdza widoczność okna z kartami nadrzędnymi. Jeśli okno nadrzędne jest widoczne, funkcja sprawdza widoczność karty okienka przy użyciu polecenia CMFCBaseTabCtrl::IsTabVisible.

CBasePane::LoadState

Ładuje stan okienka z rejestru.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametry

lpszProfileName
[in] Nazwa profilu.

nIndex
[in] Indeks profilu.

identyfikator uiID
[in] Identyfikator okienka.

Wartość zwracana

WARTOŚĆ TRUE, jeśli stan okienka został pomyślnie załadowany; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, aby załadować stan okienka z rejestru. Zastąp go w klasie pochodnej, aby załadować dodatkowe informacje zapisane przez CBasePane::SaveState.

CBasePane::MoveWindow

Przenosi okienko.

virtual HDWP MoveWindow(
    CRect& rect,
    BOOL bRepaint = TRUE,
    HDWP hdwp = NULL);

Parametry

Rect
[in] Prostokąt określający nową lokalizację i rozmiar okienka.

bRepaint
[in] Jeśli wartość TRUE, okienko zostanie przemalowane. Jeśli fałsz, okienko nie zostanie przemalowane.

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

Wartość zwracana

Uchwyt do struktury odroczonego położenia okna lub wartości NULL.

Uwagi

Jeśli przekazujesz wartość NULL jako parametr hdwp , ta metoda przenosi okno normalnie. W przypadku przekazania dojścia ta metoda wykonuje przeniesienie okna odroczonego. Dojście można uzyskać, wywołując metodę BeginDeferWindowPos lub przechowując wartość zwracaną poprzedniego wywołania do tej metody.

CBasePane::OnAfterChangeParent

Wywoływana przez strukturę po zmianach nadrzędnych okienka.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parametry

pWndOldParent
[in] Wskaźnik do poprzedniego elementu nadrzędnego.

Uwagi

Struktura wywołuje tę metodę po zmianach nadrzędnych okienka, zwykle ze względu na operację dokowania lub zmiennoprzecinkową.

Domyślna implementacja nic nie robi.

CBasePane::OnBeforeChangeParent

Wywoływana przez platformę tuż przed zmianą okna nadrzędnego okienka.

virtual void OnBeforeChangeParent(
    CWnd* pWndNewParent,
    BOOL bDelay=FALSE);

Parametry

pWndNewParent
[in] Wskaźnik do nowego okna nadrzędnego.

bDelay
[in] Określa, czy korekty układu muszą być opóźnione.

Uwagi

Struktura wywołuje tę metodę tuż przed zmianami nadrzędnymi okienka, zwykle ze względu na operację zadokowania, przestawnego lub automatycznego ukrywania.

Domyślna implementacja nic nie robi.

CBasePane::OnDrawCaption

Struktura wywołuje tę metodę, gdy podpis zostanie narysowany.

virtual void OnDrawCaption();

Uwagi

Ta metoda nie ma funkcji dla CBasePane klasy .

CBasePane::OnMovePaneDivider

Ta metoda nie jest obecnie używana.

virtual void OnMovePaneDivider(CPaneDivider* /* unused */);

Parametry

Nieużywane
[in] Nieużytne.

CBasePane::OnPaneContextMenu

Wywoływana przez platformę podczas kompilowania menu zawierającego listę okienek.

virtual void OnPaneContextMenu(
    CWnd* pParentFrame,
    CPoint point);

Parametry

pParentFrame
[in] Wskaźnik do ramki nadrzędnej.

punkt
[in] Określa lokalizację menu skrótów.

Uwagi

OnPaneContextMenu wywołuje menedżera dokowania, który utrzymuje listę okienek należących do bieżącego okna ramki. Ta metoda dodaje nazwy okienek do menu skrótów i wyświetla je. Polecenia w menu pokazują lub ukrywają poszczególne okienka.

Zastąpij tę metodę, aby dostosować to zachowanie.

CBasePane::OnRemoveFromMiniFrame

Wywoływana przez platformę, gdy okienko zostanie usunięte z nadrzędnego mini okna ramek.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Parametry

pMiniFrame
[in] Wskaźnik do okna miniramki, z którego zostanie usunięte okienko.

Uwagi

Struktura wywołuje tę metodę, gdy okienko zostanie usunięte z nadrzędnego okna miniramki (na przykład w wyniku zadokowania).

Domyślna implementacja nic nie robi.

CBasePane::OnSetAccData

CBasePane nie używa tej metody.

virtual BOOL OnSetAccData(long lVal);

Parametry

lVal
[in] Nieużytne.

Wartość zwracana

Ta metoda zawsze zwraca wartość TRUE.

Uwagi

CBasePane::P aneFromPoint

Zwraca okienko zawierające dany punkt.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar = false,
    CRuntimeClass* pRTCBarType = NULL) 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.

Wartość zwracana

Obiekt CBasePanepochodny zawierający dany punkt lub wartość NULL, jeśli nie znaleziono okienka.

CBasePane::RecalcLayout

CBasePane nie używa tej metody.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

Wyrejestrowuje okienko i usuwa je z listy w menedżerze dokowania.

void RemovePaneFromDockManager(
    CBasePane* pBar,
    BOOL bDestroy = TRUE,
    BOOL bAdjustLayout = FALSE,
    BOOL bAutoHide = FALSE,
    CBasePane* pBarReplacement = NULL);

Parametry

Pasek p
[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.

CBasePane::SaveState

Zapisuje stan okienka w rejestrze.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametry

lpszProfileName
[in] Nazwa profilu.

nIndex
[in] Indeks profilu.

identyfikator uiID
[in] Identyfikator okienka.

Wartość zwracana

Wartość TRUE, jeśli stan został zapisany pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, gdy zapisuje stan okienka w rejestrze. Zastąp SaveState element w klasie pochodnej, aby przechowywać dodatkowe informacje.

CBasePane::SelectDefaultFont

Wybiera czcionkę domyślną dla danego kontekstu urządzenia.

CFont* SelectDefaultFont(CDC* pDC);

Parametry

PDC
[in] Kontekst urządzenia.

Wartość zwracana

Wskaźnik do domyślnego obiektu klasy CFont.

CBasePane::SetControlBarStyle

Ustawia styl paska sterowania.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Parametry

dwNewStyle
[in] Bitowa kombinacja następujących możliwych wartości.

Styl opis
AFX_CBRS_FLOAT Sprawia, że pasek sterowania jest zmiennoprzecinkowy.
AFX_CBRS_AUTOHIDE Włącza tryb automatycznego ukrywania.
AFX_CBRS_RESIZE Umożliwia zmianę rozmiaru paska sterowania. Po ustawieniu tej flagi pasek sterowania można umieścić w okienku dokowania.
AFX_CBRS_CLOSE Włącza ukrywanie paska sterowania.

CBasePane::SetDockingMode

Ustawia tryb dokowania dla okienka.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Parametry

dockModeNowy
[in] Określa nowy tryb dokowania dla okienka.

Uwagi

Platforma obsługuje dwa tryby dokowania: standardowy i natychmiastowy.

W standardowym trybie dokowania okienka i okna mini-ramowe są przenoszone przy użyciu prostokąta przeciągania. W trybie natychmiastowego zadokowania paski sterowania i okna mini-ramowe są natychmiast przenoszone z ich kontekstem.

Początkowo tryb dokowania jest definiowany globalnie przez CDockingManager::m_dockModeGlobal. Tryb dokowania dla każdego okienka można ustawić indywidualnie przy użyciu SetDockingMode metody .

CBasePane::SetPaneAlignment

Ustawia wyrównanie okienka.

virtual void SetPaneAlignment(DWORD dwAlignment);

Parametry

dwAlignment
[in] Określa nowe wyrównanie.

Uwagi

Zwykle struktura wywołuje tę metodę, gdy okienko jest zadokowane z jednej strony ramki głównej do innej.

W poniższej tabeli przedstawiono możliwe wartości dwAlignment:

Wartość Wyrównanie
CBRS_ALIGN_LEFT Wyrównanie do lewej.
CBRS_ALIGN_RIGHT Wyrównanie do prawej.
CBRS_ALIGN_TOP Wyrównanie górne.
CBRS_ALIGN_BOTTOM Wyrównanie do dołu.

CBasePane::SetPaneStyle

Ustawia styl okienka.

virtual void SetPaneStyle(DWORD dwNewStyle);

Parametry

dwNewStyle
[in] Określa nowy styl do ustawienia.

Uwagi

Ta metoda może służyć do ustawiania dowolnych stylów CBRS_ zdefiniowanych w pliku afxres.h. Ponieważ styl okienka i wyrównanie okienka są przechowywane razem, ustaw nowy styl, łącząc go z bieżącym wyrównaniem w następujący sposób.

pPane->SetPaneStyle (pPane->GetCurrentAlignment() | CBRS_TOOLTIPS);

CBasePane::SetWindowPos

Zmienia rozmiar, położenie i kolejność Z okienka.

virtual HDWP SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags,
    HDWP hdwp = NULL);

Parametry

pWndInsertAfter
[in] CWnd Identyfikuje obiekt, który występuje przed tym CWnd obiektem w kolejności Z. Aby uzyskać więcej informacji, zobacz CWnd::SetWindowPos.

x
[in] Określa położenie lewej strony okna.

y
[in] Określa położenie górnej części okna.

cx
[in] Określa szerokość okna.

Cy
[in] Określa wysokość okna.

nFlags
[in] Określa opcje rozmiaru i położenia. Aby uzyskać więcej informacji, zobacz CWnd::SetWindowPos.

hdwp
[in] Dojście do struktury zawierającej informacje o rozmiarze i położeniu dla co najmniej jednego okna.

Wartość zwracana

Uchwyt do zaktualizowanej struktury odroczonego położenia okna lub wartości NULL.

Uwagi

Jeśli parametr pWndInsertAfter ma wartość NULL, ta metoda wywołuje CWnd::SetWindowPos. Jeśli parametr pWndInsertAfter jest inny niż NULL, ta metoda wywołuje metodę DeferWindowPos.

CBasePane::ShowPane

Wyświetla lub ukrywa okienko.

virtual void ShowPane(
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parametry

bShow
[in] Określa, czy okienko ma być wyświetlane (PRAWDA) czy ukrywane (FAŁSZ).

bDelay
[in] Jeśli wartość TRUE, ponowne obliczenie układu dokowania jest opóźnione.

bActivate
[in] Jeśli wartość TRUE, okienko jest aktywne po wyświetleniu.

Uwagi

Ta metoda pokazuje lub ukrywa okienko. Użyj tej metody zamiast ShowWindow , ponieważ ta metoda powiadamia odpowiednich menedżerów dokowania o zmianach w widoczności okienka.

Użyj CBasePane::IsVisible , aby określić bieżącą widoczność okienka.

CBasePane::StretchPane

Rozciąga okienko w pionie lub w poziomie.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametry

nLength
[in] Długość, o jaką należy rozciągnąć okienko.

bVert
[in] Jeśli wartość TRUE, rozciągnij okienko w pionie. Jeśli fałsz, rozciągnij okienko w poziomie.

Wartość zwracana

Rozmiar rozciągniętego okienka.

CBasePane::UndockPane

Usuwa okienko z witryny docka, suwak domyślny lub okno miniramki, w którym jest obecnie zadokowany.

virtual void UndockPane(BOOL bDelay=FALSE);

Parametry

bDelay
Jeśli wartość TRUE, układ dokowania nie zostanie natychmiast ponownie obliczony.

Uwagi

Wywołaj tę metodę, aby manipulować stanem okienka lub wykluczyć okienko z układu dokowania.

Jeśli chcesz nadal używać tego okienka, przed wywołaniem tej metody wywołaj metodę CBasePane::D ockPane lub CBasePane::FloatPane .

Zobacz też

Wykres hierarchii
Klasy
CPane
Klasa CWnd