Sdílet prostřednictvím

CBasePane – třída

  • Článek

Základní třída pro všechna podokna v prostředí MFC

Syntaxe

class CBasePane : public CWnd

Členové

Veřejné konstruktory

Název Popis
CBasePane::CBasePane Výchozí konstruktor.
CBasePane::~CBasePane Destruktor.

Veřejné metody

Název Popis
CBasePane::accHitTest Volá se rozhraním pro načtení podřízeného elementu nebo podřízeného objektu v daném bodě na obrazovce. (Přepsání CWnd::accHitTest.)
CBasePane::accLocation Volá se rozhraním pro načtení aktuálního umístění obrazovky pro zadaný objekt. (Přepsání CWnd::accLocation.)
CBasePane::AccNotifyObjectFocusEvent CBasePane nepoužívá tuto metodu.
CBasePane::accSelect Volá se rozhraním pro úpravu výběru nebo přesunutí fokusu klávesnice zadaného objektu. (Přepsání CWnd::accSelect.)
CBasePane::AddPane Přidá podokno do dokovacího správce.
CBasePane::AdjustDockingLayout Přesměruje volání na správce dokování a upraví rozložení ukotvení.
CBasePane::AdjustLayout Volá se rozhraním, když by podokno mělo upravit jeho interní rozložení.
CBasePane::CalcFixedLayout Vypočítá vodorovnou velikost ovládacího panelu.
CBasePane::CanAcceptPane Určuje, zda je možné do podokna ukotvit další podokno.
CBasePane::CanAutoHide Určuje, zda podokno podporuje režim automatického skrytí.
CBasePane::CanBeAttached Určuje, zda je možné podokno ukotvit do jiného podokna.
CBasePane::CanBeClosed Určuje, zda lze podokno zavřít.
CBasePane::CanBeDocked Určuje, zda je možné podokno ukotvit do jiného podokna.
CBasePane::CanBeResized Určuje, zda je možné změnit velikost podokna.
CBasePane::CanBeTabbedDocument Určuje, jestli je možné podokno převést na dokument s kartami MDI.
CBasePane::CanFloat Určuje, zda může podokno plovákovat.
CBasePane::CanFocus Určuje, jestli může podokno přijímat fokus.
CBasePane::CopyState Zkopíruje stav daného podokna.
CBasePane::CreateDefaultMiniframe Pokud může podokno plout, vytvoří se okno s minirámečekem.
CBasePane::CreateEx Vytvoří ovládací prvek podokna.
CBasePane::D ockPane Ukotví podokno do jiného podokna nebo do okna rámečku.
CBasePane::D ockPaneUsingRTTI Ukotví podokno pomocí informací o typu za běhu.
CBasePane::D ockToFrameWindow Ukotví ukotvené podokno k rámu.
CBasePane::D oesAllowDynInsertBefore Určuje, zda lze mezi toto podokno a nadřazený rámec dynamicky vložit jiné podokno.
CBasePane::EnableDocking Umožňuje ukotvit podokno na hlavní rámec.
CBasePane::EnableGripper Povolí nebo zakáže úchyt. Pokud je úchyt povolený, může ho uživatel přetáhnout a přemístit podokno.
CBasePane::FillWindowRect Používá se interně.
CBasePane::FloatPane S plovoucím podoknem.
CBasePane::get_accChild Volal rozhraní pro načtení adresy IDispatch rozhraní pro zadané podřízené. (Přepsání CWnd::get_accChild.)
CBasePane::get_accChildCount Volá se rozhraním pro načtení počtu podřízených objektů, které patří k tomuto objektu. (Přepsání CWnd::get_accChildCount.)
CBasePane::get_accDefaultAction Volá se rozhraním k načtení řetězce, který popisuje výchozí akci objektu. (Přepsání CWnd::get_accDefaultAction.)
CBasePane::get_accDescription Volá se podle architektury k načtení řetězce, který popisuje vizuální vzhled zadaného objektu. (Přepsání CWnd::get_accDescription.)
CBasePane::get_accFocus Volá se rozhraním pro načtení objektu, který má fokus klávesnice. (Přepsání CWnd::get_accFocus.)
CBasePane::get_accHelp Volá se rozhraním k načtení řetězce vlastnosti nápovědy pro objekt. (Přepsání CWnd::get_accHelp.)
CBasePane::get_accHelpTopic Volá se rozhraním pro načtení úplné cesty k souboru WinHelp přidruženého k zadanému objektu a identifikátoru příslušného tématu v tomto souboru. (Přepsání CWnd::get_accHelpTopic.)
CBasePane::get_accKeyboardShortcut Volá se rozhraním pro načtení zadané klávesové zkratky pro objekt. (Přepsání CWnd::get_accKeyboardShortcut.)
CBasePane::get_accName Volá se rozhraním pro načtení názvu zadaného objektu. (Přepsání CWnd::get_accName.)
CBasePane::get_accParent Volal rozhraní pro načtení IDispatch rozhraní pro nadřazený objekt. (Přepsání CWnd::get_accParent.)
CBasePane::get_accRole Volá se rozhraním pro načtení informací, které popisují roli zadaného objektu. (Přepsání CWnd::get_accRole.)
CBasePane::get_accSelection Volá se rozhraním pro načtení vybraných podřízených objektů tohoto objektu. (Přepsání CWnd::get_accSelection.)
CBasePane::get_accState Volá se rozhraním pro načtení aktuálního stavu zadaného objektu. (Přepsání CWnd::get_accState.)
CBasePane::get_accValue Volá se rozhraním pro načtení hodnoty zadaného objektu. (Přepsání CWnd::get_accValue.)
CBasePane::GetCaptionHeight Vrátí výšku titulku.
CBasePane::GetControlBarStyle Vrátí styl řídicího pruhu.
CBasePane::GetCurrentAlignment Vrátí zarovnání aktuálního podokna.
CBasePane::GetDockingMode Vrátí aktuální režim ukotvení podokna.
CBasePane::GetDockSiteFrameWnd Vrátí ukazatel na okno, které je webem docku pro podokno.
CBasePane::GetEnabledAlignment Vrátí CBRS_ALIGN_ styly použité v podokně.
CBasePane::GetMFCStyle Vrátí styly podokna specifické pro MFC.
CBasePane::GetPaneIcon Vrátí popisovač ikony podokna.
CBasePane::GetPaneRect Používá se interně.
CBasePane::GetPaneRow Vrátí ukazatel na objekt CDockingPanesRow, kde je podokno ukotveno.
CBasePane::GetPaneStyle Vrátí styl podokna.
CBasePane::GetParentDockSite Vrátí ukazatel na nadřazenou lokalitu docku.
CBasePane::GetParentMiniFrame Vrátí ukazatel na nadřazené okno minirámeček.
CBasePane::GetParentTabbedPane Vrátí ukazatel na nadřazené podokno s kartami.
CBasePane::GetParentTabWnd Vrátí ukazatel na nadřazené okno, které je uvnitř karty.
CBasePane::GetRecentVisibleState Architektura volá tuto metodu při obnovení podokna z archivu.
CBasePane::HideInPrintPreviewMode Určuje, jestli je podokno skryté v náhledu tisku.
CBasePane::InsertPane Zaregistruje zadané podokno ve správci ukotvení.
CBasePane::IsAccessibilityCompatible Určuje, jestli podokno podporuje funkci Aktivní přístupnost.
CBasePane::IsAutoHideMode Určuje, zda je podokno v režimu automatického skrytí.
CBasePane::IsDialogControl Určuje, zda je podokno ovládacím prvku dialogového okna.
CBasePane::IsDocked Určuje, zda je podokno ukotveno.
CBasePane::IsFloating Určuje, zda je podokno plovoucí.
CBasePane::IsHorizontal Určuje, zda je podokno ukotveno vodorovně.
CBasePane::IsInFloatingMultiPaneFrameWnd Určuje, jestli je podokno v okně s rámečkem s více podokny.
CBasePane::IsMDITabbed Určuje, zda bylo podokno přidáno do podřízeného okna MDI jako dokument s kartami.
CBasePane::IsPaneVisible Určuje, jestli je pro podokno nastaven příznak WS_VISIBLE.
CBasePane::IsPointNearDockSite Určuje, zda je zadaný bod blízko doku.
CBasePane::IsResizable Určuje, zda je možné změnit velikost podokna.
CBasePane::IsRestoredFromRegistry Určuje, zda je podokno obnoveno z registru.
CBasePane::IsTabbed Určuje, zda bylo podokno vloženo do ovládacího prvku karta okna s kartami.
CBasePane::IsTooltipTopmost Používá se interně.
CBasePane::IsVisible Určuje, zda je podokno viditelné.
CBasePane::LoadState Načte stav podokna z registru.
CBasePane::MoveWindow Přesune podokno.
CBasePane::OnAfterChangeParent Volá se rozhraním při změně nadřazeného objektu podokna.
CBasePane::OnBeforeChangeParent Volá se rozhraním těsně před tím, než podokno změní nadřazené okno.
CBasePane::OnDrawCaption Architektura volá tuto metodu při vykreslení titulku.
CBasePane::OnMovePaneDivider Tato metoda se aktuálně nepoužívá.
CBasePane::OnPaneContextMenu Volá se rozhraním, když sestaví nabídku se seznamem podoken.
CBasePane::OnRemoveFromMiniFrame Volá se rozhraním, když je podokno odebráno z nadřazeného okna mini rámečku.
CBasePane::OnSetAccData CBasePane nepoužívá tuto metodu.
CBasePane::OnUpdateCmdUI Používá se interně.
CBasePane::P aneFromPoint Vrátí podokno, které obsahuje daný bod.
CBasePane::PreTranslateMessage Třída CWinApp k překladu oken zprávy před jejich odesláním do Funkce TranslateMessage a DispatchMessage Windows. (Přepsání CWnd::P reTranslateMessage.)
CBasePane::RecalcLayout CBasePane nepoužívá tuto metodu.
CBasePane::RemovePaneFromDockManager Zruší registraci podokna a odebere ho ze seznamu ve správci ukotvení.
CBasePane::SaveState Uloží stav podokna do registru.
CBasePane::SelectDefaultFont Vybere výchozí písmo pro daný kontext zařízení.
CBasePane::Serialize Čte nebo zapisuje tento objekt z archivu nebo do archivu. (Přepsání CObject::Serialize.)
CBasePane::SetControlBarStyle Nastaví styl ovládacího panelu.
CBasePane::SetDockingMode Nastaví režim ukotvení podokna.
CBasePane::SetMDITabbed Používá se interně.
CBasePane::SetPaneAlignment Nastaví zarovnání podokna.
CBasePane::SetPaneRect Používá se interně.
CBasePane::SetPaneStyle Nastaví styl podokna.
CBasePane::SetRestoredFromRegistry Používá se interně.
CBasePane::SetWindowPos Změní velikost, umístění a pořadí Z podokna.
CBasePane::ShowPane Zobrazí nebo skryje podokno.
CBasePane::StretchPane Roztáhne podokno svisle nebo vodorovně.
CBasePane::UndockPane Odebere podokno z webu docku, výchozího posuvníku nebo okna mini rámečku, kde je aktuálně ukotvený.

Chráněné metody

Název Popis
CBasePane::D oPaint Vyplní pozadí podokna.

Poznámky

Pokud chcete vytvořit třídu podokna, která podporuje rozšířené dokovací funkce dostupné v prostředí MFC, musíte ji odvodit z CBasePane třídy CPane nebo z ní.

Tipy pro přizpůsobení

Následující tipy pro CBasePane Class přizpůsobení se týkají tříd, které z něj dědí:

  • Při vytváření podokna můžete použít několik nových stylů:

    • AFX_CBRS_FLOAT nastaví podokno jako plovoucí.

    • AFX_CBRS_AUTOHIDE povolí režim automatického skrytí.

    • AFX_CBRS_CLOSE umožňuje zavření (skrytí) podokna.

    Jedná se o příznaky, které můžete kombinovat s bitové operace OR.

CBasePane implementuje následující virtuální logické metody, které odrážejí tyto příznaky: CBasePane::CanBeClosed, CBasePane::CanAutoHide, CBasePane::CanFloat. Můžete je přepsat v odvozených třídách a přizpůsobit jejich chování.

  • Chování ukotvení můžete přizpůsobit přepsáním CBasePane::CanAcceptPane. Chcete-li zabránit ukotvení jiného podokna ukotvit do této metody, vraťte z tohoto podokna hodnotu NEPRAVDA.

  • Pokud chcete vytvořit statické podokno, které nemůže být plovoucí a které brání ukotvení jakéhokoli jiného podokna před ním (podobá se panelu Outlooku v příkladu OutlookDemo), vytvořte ho jako ne plovoucí a přepište CBasePane::D oesAllowDynInsertBefore , aby se vrátila NEPRAVDA. Výchozí implementace vrátí hodnotu FALSE, pokud je podokno vytvořeno bez stylu AFX_CBRS_FLOAT.

  • Vytvořte všechna podokna s jinými ID než -1.

  • K určení viditelnosti podokna použijte CBasePane::IsVisible. Správně zpracovává stav viditelnosti v režimech na záložkách a automaticky skryje.

  • Pokud chcete vytvořit ne plovoucí podokno umožňující změnu velikosti, vytvořte ho bez stylu AFX_CBRS_FLOAT a volejte CFrameWnd::D ockControlBar.

  • Chcete-li vyloučit podokno z ukotveného rozložení nebo odebrat panel nástrojů z panelu doku, zavolejte CBasePane::UndockPane. Tuto metodu nevolejte pro podokna v režimu automatického skrytí nebo pro podokna, která se nacházejí na kartách oken s kartami.

  • Pokud chcete plovoucí nebo zrušit rozbalení podokna, které je v režimu automatického skrytí, musíte volat CDockablePane::SetAutoHideMode s FALSE jako první argument před voláním CBasePane::FloatPane nebo CBasePane::UndockPane.

Příklad

Následující příklad ukazuje, jak používat různé metody ve CBasePane třídě. Příklad ukazuje, jak načíst podokno z CFrameWndEx třídy a jak nastavit režim ukotvení, zarovnání podokna a styl podokna. Kód pochází z ukázky wordového panelu.

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

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CBasePane

Požadavky

Hlavička: afxbasepane.h

CBasePane::AccNotifyObjectFocusEvent

CBasePane nepoužívá tuto metodu.

virtual void AccNotifyObjectFocusEvent(int);

Parametry

int
[v] Nepoužívá se.

CBasePane::AddPane

Přidá podokno do dokovacího správce.

void AddPane(CBasePane* pBar);

Parametry

pBar
[v] Ukazatel na podokno, které chcete přidat.

Poznámky

Jedná se o metodu pohodlí, která přidá podokno do dokujícího správce. Pomocí této metody nemusíte psát kód, který analyzuje typ nadřazeného rámce.

Další informace naleznete v tématu CDockingManager Třídy a CMDIFrameWndEx::AddPane.

CBasePane::AdjustDockingLayout

Přesměruje volání na správce dokování a upraví rozložení ukotvení.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parametry

hdwp
[ven] Úchyt struktury obsahující více pozic oken.

Poznámky

Jedná se o metodu pohodlí, která upravuje ukotvit rozložení. Pomocí této metody nemusíte psát kód, který analyzuje typ nadřazeného rámce.

Další informace naleznete v tématu CDockingManager::AdjustDockingLayout

CBasePane::AdjustLayout

Volá se rozhraním pro úpravu interního rozložení podokna.

virtual void AdjustLayout();

Poznámky

Architektura volá tuto metodu, když podokno musí upravit jeho interní rozložení. Základní implementace nic nedělá.

CBasePane::CalcFixedLayout

Vypočítá vodorovnou velikost ovládacího panelu.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

bStretch
[v] Určuje, zda má být pruh roztažen na velikost rámečku. Parametr bStretch je nenulový, pokud bar není dokovací pruh (není k dispozici pro dokování) a je 0, pokud je ukotvený nebo plovoucí (k dispozici pro ukotvení).

bHorz
[v] Označuje, že pruh je vodorovně nebo svisle orientovaný. Parametr bHorz je nenulový, pokud je pruh vodorovně orientovaný a je 0, pokud je svisle orientovaný.

Návratová hodnota

Velikost řídicího pruhu v pixelech objektu CSize .

Poznámky

Viz část s poznámkami v CControlBar::CalcFixedLayout

CBasePane::CanAcceptPane

Určuje, zda je možné do podokna ukotvit další podokno.

virtual BOOL CanAcceptPane(const CBasePane* pBar) const;

Parametry

pBar
[v] Ukazatel na podokno pro ukotvení.

Návratová hodnota

TRUE, pokud lze přijmout jiné podokno; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu před ukotvením podokna určeného pBar k aktuálnímu podoknu.

Pomocí této metody a metody CBasePane::CanBeDocked můžete řídit, jak se podokna ukotví do jiných podoken v aplikaci.

Výchozí implementace vrátí hodnotu FALSE.

CBasePane::CanAutoHide

Určuje, zda podokno podporuje režim automatického skrytí.

virtual BOOL CanAutoHide() const;

Návratová hodnota

TRUE, pokud toto podokno podporuje režim automatického skrytí; jinak NEPRAVDA.

Poznámky

Architektura volá tuto funkci k určení, zda podokno podporuje režim automatického skrytí.

Během sestavování můžete tuto možnost nastavit předáním příznaku AFX_CBRS_AUTOHIDE do CBasePane::CreateEx.

Výchozí implementace kontroluje příznak AFX_CBRS_AUTOHIDE. Přepsat tuto metodu v odvozené třídě přizpůsobit toto chování.

CBasePane::CanBeAttached

Určuje, zda lze podokno ukotvit do jiného podokna nebo okna rámečku.

virtual BOOL CanBeAttached() const;

Návratová hodnota

TRUE, pokud lze podokno ukotvit do jiného podokna nebo okna rámečku; jinak NEPRAVDA.

Poznámky

Výchozí implementace vrátí hodnotu FALSE. Přepsat tuto metodu v odvozené třídě povolit nebo zakázat možnost ukotvení bez volání CBasePane::EnableDocking.

CBasePane::CanBeClosed

Určuje, zda lze podokno zavřít.

virtual BOOL CanBeClosed() const;

Návratová hodnota

TRUE, pokud je možné zavřít podokno; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu k určení, zda lze podokno zavřít. Pokud metoda vrátí hodnotu PRAVDA, přidá se tlačítko Zavřít do záhlaví podokna nebo pokud je podokno plovoucí, na záhlaví okna miniframe podokna.

Během sestavování můžete tuto možnost nastavit předáním příznaku AFX_CBRS_CLOSE do CBasePane::CreateEx.

Výchozí implementace kontroluje příznak AFX_CBRS_CLOSE.

CBasePane::CanBeDocked

Určuje, zda je možné podokno ukotvit do jiného podokna.

virtual BOOL CanBeDocked(CBasePane* pDockBar) const;

Parametry

pDockBar
[v] Ukazatel na jiné podokno.

Návratová hodnota

TRUE, pokud toto podokno lze ukotvit do jiného podokna; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu před ukotvením podokna určeného pDockBar k aktuálnímu podoknu.

Pomocí této metody a metody CBasePane::CanAcceptPane můžete řídit, jak se podokna ukotví do jiných podoken v aplikaci.

Výchozí implementace vrátí hodnotu FALSE.

CBasePane::CanBeResized

Určuje, zda je možné změnit velikost podokna.

virtual BOOL CanBeResized() const;

Návratová hodnota

TRUE, pokud je možné změnit velikost podokna; jinak NEPRAVDA.

Poznámky

Tato metoda zkontroluje příznak AFX_CBRS_RESIZE, který je ve výchozím nastavení zadán .CBasePane::OnCreate Pokud tento příznak není zadaný, správce ukotvení označí podokno interně jako nemovité místo dokování.

CBasePane::CanBeTabbedDocument

Určuje, jestli je možné podokno převést na dokument s kartami MDI.

virtual BOOL CanBeTabbedDocument() const;

Návratová hodnota

TRUE, pokud podokno lze převést na dokument s kartami; jinak NEPRAVDA. CBasePane::CanBeTabbedDocument vždy vrátí hodnotu NEPRAVDA.

Poznámky

Na dokumenty s kartami lze převést pouze objekty určitých CBasePaneodvozených typů, například CDockablePane – třída.

CBasePane::CanFloat

Určuje, zda může podokno plovákovat.

virtual BOOL CanFloat() const;

Návratová hodnota

TRUE, pokud podokno může plout; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu k určení, zda podokno může plovák.

Během sestavování můžete tuto možnost nastavit předáním příznaku AFX_CBRS_FLOAT do CBasePane::CreateEx.

Poznámka:

Architektura předpokládá, že ne plovoucí podokna jsou statická a že jejich stav ukotvení se nemůže změnit. Proto architektura neukládá dokovací stav ne plovoucích podoken.

Výchozí implementace kontroluje styl AFX_CBRS_FLOAT.

CBasePane::CanFocus

Určuje, jestli může podokno přijímat fokus.

virtual BOOL CanFocus() const;

Návratová hodnota

TRUE, pokud podokno může přijmout fokus; jinak NEPRAVDA.

Poznámky

Přepište tuto metodu v odvozené třídě pro řízení fokusu. Například vzhledem k tomu, že panely nástrojů nemohou přijímat fokus, vrátí tato metoda hodnotu FALSE, pokud je volána na objektech panelu nástrojů.

Architektura se pokusí nastavit vstupní fokus při ukotvení nebo plovoucím podokně.

CBasePane::CopyState

Zkopíruje stav daného podokna.

virtual void CopyState(CBasePane* pOrgBar);

Parametry

pOrgBar
[v] Ukazatel na jiné podokno.

Poznámky

Tato metoda zkopíruje stav z pOrgBar do tohoto podokna.

CBasePane::CreateDefaultMiniframe

Pokud podokno může plovoucí, tato metoda pro něj vytvoří minirámeček okno.

virtual CPaneFrameWnd* CreateDefaultMiniframe(CRect rectInitial);

Parametry

rectInitial
[v] Určuje počáteční souřadnice minirámečního okna.

Návratová hodnota

Ukazatel na nové okno minirámeček nebo NULL, pokud se vytvoření nezdařilo.

Poznámky

Architektura volá tuto metodu, když se podokno přepne do plovoucího stavu. Metoda vytvoří minirámeček okno a připojí podokno k tomuto okně.

Výchozí implementace vrátí hodnotu NULL.

CBasePane::CreateEx

Vytvoří ovládací prvek podokna.

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
[v] Rozšířené styly (další informace najdete v tématu CWnd::CreateEx ).

lpszClassName
[v] Název třídy okna.

lpszWindowName
[v] Název okna.

dwStyle
[v] Styl okna (viz CWnd::CreateEx).

Rect
[v] Počáteční obdélník.

pParentWnd
[v] Ukazatel na nadřazené okno.

Nid
[v] Určuje ID podokna. Musí být jedinečný.

dwControlBarStyle
[v] Příznaky stylu pro podokna

pContext
[v] Ukazatel na CcreateContext

Návratová hodnota

TRUE, pokud je podokno úspěšně vytvořeno; jinak NEPRAVDA.

Poznámky

Vytvoří okno třídy lpszClassName. Pokud zadáte WS_CAPTION, tato metoda vymaže bit stylu WS_CAPTION a nastaví CBasePane::m_bHasCaption hodnotu TRUE, protože knihovna nepodporuje podokna s titulky.

Můžete použít libovolnou kombinaci stylů podřízených oken a stylů ovládacích panelů MFC (CBRS_).

Knihovna přidá několik nových stylů pro podokna. Následující tabulka popisuje nové styly:

Styl Popis
AFX_CBRS_FLOAT Podokno může být plovoucí.
AFX_CBRS_AUTOHIDE Podokno podporuje režim automatického skrytí.
AFX_CBRS_RESIZE Velikost podokna se dá změnit. Důležité: Tento styl není implementován.
AFX_CBRS_CLOSE Podokno lze zavřít.
AFX_CBRS_AUTO_ROLLUP Podokno se dá zabalit, když bude plovoucí.
AFX_CBRS_REGULAR_TABS Když se jedno podokno ukotví do jiného podokna, které má tento styl, vytvoří se běžné okno s kartami. (Další informace najdete v tématu CTabbedPane – třída.)
AFX_CBRS_OUTLOOK_TABS Když se jedno podokno ukotví do jiného podokna, které má tento styl, vytvoří se okno s kartami ve stylu Outlooku. (Další informace najdete v tématu CMFCOutlookBar – třída.)

Chcete-li použít nové styly, zadejte je v dwControlBarStyle.

CBasePane::D ockPane

Ukotví podokno do jiného podokna nebo do okna rámečku.

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

Parametry

pDockBar
[v] Ukazatel na jiné podokno.

lpRect
[v] Určuje cílový obdélník.

dockMethod
[v] Určuje dokovací metodu.

Návratová hodnota

TRUE, pokud byl řídicí panel úspěšně ukotven; jinak NEPRAVDA.

Poznámky

Voláním této funkce ukotvíte podokno do jiného podokna nebo doku (CDockSite – třída), která je určena pDockBar, nebo do hlavního rámce, pokud má pDockBar hodnotu NULL.

dockMethod určuje, jak je podokno ukotveno. Seznam možných hodnot najdete v části CPane::D ockPane .

CBasePane::D ockPaneUsingRTTI

Ukotví podokno pomocí informací o typu za běhu.

void DockPaneUsingRTTI(BOOL bUseDockSite);

Parametry

bUseDockSite
[v] Pokud je hodnota TRUE, ukotví se na dokovací místo. Pokud je hodnota FALSE, ukotví se nadřazený rámec.

CBasePane::D ockToFrameWindow

Ukotví ukotvené podokno k rámu.

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

Parametry

dwAlignment
[v] Na straně nadřazeného rámce, ke kterému chcete podokno ukotvit.

lpRect
[v] Požadovaná velikost.

dwDockFlags
[v] Ignorovaný.

pRelativeBar
[v] Ignorovaný.

nRelativeIndex
[v] Ignorovaný.

bOuterEdge
[v] Pokud je hodnota TRUE a na straně určené dwAlignment jsou další ukotvená podokna, je podokno ukotveno mimo ostatní podokna, blíže k okraji nadřazeného rámce. Pokud je hodnota FALSE, podokno se ukotví blíž ke středu klientské oblasti.

Návratová hodnota

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

Poznámky

Tato metoda selže, pokud nelze vytvořit rozdělovač podokna ( CPaneDivider – třída). V opačném případě vždy vrátí hodnotu PRAVDA.

CBasePane::D oesAllowDynInsertBefore

Určuje, zda lze mezi toto podokno a nadřazený rámec dynamicky vložit jiné podokno.

virtual BOOL DoesAllowDynInsertBefore() const;

Návratová hodnota

TRUE, pokud uživatel může vložit jiné podokno; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu k určení, zda uživatel může dynamicky vložit podokno před toto podokno.

Předpokládejme například, že vaše aplikace vytvoří podokno ukotvené na levé straně rámečku (například na panelu Outlooku). Chcete-li zabránit uživateli v ukotvení jiného podokna vlevo od prvního podokna, přepište tuto metodu a vraťte hodnotu FALSE.

Doporučujeme přepsat tuto metodu a vrátit hodnotu FALSE pro ne plovoucí podokna odvozená z CDockablePane – třída.

Výchozí implementace vrátí hodnotu TRUE.

CBasePane::D oPaint

Vyplní pozadí podokna.

virtual void DoPaint(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení.

Poznámky

Výchozí implementace volá aktuálního správce vizuálů k vyplnění pozadí ( CMFCVisualManager::OnFillBarBackground).

CBasePane::EnableDocking

Umožňuje ukotvit podokno na hlavní rámec.

virtual void EnableDocking(DWORD dwAlignment);

Parametry

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

Poznámky

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

EnableDocking nastaví interní příznak CBasePane::m_dwEnabledAlignment a rozhraní tento příznak zkontroluje, když je ukotveno podokno.

Volání CBasePane::GetEnabledAlignment k určení ukotvení zarovnání pro podokno.

CBasePane::EnableGripper

Povolí nebo zakáže úchyt. Pokud je úchyt povolený, může ho uživatel přetáhnout a přemístit podokno.

virtual void EnableGripper(BOOL bEnable);

Parametry

bEnable
[v] TRUE pro povolení úchytu; NEPRAVDA, pokud ji chcete zakázat.

Poznámky

Architektura používá tuto metodu k povolení úchytu místo použití stylu WS_CAPTION.

CBasePane::FloatPane

S plovoucím podoknem.

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

Parametry

rectFloat
[v] Určuje souřadnice obrazovky, ve kterých se zobrazuje plovoucí podokno.

dockMethod
[v] Určuje dokovací metodu, která se má použít k plovoucímu podoknu.

BShow
[v] Určuje, jestli je plovoucí podokno viditelné (TRUE) nebo skryté (FALSE).

Návratová hodnota

TRUE, pokud podokno bylo úspěšně plovoucí; jinak NEPRAVDA.

Poznámky

Voláním této metody lze plovoucí podokno na pozici obrazovky určené rectFloat.

CBasePane::get_accHelpTopic

Architektura volá tuto metodu, aby načetla úplnou cestu k souboru WinHelp , který je přidružen k zadanému objektu a identifikátor příslušného tématu v tomto souboru.

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

Parametry

pszHelpFile
[v] Adresa BSTR, která obdrží úplnou cestu k souboru WinHelp , který je přidružen k zadanému objektu, pokud existuje.

varChild
[v] Určuje, zda téma nápovědy, které se má načíst, je objekt nebo jeden z podřízených prvků objektu. Tento parametr může být CHILDID_SELF (k získání tématu nápovědy pro objekt) nebo podřízeného ID (k získání tématu nápovědy pro jeden z podřízených prvků objektu).

pidTopic
[v] Identifikuje téma souboru nápovědy, které je přidruženo k zadanému objektu.

Návratová hodnota

CBasePane neimplementuje tuto metodu. CBasePane::get_accHelpTopic Proto vždy vrací S_FALSE.

Poznámky

Tato funkce je součástí podpory aktivní přístupnosti v prostředí MFC. Přepište tuto funkci v odvozené třídě tak, aby poskytovala informace o objektu.

CBasePane::get_accSelection

Architektura volá tuto metodu pro načtení vybraných podřízených objektů tohoto objektu.

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametry

pvarChildren
[v] Přijímá informace, které identifikují vybrané podřízené položky.

Návratová hodnota

CBasePane neimplementuje tuto metodu. Pokud je pvarChildren null, vrátí tato metoda E_INVALIDARG. V opačném případě tato metoda vrátí DISP_E_MEMBERNOTFOUND.

Poznámky

Tato funkce je součástí podpory aktivní přístupnosti v prostředí MFC. Tuto funkci přepište v odvozené třídě, pokud máte jiné než windowed prvky uživatelského rozhraní než ovládací prvky ActiveX bez oken.

CBasePane::GetCaptionHeight

Vrátí výšku titulku.

virtual int GetCaptionHeight() const;

Návratová hodnota

Výška titulku.

CBasePane::GetControlBarStyle

Vrátí styl řídicího pruhu.

virtual DWORD GetControlBarStyle() const

Návratová hodnota

Bitové nebo kombinace příznaků AFX_CBRS_.

Poznámky

Vrácená hodnota je kombinací následujících možných hodnot.

Styl Popis
AFX_CBRS_FLOAT Nastaví řídicí panel jako plovoucí.
AFX_CBRS_AUTOHIDE Povolí režim automatického skrytí.
AFX_CBRS_RESIZE Umožňuje změnu velikosti řídicího panelu. Po nastavení tohoto příznaku lze ovládací panel umístit do dokovatelného podokna.
AFX_CBRS_CLOSE Umožňuje skrytí řídicího panelu.

CBasePane::GetCurrentAlignment

Vrátí zarovnání aktuálního podokna.

virtual DWORD GetCurrentAlignment() const;

Návratová hodnota

Aktuální zarovnání řídicího panelu V následující tabulce jsou uvedeny možné hodnoty:

Hodnota Zarovnání
CBRS_ALIGN_LEFT Zarovnání doleva
CBRS_ALIGN_RIGHT Zarovnání doprava.
CBRS_ALIGN_TOP Zarovnání nahoře
CBRS_ALIGN_BOTTOM Zarovnání dolů.

CBasePane::GetDockingMode

Vrátí aktuální režim ukotvení podokna.

virtual AFX_DOCK_TYPE GetDockingMode() const;

Návratová hodnota

DT_STANDARD, pokud je přetažení podokna označené na obrazovce obdélníkem. DT_IMMEDIATE, pokud je obsah podokna přetažen.

Poznámky

Architektura volá tuto metodu k určení aktuálního dokovacího režimu podokna.

Pokud CBasePane::m_dockMode není definováno (DT_UNDEFINED), je režim ukotvení převzat z globálního dokovacího režimu (AFX_GLOBAL_DATA::m_dockModeGlobal).

Nastavením m_dockMode nebo přepsáním GetDockingMode můžete řídit režim ukotvení pro každé podokno.

CBasePane::GetDockSiteFrameWnd

Vrátí ukazatel na objekt CDockingPanesRow, kde je podokno ukotveno.

virtual CWnd* GetDockSiteFrameWnd() const;

Návratová hodnota

Ukazatel na web docku v podokně.

Poznámky

Voláním této metody načtěte ukazatel na web docku v podokně. Web docku může být buď okno hlavního rámce, pokud je podokno ukotvené k hlavnímu rámečku, nebo minirámeček okno, pokud je podokno plovoucí.

CBasePane::GetEnabledAlignment

Vrátí CBRS_ALIGN_ styly použité v podokně.

virtual DWORD GetEnabledAlignment() const;

Návratová hodnota

Kombinace stylů CBRS_ALIGN_. V následující tabulce jsou uvedeny možné styly:

Příznak Povolené zarovnání
CBRS_ALIGN_LEFT Vlevo.
CBRS_ALIGN_RIGHT Aha.
CBRS_ALIGN_TOP Vrchol.
CBRS_ALIGN_BOTTOM Dno.
CBRS_ALIGN_ANY Kombinace všech příznaků

Poznámky

Voláním této metody určíte povolené zarovnání pro podokno. Povolené zarovnání znamená strany hlavního okna rámečku, na které lze ukotvit podokno.

Povolte ukotvit zarovnání pomocí CBasePane::EnableDocking.

CBasePane::GetMFCStyle

Vrátí styly podokna specifické pro mfc.

virtual DWORD GetMFCStyle() const;

Návratová hodnota

Kombinace stylů podokna specifických pro knihovnu (AFX_CBRS_).

CBasePane::GetPaneIcon

Vrátí popisovač ikony podokna.

virtual HICON GetPaneIcon(BOOL bBigIcon);

Parametry

bBigIcon
[v] Určuje ikonu 32 pixelů o 32 pixelů, pokud je pravda; určuje ikonu 16 pixelů o 16 pixelů, pokud JE NEPRAVDA.

Návratová hodnota

Úchyt ikony podokna. V případě neúspěchu vrátí hodnotu NULL.

Poznámky

Výchozí implementace volá CWnd::GetIcon.

CBasePane::GetPaneRow

Vrátí ukazatel na objekt CDockingPanesRow, kde je podokno ukotveno.

CDockingPanesRow* GetPaneRow();

Návratová hodnota

Ukazatel na CDockingPanesRow ukotvení podokna nebo hodnotu NULL, pokud je plovoucí.

Poznámky

Voláním této metody volat přístup k řádku, ve kterém je ukotveno podokno. Chcete-li například uspořádat podokna v určitém řádku, volání GetPaneRow a volání CDockingPanesRow::ArrangePanes.

CBasePane::GetPaneStyle

Vrátí styl podokna.

virtual DWORD GetPaneStyle() const;

Návratová hodnota

Kombinace stylů ovládacích pruhů (včetně stylů CBRS_), které byly nastaveny metodou CBasePane::SetPaneStyle při vytváření.

CBasePane::GetParentDockSite

Vrátí ukazatel na nadřazenou lokalitu docku.

virtual CDockSite* GetParentDockSite() const;

Návratová hodnota

Nadřazený web docku.

CBasePane::GetParentMiniFrame

Vrátí ukazatel na nadřazené okno minirámeček.

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

Parametry

bNoAssert
[v] Pokud je pravda, tato metoda nekontroluje neplatných ukazatelů. Pokud tuto metodu zavoláte při ukončení aplikace, nastavte tento parametr na HODNOTU TRUE.

Návratová hodnota

Platný ukazatel na nadřazené minirámeček okno, pokud je podokno plovoucí; jinak NULL.

Poznámky

Voláním této funkce načtete ukazatel na nadřazené okno minirámeček. Tato metoda iteruje všemi nadřazenými objekty a kontroluje objekt odvozený z CPaneFrameWnd – třída.

Slouží GetParentMiniFrame k určení, zda je podokno plovoucí.

CBasePane::GetParentTabbedPane

Vrátí ukazatel na nadřazené podokno s kartami.

CBaseTabbedPane* GetParentTabbedPane() const;

Návratová hodnota

Ukazatel na nadřazené podokno s kartami, pokud existuje; jinak NULL.

CBasePane::GetParentTabWnd

Vrátí ukazatel na nadřazené okno, které je uvnitř karty.

CMFCBaseTabCtrl* GetParentTabWnd(HWND& hWndTab) const;

Parametry

hWndTab
[ven] Pokud návratová hodnota není NULL, tento parametr obsahuje popisovač nadřazeného okna s kartami.

Návratová hodnota

Platný ukazatel na nadřazené okno s kartami nebo NULL.

Poznámky

Pomocí této funkce můžete načíst ukazatel na nadřazené okno s kartami. Někdy nestačí volat GetParent, protože podokno může být uvnitř dokovací obálky ( CDockablePaneAdapter – třída) nebo uvnitř adaptéru podokna ( CDockablePaneAdapter – třída). Když použijete GetParentTabWnd , budete moct v těchto případech načíst platný ukazatel (za předpokladu, že nadřazený objekt je okno s kartami).

CBasePane::GetRecentVisibleState

Architektura volá tuto metodu při obnovení podokna z archivu.

virtual BOOL GetRecentVisibleState() const;

Návratová hodnota

BoOL, který určuje nedávný viditelný stav. Pokud je pravda, podokno bylo viditelné při serializaci a mělo by být viditelné při obnovení. Pokud je hodnota FALSE, podokno bylo při serializaci skryté a mělo by být při obnovení skryté.

CBasePane::HideInPrintPreviewMode

Určuje, jestli je podokno skryté v náhledu tisku.

virtual BOOL HideInPrintPreviewMode() const;

Návratová hodnota

TRUE, pokud se podokno nezobrazuje v náhledu tisku; jinak NEPRAVDA.

Poznámky

Základní podokna se nezobrazují v náhledu tisku. Proto tato metoda vždy vrátí hodnotu PRAVDA.

CBasePane::InsertPane

Zaregistruje zadané podokno ve správci ukotvení.

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

Parametry

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

pTarget
[v] Ukazatel na sousední podokno.

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

Návratová hodnota

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

CBasePane::IsAccessibilityCompatible

Určuje, jestli podokno podporuje funkci Aktivní přístupnost.

virtual BOOL IsAccessibilityCompatible();

Návratová hodnota

TRUE, pokud podokno podporuje aktivní přístupnost; jinak NEPRAVDA.

CBasePane::IsAutoHideMode

Určuje, zda je podokno v režimu automatického skrytí.

virtual BOOL IsAutoHideMode() const;

Návratová hodnota

TRUE, pokud je podokno v režimu automatického skrytí; jinak NEPRAVDA.

Poznámky

Základní podokna nelze automaticky skrýt. Tato metoda vždy vrátí hodnotu FALSE.

CBasePane::IsDialogControl

Určuje, zda je podokno ovládací prvek dialogového okna.

BOOL IsDialogControl() const;

Návratová hodnota

TRUE, pokud je podokno ovládací prvek dialogového okna; jinak NEPRAVDA.

Poznámky

Architektura používá tuto metodu k zajištění konzistence rozložení pro všechna podokna.

CBasePane::IsDocked

Určuje, zda je podokno ukotveno.

virtual BOOL IsDocked() const;

Návratová hodnota

PRAVDA, pokud nadřazený prvek podokna není minirámeček nebo pokud je podokno plovoucí v mini rámečku s jiným podoknem; jinak NEPRAVDA.

CBasePane::IsFloating

Určuje, zda je podokno plovoucí.

virtual BOOL IsFloating() const;

Návratová hodnota

TRUE, pokud je podokno plovoucí; jinak NEPRAVDA.

Poznámky

Tato metoda vrátí opačnou hodnotu CBasePane::IsDocked.

CBasePane::IsHorizontal

Určuje, zda je podokno ukotveno vodorovně.

virtual BOOL IsHorizontal() const;

Návratová hodnota

TRUE, pokud je podokno ukotveno vodorovně; jinak NEPRAVDA.

Poznámky

Výchozí implementace kontroluje aktuální ukotvit zarovnání pro CBRS_ORIENT_HORZ.

CBasePane::IsInFloatingMultiPaneFrameWnd

Určuje, zda je podokno v okně s rámečkem s více podokny ( CMultiPaneFrameWnd – třída).

virtual BOOL IsInFloatingMultiPaneFrameWnd() const;

Návratová hodnota

TRUE, pokud je podokno v okně s více podokny rámečku; jinak NEPRAVDA.

Poznámky

V okně s rámečkem s více podokny můžou plout pouze ukotvená podokna. CBasePane::IsInFloatingMultiPaneFrameWnd Proto vždy vrátí hodnotu FALSE.

CBasePane::IsMDITabbed

Určuje, zda bylo podokno přidáno do podřízeného okna MDI jako dokument s kartami.

virtual BOOL IsMDITabbed() const;

Návratová hodnota

TRUE Pokud bylo podokno přidáno do podřízeného okna MDI jako dokument s kartami; jinak NEPRAVDA.

CBasePane::IsPaneVisible

Určuje, jestli je pro podokno nastaven příznak WS_VISIBLE.

BOOL IsPaneVisible() const;

Návratová hodnota

TRUE, pokud je nastavena WS_VISIBLE; jinak NEPRAVDA.

Poznámky

K určení viditelnosti podokna použijte CBasePane::IsVisible .

CBasePane::IsPointNearDockSite

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

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

Parametry

bod
[v] Zadaný bod.

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

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

Návratová hodnota

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

Poznámky

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

CBasePane::IsResizable

Určuje, zda je možné změnit velikost podokna.

virtual BOOL IsResizable() const;

Návratová hodnota

TRUE, pokud může uživatel změnit velikost podokna; jinak NEPRAVDA.

Poznámky

Podokna třídy CDockablePane lze změnit velikost.

Stavový řádek ( CMFCStatusBar – třída) a dock bar ( CDockSite – třída) nelze změnit.

CBasePane::IsRestoredFromRegistry

Určuje, zda je podokno obnoveno z registru.

virtual BOOL IsRestoredFromRegistry() const;

Návratová hodnota

TRUE, pokud je podokno obnoveno z registru; jinak NEPRAVDA.

CBasePane::IsTabbed

Určuje, zda bylo podokno vloženo do ovládacího prvku karta okna s kartami.

virtual BOOL IsTabbed() const;

Návratová hodnota

TRUE, pokud je ovládací panel vložen do karty okna s kartami; jinak NEPRAVDA.

Poznámky

Tato metoda načte ukazatel na okamžitý nadřazený objekt a určuje, zda třída runtime nadřazeného objektu je CMFCBaseTabCtrl – třída.

CBasePane::IsVisible

Určuje, zda je podokno viditelné.

virtual BOOL IsVisible() const;

Návratová hodnota

TRUE, pokud je podokno viditelné; jinak NEPRAVDA.

Poznámky

Tuto metodu použijte k určení viditelnosti podokna. Nepoužívejte ::IsWindowVisible.

Pokud není podokno s kartami (viz CBasePane::IsTabbed), tato metoda zkontroluje styl WS_VISIBLE. Pokud je podokno na záložkách, tato metoda zkontroluje viditelnost nadřazeného okna s kartami. Pokud je nadřazené okno viditelné, funkce zkontroluje viditelnost karty podokna pomocí CMFCBaseTabCtrl::IsTabVisible.

CBasePane::LoadState

Načte stav podokna z registru.

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

Parametry

lpszProfileName
[v] Název profilu

nIndex
[v] Index profilu

UIID
[v] ID podokna.

Návratová hodnota

TRUE, pokud byl stav podokna úspěšně načten; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu pro načtení stavu podokna z registru. Přepsat v odvozené třídě načtení dalších informací uložených CBasePane ::SaveState.

CBasePane::MoveWindow

Přesune podokno.

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

Parametry

Rect
[v] Obdélník určující nové umístění a velikost podokna.

bRepaint
[v] Pokud je hodnota TRUE, podokno se znovu nakreslí. Pokud je hodnota FALSE, podokno se nepřekreslí.

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

Návratová hodnota

Popisovač struktury odložené pozice okna nebo NULL.

Poznámky

Pokud jako parametr hdwp předáte hodnotu NULL, tato metoda přesune okno normálně. Pokud předáte popisovač, tato metoda provede přesunutí odloženého okna. Popisovač můžete získat voláním BeginDeferWindowPos nebo uložením návratové hodnoty předchozího volání této metody.

CBasePane::OnAfterChangeParent

Volá se rozhraním po nadřazených změnách podokna.

virtual void OnAfterChangeParent(CWnd* pWndOldParent);

Parametry

pWndOldParent
[v] Ukazatel na předchozí nadřazený objekt.

Poznámky

Architektura volá tuto metodu po nadřazených změnách podokna, obvykle kvůli ukotvení nebo plovoucí operaci.

Výchozí implementace nic nedělá.

CBasePane::OnBeforeChangeParent

Volá se rozhraním těsně před tím, než podokno změní nadřazené okno.

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

Parametry

pWndNewParent
[v] Ukazatel na nové nadřazené okno

bDelay
[v] Určuje, zda je nutné zpozdit úpravy rozložení.

Poznámky

Architektura volá tuto metodu těsně před nadřazené změny podokna, obvykle kvůli ukotvení, plovoucí nebo automatické skrytí operace.

Výchozí implementace nic nedělá.

CBasePane::OnDrawCaption

Architektura volá tuto metodu při vykreslení titulku.

virtual void OnDrawCaption();

Poznámky

Tato metoda nemá žádné funkce pro CBasePane třídu.

CBasePane::OnMovePaneDivider

Tato metoda se aktuálně nepoužívá.

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

Parametry

nepoužitý
[v] Nepoužívá se.

CBasePane::OnPaneContextMenu

Volá se rozhraním, když sestaví nabídku se seznamem podoken.

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

Parametry

pParentFrame
[v] Ukazatel na nadřazený rámec.

bod
[v] Určuje umístění místní nabídky.

Poznámky

OnPaneContextMenu volá dokovací správce, který udržuje seznam podoken, které patří do aktuálního okna rámečku. Tato metoda přidá názvy podoken do místní nabídky a zobrazí ji. Příkazy v nabídce zobrazují nebo skryjí jednotlivá podokna.

Tuto metodu přepište, abyste toto chování přizpůsobili.

CBasePane::OnRemoveFromMiniFrame

Volá se rozhraním, když je podokno odebráno z nadřazeného okna mini rámečku.

virtual void OnRemoveFromMiniFrame(CPaneFrameWnd* pMiniFrame);

Parametry

pMiniFrame
[v] Ukazatel na okno minirámeček, ze kterého je podokno odebráno.

Poznámky

Architektura volá tuto metodu, když je podokno odebráno z nadřazeného minirámeček okna (například v důsledku ukotvení).

Výchozí implementace nic nedělá.

CBasePane::OnSetAccData

CBasePane nepoužívá tuto metodu.

virtual BOOL OnSetAccData(long lVal);

Parametry

LVal
[v] Nepoužívá se.

Návratová hodnota

Tato metoda vždy vrátí hodnotu TRUE.

Poznámky

CBasePane::P aneFromPoint

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

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

Parametry

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

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

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

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

Návratová hodnota

- CBasePaneodvozený objekt, který obsahuje daný bod, nebo NULL pokud nebyl nalezen žádný podokno.

CBasePane::RecalcLayout

CBasePane nepoužívá tuto metodu.

virtual void RecalcLayout();

CBasePane::RemovePaneFromDockManager

Zruší registraci podokna a odebere ho ze seznamu ve správci ukotvení.

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

Parametry

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

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

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

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

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

CBasePane::SaveState

Uloží stav podokna do registru.

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

Parametry

lpszProfileName
[v] Název profilu

nIndex
[v] Index profilu

UIID
[v] ID podokna.

Návratová hodnota

TRUE, pokud byl stav úspěšně uložen; jinak NEPRAVDA.

Poznámky

Architektura volá tuto metodu, když uloží stav podokna do registru. Přepsání SaveState v odvozené třídě pro uložení dalších informací.

CBasePane::SelectDefaultFont

Vybere výchozí písmo pro daný kontext zařízení.

CFont* SelectDefaultFont(CDC* pDC);

Parametry

pDC
[v] Kontext zařízení.

Návratová hodnota

Ukazatel na výchozí objekt CFont Class .

CBasePane::SetControlBarStyle

Nastaví styl ovládacího panelu.

virtual void SetControlBarStyle(DWORD dwNewStyle);

Parametry

dwNewStyle
[v] Bitové nebo kombinace následujících možných hodnot.

Styl Popis
AFX_CBRS_FLOAT Nastaví řídicí panel jako plovoucí.
AFX_CBRS_AUTOHIDE Povolí režim automatického skrytí.
AFX_CBRS_RESIZE Umožňuje změnu velikosti řídicího panelu. Po nastavení tohoto příznaku lze ovládací panel umístit do dokovatelného podokna.
AFX_CBRS_CLOSE Umožňuje skrytí řídicího panelu.

CBasePane::SetDockingMode

Nastaví režim ukotvení podokna.

void SetDockingMode(AFX_DOCK_TYPE dockModeNew);

Parametry

dockModeNew
[v] Určuje nový režim ukotvení podokna.

Poznámky

Architektura podporuje dva režimy ukotvení: standardní a okamžité.

Ve standardním dokovacím režimu se podokna a okna mini rámečku pohybují pomocí obdélníku přetažení. V okamžitém dokovacím režimu se řídicí panely a okna mini rámečku přesunou okamžitě s jejich kontextem.

Zpočátku je režim ukotvení definován globálně pomocí CDockingManager::m_dockModeGlobal. Režim ukotvení pro každé podokno můžete nastavit jednotlivě pomocí SetDockingMode metody.

CBasePane::SetPaneAlignment

Nastaví zarovnání podokna.

virtual void SetPaneAlignment(DWORD dwAlignment);

Parametry

dwAlignment
[v] Určuje nové zarovnání.

Poznámky

Architektura obvykle volá tuto metodu, když je podokno ukotveno z jedné strany hlavního rámce do jiné.

Následující tabulka uvádí možné hodnoty dwAlignment:

Hodnota Zarovnání
CBRS_ALIGN_LEFT Zarovnání doleva
CBRS_ALIGN_RIGHT Zarovnání doprava.
CBRS_ALIGN_TOP Zarovnání nahoře
CBRS_ALIGN_BOTTOM Zarovnání dolů.

CBasePane::SetPaneStyle

Nastaví styl podokna.

virtual void SetPaneStyle(DWORD dwNewStyle);

Parametry

dwNewStyle
[v] Určuje nový styl, který se má nastavit.

Poznámky

Tuto metodu lze použít k nastavení libovolného ze stylů CBRS_, které jsou definovány v afxres.h. Vzhledem k tomu, že se styl podokna a zarovnání podokna ukládají společně, nastavte nový styl tak, že ho zkombinujete s aktuálním zarovnáním následujícím způsobem.

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

CBasePane::SetWindowPos

Změní velikost, umístění a pořadí Z podokna.

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

Parametry

pWndInsertAfter
[v] CWnd Identifikuje objekt, který je před tímto CWnd objektem v pořadí Z. Další informace naleznete v tématu CWnd::SetWindowPos.

x
[v] Určuje umístění levé strany okna.

y
[v] Určuje pozici horní části okna.

cx
[v] Určuje šířku okna.

Cy
[v] Určuje výšku okna.

nFlags
[v] Určuje možnosti velikosti a umístění. Další informace naleznete v tématu CWnd::SetWindowPos.

hdwp
[v] Popisovač struktury, která obsahuje informace o velikosti a poloze pro jedno nebo více oken

Návratová hodnota

Popisovač aktualizované struktury odložené pozice okna nebo NULL.

Poznámky

Pokud pWndInsertAfter je NULL, tato metoda volá CWnd::SetWindowPos. Pokud pWndInsertAfter je non-NULL, tato metoda volá DeferWindowPos.

CBasePane::ShowPane

Zobrazí nebo skryje podokno.

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

Parametry

BShow
[v] Určuje, jestli se má podokno zobrazit (PRAVDA) nebo skrýt (NEPRAVDA).

bDelay
[v] Pokud je hodnota TRUE, přepočítání rozložení ukotvení se zpozdí.

bActivate
[v] Pokud je hodnota TRUE, podokno je po zobrazení aktivní.

Poznámky

Tato metoda zobrazuje nebo skryje podokno. Tuto metodu použijte místo ShowWindow toho, že tato metoda upozorní příslušné správce ukotvení o změnách v viditelnosti podokna.

K určení aktuální viditelnosti podokna použijte CBasePane::IsVisible .

CBasePane::StretchPane

Roztáhne podokno svisle nebo vodorovně.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametry

nLength
[v] Délka, o kterou chcete podokno roztáhnout.

bVert
[v] Pokud je pravda, roztáhněte podokno svisle. Pokud je hodnota FALSE, roztáhněte podokno vodorovně.

Návratová hodnota

Velikost roztaženého podokna

CBasePane::UndockPane

Odebere podokno z webu docku, výchozího posuvníku nebo okna mini rámečku, kde je aktuálně ukotvený.

virtual void UndockPane(BOOL bDelay=FALSE);

Parametry

bDelay
Pokud je hodnota TRUE, rozložení ukotvení se okamžitě nepřepočítá.

Poznámky

Voláním této metody můžete manipulovat se stavem podokna nebo vyloučit podokno z ukotveného rozložení.

Pokud chcete pokračovat v používání tohoto podokna, zavolejte CBasePane ::D ockPane nebo CBasePane::FloatPane před voláním této metody.

Viz také

Graf hierarchie
Třídy
Podokno CPane
CWnd – třída