CFrameWnd osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Biztosítja a Windows egyetlen dokumentumfelület (SDI) átfedésben lévő vagy előugró keretablakának funkcióit, valamint az ablak kezeléséhez szükséges tagokat.

Szemantika

class CFrameWnd : public CWnd

Tagok

Nyilvános konstruktorok

Név	Leírás
CFrameWnd::CFrameWnd	Egy CFrameWnd objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
CFrameWnd::ActivateFrame	A keret láthatóvá és elérhetővé válik a felhasználó számára.
CFrameWnd::BeginModalState	A keretablakot modálisra állítja.
CFrameWnd::Create	Hívás az objektumhoz társított Windows-keretablak létrehozásához és inicializálásához CFrameWnd .
CFrameWnd::CreateView	Olyan nézetet hoz létre egy kereten belül, amely nem a forrásból CViewszármazik.
CFrameWnd::DockControlBar	Egy vezérlősáv rögzítése.
CFrameWnd::EnableDocking	Lehetővé teszi a vezérlősáv rögzítését.
CFrameWnd::EndModalState	Véget vet a keretablak modális állapotának. Az összes ablak letiltását BeginModalStateengedélyezi.
CFrameWnd::FloatControlBar	Egy vezérlősávot lebegtet.
CFrameWnd::GetActiveDocument	Az aktív CDocument objektumot adja vissza.
CFrameWnd::GetActiveFrame	Az aktív CFrameWnd objektumot adja vissza.
CFrameWnd::GetActiveView	Az aktív CView objektumot adja vissza.
CFrameWnd::GetControlBar	Lekéri a vezérlősávot.
CFrameWnd::GetDockState	Lekéri egy keretablak dokkolásának állapotát.
CFrameWnd::GetMenuBarState	Lekéri a menü megjelenítési állapotát az aktuális MFC-alkalmazásban.
CFrameWnd::GetMenuBarVisibility	Azt jelzi, hogy az aktuális MFC-alkalmazásban a menü alapértelmezett viselkedése rejtett vagy látható-e.
CFrameWnd::GetMessageBar	A keretablakhoz tartozó állapotsorra mutató mutatót ad vissza.
CFrameWnd::GetMessageString	Egy parancsazonosítónak megfelelő üzenetet kér le.
CFrameWnd::GetTitle	Lekéri a kapcsolódó vezérlősáv címét.
CFrameWnd::InitialUpdateFrame	OnInitialUpdate A keretablak összes nézetéhez tartozó tagfüggvény meghívását okozza.
CFrameWnd::InModalState	Egy értéket ad vissza, amely jelzi, hogy egy keretablak modális állapotban van-e.
CFrameWnd::IsTracking	Meghatározza, hogy az elválasztósáv jelenleg áthelyezés alatt áll-e.
CFrameWnd::LoadAccelTable	Hívás egy gyorsítótábla betöltésére.
CFrameWnd::LoadBarState	Hívás a vezérlősáv beállításainak visszaállításához.
CFrameWnd::LoadFrame	Hívás, hogy dinamikusan hozzon létre egy keretablakot az erőforrás-információkból.
CFrameWnd::NegotiateBorderSpace	A keretablak szegélyterületének egyeztetése.
CFrameWnd::OnBarCheck	Akkor hívható meg, ha a megadott vezérlősávon műveletet hajtanak végre.
CFrameWnd::OnContextHelp	Kezeli a SHIFT+F1 súgót a helyben lévő elemekhez.
CFrameWnd::OnSetPreviewMode	Beállítja az alkalmazás fő keretablakát nyomtatási-előnézeti módba és kifelé.
CFrameWnd::OnUpdateControlBarMenu	A keretrendszer meghívta a társított menü frissítésekor.
CFrameWnd::RecalcLayout	Áthelyezi az objektum vezérlősávjait CFrameWnd .
CFrameWnd::SaveBarState	Hívás a vezérlősáv beállításainak mentéséhez.
CFrameWnd::SetActivePreviewView	A megadott nézetet a Rich Preview aktív nézetének jelöli ki.
CFrameWnd::SetActiveView	Beállítja az aktív CView objektumot.
CFrameWnd::SetDockState	Hívás a keretablak rögzítéséhez a főablakban.
CFrameWnd::SetMenuBarState	Az aktuális MFC-alkalmazásban a menü megjelenítési állapotát rejtettre vagy megjeleníthetőre állítja.
CFrameWnd::SetMenuBarVisibility	Az aktuális MFC-alkalmazásban a menü alapértelmezett viselkedését rejtettnek vagy láthatónak állítja be.
CFrameWnd::SetMessageText	Egy szabványos állapotsor szövegét állítja be.
CFrameWnd::SetProgressBarPosition	A Tálcán megjelenített Windows 7 folyamatjelző sáv aktuális pozícióját állítja be.
CFrameWnd::SetProgressBarRange	Beállítja a Windows 7 folyamatjelző sávjának tartományát a tálcán.
CFrameWnd::SetProgressBarState	Beállítja a tálcán megjelenő állapotjelző típusát és állapotát.
CFrameWnd::SetTaskbarOverlayIcon	Túlterhelt. Átfedést alkalmaz egy tálcán lévő gombra az alkalmazás állapotának vagy a felhasználó értesítésének jelzéséhez.
CFrameWnd::SetTitle	Beállítja a kapcsolódó vezérlősáv címét.
CFrameWnd::ShowControlBar	Hívás a vezérlősáv megjelenítéséhez.
CFrameWnd::ShowOwnedWindows	Megjeleníti az objektum leszármazottainak összes ablakát CFrameWnd .

Védett metódusok

Név	Leírás
CFrameWnd::OnCreateClient	Létrehoz egy ügyfélablakot a kerethez.
CFrameWnd::OnHideMenuBar	Az aktuális MFC-alkalmazás menüje előtt van meghívva.
CFrameWnd::OnShowMenuBar	Az aktuális MFC-alkalmazás menüje előtt van meghívva.

Nyilvános adatok tagjai

Név	Leírás
CFrameWnd::m_bAutoMenuEnable	A vezérlők automatikusan engedélyezik és letiltják a menüelemek funkcióit.
CFrameWnd::rectDefault	Adja át ezt a statikus CRect paramétert egy CFrameWnd objektum létrehozásakor, hogy a Windows kiválaszthassa az ablak kezdeti méretét és pozícióját.

Megjegyzések

Ha hasznos keretablakot szeretne létrehozni az alkalmazáshoz, hozzon létre egy osztályt a következőből CFrameWnd: . Tagváltozók hozzáadása a származtatott osztályhoz az alkalmazásra jellemző adatok tárolásához. Üzenetkezelő tagfüggvények és üzenettérkép implementálása a származtatott osztályban annak meghatározásához, hogy mi történik, amikor az üzeneteket az ablakba irányítják.

A keretablakok létrehozásának három módja van:

• Közvetlenül a következő használatával Createhozhatja létre: .

• Közvetlenül a következő használatával LoadFramehozhatja létre: .

• Közvetetten dokumentumsablon használatával hozza létre.

A hívás Create előtt vagy LoadFramea C++ new operátorral kell létrehoznia a keretablak objektumot a halomra. Hívás Createelőtt regisztrálhat egy ablakosztályt a globális függvénnyel a AfxRegisterWndClass keret ikonjának és osztálystílusainak beállításához.

Create A tagfüggvény használatával azonnali argumentumként adja át a keret létrehozási paramétereit.

LoadFrame kevesebb argumentumot igényel, mint Createa , és ehelyett lekéri az alapértelmezett értékek többségét az erőforrásokból, beleértve a keret feliratát, ikonját, gyorsítótábláját és menüjét. Ahhoz, hogy elérhető LoadFramelegyen, ezeknek az erőforrásoknak ugyanazzal az erőforrás-azonosítóval kell rendelkezniük (például IDR_MAINFRAME).

Ha egy CFrameWnd objektum nézeteket és dokumentumokat tartalmaz, azokat közvetetten a keretrendszer hozza létre, nem pedig közvetlenül a programozó. Az CDocTemplate objektum a keret létrehozását, az azt tartalmazó nézetek létrehozását és a nézetek és a megfelelő dokumentum közötti kapcsolatot vezényli. A konstruktor paraméterei meghatározzák CDocTemplate a CRuntimeClass három érintett osztályt (dokumentum, keret és nézet). A CRuntimeClass keretrendszer egy objektumot használ az új keretek dinamikus létrehozásához, amikor a felhasználó megadja (például az Új fájl vagy a több dokumentumfelület (MDI) Ablak új parancsával).

A fenti CFrameWnd mechanizmus megfelelő működéséhez deklarálni DECLARE_DYNCREATE kell egy keretablak-osztályt, amelyből származikRUNTIME_CLASS.

Az A CFrameWnd alapértelmezett implementációkat tartalmaz a főablak alábbi funkcióinak végrehajtásához egy tipikus Windows-alkalmazásban:

• A CFrameWnd keretablakok nyomon követnek egy jelenleg aktív nézetet, amely független a Windows aktív ablakától vagy az aktuális bemeneti fókusztól. Ha a keret újraaktiválva van, az aktív nézet hívással CView::OnActivateViewértesítést kap.

• A parancsüzeneteket és számos gyakori keretértesítési üzenetet, köztük a OnSetFocus, OnHScrollés OnVScroll a függvények CWndáltal kezelt üzeneteket egy CFrameWnd keretablak delegálja az aktuálisan aktív nézetbe.

• A jelenleg aktív nézet (vagy MDI-keret esetén jelenleg aktív MDI gyermekkeret ablak) meghatározhatja a keretablak feliratát. Ez a funkció letiltható a FWS_ADDTOTITLE keretablak stílusrészletének kikapcsolásával.

• A CFrameWnd keretablak kezeli a vezérlősávok, nézetek és egyéb gyermekablakok elhelyezését a keretablak ügyfélterületén belül. A keretablakok az eszköztár és más vezérlősávgombok tétlen idejű frissítését is elvégzik. A CFrameWnd keretablakok az eszköztáron és az állapotsoron kívülre történő be- és kikapcsoláshoz használt parancsok alapértelmezett implementációit is tartalmazza.

• A CFrameWnd fő menüsávot egy keretablak kezeli. Előugró menü megjelenésekor a keretablak a UPDATE_COMMAND_UI mechanizmus segítségével határozza meg, hogy mely menüelemek legyenek engedélyezve, letiltva vagy bejelölve. Amikor a felhasználó kiválaszt egy menüelemet, a keretablak frissíti az állapotsort a parancs üzenetsztringjével.

• A CFrameWnd keretablakban van egy opcionális gyorsítótábla, amely automatikusan lefordítja a billentyűzetgyorsítókat.

• A CFrameWnd keretablakok opcionális súgóazonosító-készlettel rendelkeznek, amely LoadFrame a környezetfüggő súgóhoz használható. A keretablak a félmodális állapotok fő vezénylője, például a környezetfüggő súgó (SHIFT+F1) és a nyomtatási kép mód.

• A CFrameWnd keretablak megnyit egy fájlt, amely a Fájlkezelőből húzva a keretablakra esett. Ha egy fájlkiterjesztés regisztrálva van, és az alkalmazáshoz van társítva, a keretablak válaszol a dinamikus adatcsere (DDE) nyitott kérésére, amely akkor fordul elő, amikor a felhasználó megnyitja az adatfájlt a Fájlkezelőben vagy a ShellExecute Windows-függvény meghívásakor.

• Ha a keretablak a fő alkalmazásablak (vagyis), amikor a felhasználó bezárja az alkalmazást, a keretablak arra kéri a felhasználót, CWinThread::m_pMainWndhogy mentse a módosított dokumentumokat (és azokat OnCloseOnQueryEndSession).

• Ha a keretablak a fő alkalmazásablak, a keretablak a WinHelp futtatásának környezete. A keretablak bezárása leáll WINHELP.EXE , ha az alkalmazás segítségére lett elindítva.

Ne használja a C++ delete operátort a keretablak elpusztításához. A CWnd::DestroyWindow használható helyette. A CFrameWnd végrehajtás PostNcDestroy törli a C++ objektumot, amikor az ablak megsemmisül. Amikor a felhasználó bezárja a keretablakot, az alapértelmezett OnClose kezelő fog hívni DestroyWindow.

További információ: CFrameWndKeretablakok.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CFrameWnd

Követelmények

fejléc:afxwin.h

CFrameWnd::ActivateFrame

Hívja meg ezt a tagfüggvényt a keretablak aktiválásához és visszaállításához, hogy az látható és elérhető legyen a felhasználó számára.

virtual void ActivateFrame(int nCmdShow = -1);

Paraméterek

nCmdShow
Megadja azt a paramétert, amelybe CWnd::ShowWindowát szeretne adni. Alapértelmezés szerint a keret megjelenik és megfelelően visszaállítható.

Megjegyzések

Ezt a tagfüggvényt általában egy nem felhasználói felületi esemény, például egy DDE, OLE vagy más esemény után hívjuk meg, amely a keretablakot vagy annak tartalmát jelenítheti meg a felhasználó számára.

Az alapértelmezett implementáció aktiválja a keretet, és a Z-rendelés elejére helyezi, és szükség esetén végrehajtja az alkalmazás fő keretablakának lépéseit.

A keret aktiválásának módosításához felülbírálja ezt a tagfüggvényt. Kényszerítheti például, hogy az MDI gyermekablakai teljes méretűek legyenek. Adja hozzá a megfelelő funkciókat, majd hívja meg az alaposztály verzióját explicit nCmdShowmódon.

példa

void CChildFrame::ActivateFrame(int nCmdShow)
{
   // Create the child frame window maximized
   nCmdShow = SW_MAXIMIZE;

   CMDIChildWnd::ActivateFrame(nCmdShow);
}

CFrameWnd::BeginModalState

Ennek a tagfüggvénynek a meghívásával hozzon létre egy keretablak-modálist.

virtual void BeginModalState();

CFrameWnd::CFrameWnd

Objektumot CFrameWnd hoz létre, de nem hozza létre a látható keretablakot.

CFrameWnd();

Megjegyzések

Hívás Create a látható ablak létrehozásához.

CFrameWnd::Create

Hívás az objektumhoz társított Windows-keretablak létrehozásához és inicializálásához CFrameWnd .

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle = WS_OVERLAPPEDWINDOW,
    const RECT& rect = rectDefault,
    CWnd* pParentWnd = NULL,
    LPCTSTR lpszMenuName = NULL,
    DWORD dwExStyle = 0,
    CCreateContext* pContext = NULL);

Paraméterek

lpszClassName
A Windows osztály nevét tartalmazó null értékű karaktersztringre mutat. Az osztálynév lehet a globális függvényben vagy a AfxRegisterWndClassRegisterClass Windows függvényben regisztrált bármely név. Ha NULL, az előre definiált alapértelmezett CFrameWnd attribútumokat használja.

lpszWindowName
Egy null értékű karaktersztringre mutat, amely az ablak nevét jelöli. Szövegként használatos a címsorhoz.

dwStyle
Megadja az ablakstílus attribútumait. Adja meg a FWS_ADDTOTITLE stílust, ha azt szeretné, hogy a címsor automatikusan megjelenítse az ablakban megjelenített dokumentum nevét.

rect
Az ablak méretét és pozícióját határozza meg. Az rectDefault érték lehetővé teszi a Windows számára az új ablak méretének és pozíciójának megadását.

pParentWnd
A keretablak szülőablakát adja meg. Ennek a paraméternek felső szintű keretablakokra kell lennie NULL .

lpszMenuName
Az ablakhoz használandó menüerőforrás nevét azonosítja. Akkor használja MAKEINTRESOURCE , ha a menü sztring helyett egész számazonosítóval rendelkezik. Ez a paraméter lehet NULL.

dwExStyle
Az ablak kiterjesztett stílusattribútumait adja meg.

pContext
Egy struktúra mutatóját CCreateContext adja meg. Ez a paraméter lehet NULL.

Visszaadott érték

Nonzero, ha az inicializálás sikeres; egyéb esetben 0.

Megjegyzések

Hozzon létre egy objektumot CFrameWnd két lépésben. Először hívja meg az objektumot létrehozó CFrameWnd konstruktort, majd hívja meg Create, amely létrehozza a Windows-keretablakot, és csatolja az CFrameWnd objektumhoz. Create Inicializálja az ablak osztálynevét és ablaknevét, és regisztrálja a stílus, a szülő és a kapcsolódó menü alapértelmezett értékeit.

LoadFrame AhelyettCreate, hogy a keretablakot egy erőforrásból töltenél be az argumentumok megadása helyett.

CFrameWnd::CreateView

Hívás CreateView egy kereten belüli nézet létrehozásához.

CWnd* CreateView(
    CCreateContext* pContext,
    UINT nID = AFX_IDW_PANE_FIRST);

Paraméterek

pContext
Meghatározza a nézet és a dokumentum típusát.

nID
A nézet azonosítószáma.

Visszaadott érték

Ha sikeres, mutasson egy CWnd objektumra, ellenkező esetben NULL.

Megjegyzések

Ezzel a tagfüggvényrel olyan "nézeteket" hozhat létre, amelyek nem CViewegy kereten belül származnak. A hívás CreateViewután manuálisan kell beállítania a nézetet aktívra, és láthatónak kell lennie; ezeket a feladatokat a rendszer nem hajtja CreateViewvégre automatikusan.

CFrameWnd::DockControlBar

A vezérlősáv a keretablakhoz van rögzítve.

void DockControlBar(
    CControlBar* pBar,
    UINT nDockBarID = 0,
    LPCRECT lpRect = NULL);

Paraméterek

pBar
A rögzítendő vezérlősávra mutat.

nDockBarID
Meghatározza, hogy a keretablak mely oldalait érdemes figyelembe venni a rögzítéshez. Ez lehet 0 vagy egy vagy több az alábbiak közül:

• AFX_IDW_DOCKBAR_TOP Dokkoljon a keretablak felső oldalára.

• AFX_IDW_DOCKBAR_BOTTOM Dokkoljon a keret ablakának alsó oldalához.

• AFX_IDW_DOCKBAR_LEFT Dokkoljon a keretablak bal oldalára.

• AFX_IDW_DOCKBAR_RIGHT Dokkoljon a keretablak jobb oldalára.

Ha 0, a vezérlősáv bármely olyan oldalra rögzíthető, amely engedélyezve van a célkeretablakban való rögzítéshez.

lpRect
A képernyő koordinátáiban meghatározza, hogy a vezérlősáv hol lesz rögzítve a célkeret ablakának nem megfelelő területén.

Megjegyzések

A vezérlősáv a keretablak egyik oldalához lesz rögzítve, amely a két CControlBar::EnableDocking és CFrameWnd::EnableDockinga . A kiválasztott oldalt a nDockBarID.

CFrameWnd::EnableDocking

A függvény meghívásával engedélyezheti a dokkolható vezérlősávokat egy keretablakban.

void EnableDocking(DWORD dwDockStyle);

Paraméterek

dwDockStyle
Meghatározza, hogy a keretablak mely oldalai szolgálhatnak dokkolóhelyként a vezérlősávokhoz. Az alábbiak közül egy vagy több lehet:

• CBRS_ALIGN_TOP Lehetővé teszi a dokkolást az ügyfélterület tetején.

• CBRS_ALIGN_BOTTOM Lehetővé teszi a dokkolást az ügyfélterület alján.

• CBRS_ALIGN_LEFT Lehetővé teszi a dokkolást az ügyfélterület bal oldalán.

• CBRS_ALIGN_RIGHT Lehetővé teszi a dokkolást az ügyfélterület jobb oldalán.

• CBRS_ALIGN_ANY Lehetővé teszi a dokkolást az ügyfélterület bármely oldalán.

Megjegyzések

Alapértelmezés szerint a vezérlősávok a keretablak egy oldalára lesznek rögzítve a következő sorrendben: felül, alul, balra, jobbra.

példa

Lásd a példát a CToolBar::Create.

CFrameWnd::EndModalState

A tagfüggvény meghívásával módosíthat egy keretablakot modálisról mód nélkülire.

virtual void EndModalState();

Megjegyzések

EndModalState az összes ablak letiltását BeginModalStateteszi lehetővé.

CFrameWnd::FloatControlBar

Hívja meg ezt a függvényt, hogy egy vezérlősáv ne legyen rögzítve a keretablakhoz.

void FloatControlBar(
    CControlBar* pBar,
    CPoint point,
    DWORD dwStyle = CBRS_ALIGN_TOP);

Paraméterek

pBar
A lebegőpontos vezérlősávra mutat.

point
A képernyő koordinátáiban található hely, ahol a vezérlősáv bal felső sarka lesz elhelyezve.

dwStyle
Megadja, hogy a vezérlősávot vízszintesen vagy függőlegesen kell-e igazítani az új keretablakon belül. Az alábbiak bármelyike lehet:

• CBRS_ALIGN_TOP Függőlegesen tájozza a vezérlősávot.

• CBRS_ALIGN_BOTTOM Függőlegesen tájozza a vezérlősávot.

• CBRS_ALIGN_LEFT A vezérlősáv vízszintes tájlása.

• CBRS_ALIGN_RIGHT A vezérlősáv vízszintes tájlása.

Ha a stílusok vízszintes és függőleges tájolást is megadnak, az eszköztár vízszintesen lesz orientált.

Megjegyzések

Ez általában az alkalmazás indításakor történik, amikor a program visszaállítja a beállításokat az előző végrehajtásból.

Ezt a függvényt akkor hívja meg a keretrendszer, ha a felhasználó a bal egérgomb felengedésével ejtési műveletet okoz, miközben a vezérlősávot egy olyan helyre húzza, amely nem érhető el a rögzítéshez.

CFrameWnd::GetActiveDocument

Hívja meg ezt a tagfüggvényt az aktuális aktív nézethez csatolt aktuális CDocument mutató lekéréséhez.

virtual CDocument* GetActiveDocument();

Visszaadott érték

Mutató az aktuálisra CDocument. Ha nincs aktuális dokumentum, a visszaadott NULLértéket adja vissza.

CFrameWnd::GetActiveFrame

Hívja meg ezt a tagfüggvényt, hogy egy MDI-keretablak aktív több dokumentumfelületi (MDI) gyermekablakára mutató mutatót szerezzen be.

virtual CFrameWnd* GetActiveFrame();

Visszaadott érték

Mutató az aktív MDI gyermekablakra. Ha az alkalmazás SDI-alkalmazás, vagy az MDI-keretablakban nincs aktív dokumentum, a rendszer visszaadja az implicit this mutatót.

Megjegyzések

Ha nincs aktív MDI-gyermek, vagy az alkalmazás egyetlen dokumentumfelület (SDI), az implicit this mutató lesz visszaadva.

CFrameWnd::GetActiveView

Hívja meg ezt a tagfüggvényt, hogy a keretablakhoz (ha van) csatolt aktív nézetre mutató mutatót szerezzen be.CFrameWnd

CView* GetActiveView() const;

Visszaadott érték

Mutató az aktuálisra CView. Ha nincs aktuális nézet, akkor a visszaadott NULLérték.

Megjegyzések

Ez a függvény MDI főkeretablak (NULL) meghívása esetén ad vissza.CMDIFrameWnd Egy MDI-alkalmazásban az MDI főkeretablaka nem rendelkezik hozzá társított nézettel. Ehelyett minden egyes gyermekablak (CMDIChildWnd) egy vagy több társított nézetet használ. Az MDI-alkalmazások aktív nézete az aktív MDI gyermekablak megkeresésével, majd az adott gyermekablak aktív nézetének megkeresésével szerezhető be. Az aktív MDI gyermekablak a függvény MDIGetActive meghívásával vagy GetActiveFrame az alábbi módon érhető el:

CMDIFrameWnd *pFrame = (CMDIFrameWnd*)AfxGetApp()->GetMainWnd();

// Get the active MDI child window.
CMDIChildWnd *pChild = (CMDIChildWnd*)pFrame->GetActiveFrame();

// or CMDIChildWnd *pChild = pFrame->MDIGetActive();

// Get the active view attached to the active MDI child window.
CMyView *pView = (CMyView*)pChild->GetActiveView();

CFrameWnd::GetControlBar

Hívás GetControlBar az azonosítóhoz társított vezérlősávhoz való hozzáférés megszerzéséhez.

CControlBar* GetControlBar(UINT nID);

Paraméterek

nID
Egy vezérlősáv azonosítószáma.

Visszaadott érték

Az azonosítóhoz társított vezérlősávra mutató mutató.

Megjegyzések

A nID paraméter a vezérlősáv metódusának átadott Create egyedi azonosítóra hivatkozik. A vezérlősávokkal kapcsolatos további információkért tekintse meg a Vezérlősávok című témakört.

GetControlBar akkor is visszaadja a vezérlősávot, ha az lebegő, és így jelenleg nem a keret gyermekablaka.

CFrameWnd::GetDockState

Ennek a tagfüggvénynek a meghívásával a keretablak vezérlősávjaival kapcsolatos állapotinformációkat tárolhatja egy CDockState objektumban.

void GetDockState(CDockState& state) const;

Paraméterek

state
A keretablak vezérlősávjainak aktuális állapotát tartalmazza visszatéréskor.

Megjegyzések

Ezután megírhatja a tartalmát CDockState a tárolóba a vagy CDockState::SaveStatea Serialize . Ha később vissza szeretné állítani a vezérlősávokat egy korábbi állapotba, töltse be az állapotot CDockState::LoadState a vagy Serialize, majd hívja meg SetDockState , hogy alkalmazza az előző állapotot a keretablak vezérlősávjaira.

CFrameWnd::GetMenuBarState

Lekéri a menü megjelenítési állapotát az aktuális MFC-alkalmazásban.

virtual DWORD GetMenuBarState();

Visszaadott érték

A visszatérési érték a következő értékekkel rendelkezhet:

• AFX_MBS_VISIBLE (0x01) – A menü látható.

• AFX_MBS_HIDDEN (0x02) – A menü rejtett.

Megjegyzések

Futásidejű hiba esetén ez a módszer hibakeresési módban érvényes, és kivételt hoz létre az CException osztályból.

CFrameWnd::GetMenuBarVisibility

Azt jelzi, hogy az aktuális MFC-alkalmazásban a menü alapértelmezett állapota rejtett vagy látható-e.

virtual DWORD CFrameWnd::GetMenuBarVisibility();

Visszaadott érték

Ez a metódus az alábbi értékek egyikét adja vissza:

• AFX_MBV_KEEPVISIBLE (0x01) – A menü mindig megjelenik, és alapértelmezés szerint nincs fókuszban.

• AFX_MBV_DISPLAYONFOCUS (0x02) – A menü alapértelmezés szerint rejtett. Ha a menü rejtett, nyomja le az ALT billentyűt a menü megjelenítéséhez és a fókusz megjelenítéséhez. Ha megjelenik a menü, az ALT vagy az ESC billentyűvel rejtse el.

• AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) – A menü alapértelmezés szerint rejtett. Ha a menü rejtett, nyomja le az F10 billentyűt a menü megjelenítéséhez és a fókusz megjelenítéséhez. Ha megjelenik a menü, nyomja le az F10 billentyűt a fókusz be- vagy kikapcsolásához. A menü addig jelenik meg, amíg el nem rejti az ALT vagy az ESC billentyűt.

Megjegyzések

Futásidejű hiba esetén ez a módszer hibakeresési módban érvényes, és kivételt hoz létre az CException osztályból.

CFrameWnd::GetMessageBar

Hívja meg ezt a tagfüggvényt, hogy az állapotsorra mutató mutatót kapjon.

virtual CWnd* GetMessageBar();

Visszaadott érték

Mutasson az állapotsor ablakára.

CFrameWnd::GetMessageString

A függvény felülbírálása a parancsazonosítók egyéni sztringjeinek megadásához.

virtual void GetMessageString(
    UINT nID,
    CString& rMessage) const;

Paraméterek

nID
A kívánt üzenet erőforrás-azonosítója.

rMessage
CString objektumot, amelybe az üzenetet helyezni szeretné.

Megjegyzések

Az alapértelmezett implementáció egyszerűen betölti az erőforrásfájlból megadott sztringet nID . Ezt a függvényt a keretrendszer hívja meg, amikor az állapotsor üzenetsztringje frissítésre szorul.

CFrameWnd::GetTitle

Lekéri az ablakobjektum címét.

CString GetTitle() const;

Visszaadott érték

Az CString ablakobjektum aktuális címét tartalmazó objektum.

CFrameWnd::InitialUpdateFrame

Hívás IntitialUpdateFrame egy új keret létrehozása után a .Create

void InitialUpdateFrame(
    CDocument* pDoc,
    BOOL bMakeVisible);

Paraméterek

pDoc
Arra a dokumentumra mutat, amelyhez a keretablak társítva van. Lehet NULL.

bMakeVisible
Ha TRUE, azt jelzi, hogy a keretnek láthatóvá és aktívvá kell válnia. Ha FALSEa rendszer nem teszi láthatóvá a leszármazottakat.

Megjegyzések

Ez azt eredményezi, hogy a keretablak összes nézete fogadja a hívásokat OnInitialUpdate .

Ha korábban nem volt aktív nézet, a keretablak elsődleges nézete aktívvá lesz. Az elsődleges nézet egy olyan nézet, amelynek gyermekazonosítója a következő AFX_IDW_PANE_FIRST: . Végül a keretablak láthatóvá válik, ha bMakeVisible nem ero. Ha bMakeVisible 0, a keretablak aktuális fókusza és látható állapota változatlan marad. Nem szükséges meghívni ezt a függvényt, ha a keretrendszer Új fájl és Fájlmegnyitás implementációját használja.

CFrameWnd::InModalState

Hívja meg ezt a tagfüggvényt annak ellenőrzéséhez, hogy egy keretablak modális vagy mód nélküli-e.

BOOL InModalState() const;

Visszaadott érték

Nonzero, ha igen; egyéb esetben 0.

CFrameWnd::IsTracking

Hívja meg ezt a tagfüggvényt annak megállapításához, hogy az ablak elválasztó sávja jelenleg áthelyezve van-e.

BOOL IsTracking() const;

Visszaadott érték

Nemzero, ha egy felosztóművelet folyamatban van; egyéb esetben 0.

CFrameWnd::LoadAccelTable

Hívás a megadott gyorsítótábla betöltésére.

BOOL LoadAccelTable(LPCTSTR lpszResourceName);

Paraméterek

lpszResourceName
Azonosítja a gázpedál erőforrásának nevét. Akkor használja MAKEINTRESOURCE , ha az erőforrás egész számazonosítóval van azonosítva.

Visszaadott érték

Nonzero, ha a gázpedáltábla betöltése sikeresen megtörtént; egyéb esetben 0.

Megjegyzések

Egyszerre csak egy tábla tölthető be.

Az erőforrásokból betöltött gyorsítótáblák automatikusan felszabadulnak az alkalmazás leállásakor.

Ha meghívja LoadFrame a keretablak létrehozását, a keretrendszer betölt egy gyorsítótáblát a menüvel és az ikonerőforrásokkal együtt, és a tagfüggvény későbbi hívása szükségtelen.

CFrameWnd::LoadBarState

Hívja meg ezt a függvényt, hogy visszaállítsa a keretablakhoz tartozó vezérlősávok beállításait.

void LoadBarState(LPCTSTR lpszProfileName);

Paraméterek

lpszProfileName
Az inicializálási (INI) fájl egy szakaszának vagy a Windows beállításjegyzékben található kulcsnak a neve, ahol az állapotinformációk tárolása történik.

Megjegyzések

A visszaállított információk közé tartozik a láthatóság, a vízszintes/függőleges tájolás, a dokkolási állapot és a vezérlősáv helyzete.

A visszaállítani kívánt beállításokat a hívás LoadBarStateelőtt meg kell írni a beállításjegyzékbe. Írja be az adatokat a beállításjegyzékbe hívással CWinApp::SetRegistryKey. Írja be az adatokat az INI-fájlba hívással SaveBarState.

CFrameWnd::LoadFrame

Hívás, hogy dinamikusan hozzon létre egy keretablakot az erőforrás-információkból.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Paraméterek

nIDResource
A keretablakhoz társított megosztott erőforrások azonosítója.

dwDefaultStyle
A keret stílusa. Adja meg a FWS_ADDTOTITLE stílust, ha azt szeretné, hogy a címsor automatikusan megjelenítse az ablakban megjelenített dokumentum nevét.

pParentWnd
A keret szülőjének mutatója.

pContext
Egy struktúra mutatója CCreateContext . Ez a paraméter lehet NULL.

Megjegyzések

Hozzon létre egy objektumot CFrameWnd két lépésben. Először hívja meg az objektumot alkotó CFrameWnd konstruktort, majd hívja meg LoadFrameazt, amely betölti a Windows keretablakát és a hozzá tartozó erőforrásokat, és csatolja a keretablakot az CFrameWnd objektumhoz. A nIDResource paraméter megadja a menüt, a gyorsítótáblát, az ikont és a keretablak címének sztringerőforrását.

Használja a Create tagfüggvényt LoadFrame ahelyett, hogy meg szeretné adni a keretablak összes létrehozási paraméterét.

A keretrendszer meghívja LoadFrame , ha egy dokumentumsablon-objektummal hoz létre keretablakot.

A keretrendszer az pContext argumentum használatával adja meg a keretablakhoz csatlakoztatni kívánt objektumokat, beleértve a tartalmazott nézetobjektumokat is. Az argumentumot pContext a híváskor NULLállíthatja beLoadFrame.

CFrameWnd::m_bAutoMenuEnable

Ha ez az adattag engedélyezve van (ez az alapértelmezett), a nem rendelkező ON_UPDATE_COMMAND_UI vagy ON_COMMAND kezelők által nem rendelkező menüelemek automatikusan le lesznek tiltva, amikor a felhasználó lekéri a menüt.

BOOL m_bAutoMenuEnable;

Megjegyzések

A kezelőt ON_COMMANDON_UPDATE_COMMAND_UI nem tartalmazó menüelemek automatikusan engedélyezve lesznek.

Ha ez az adattag be van állítva, a menüelemek automatikusan ugyanúgy lesznek engedélyezve, mint az eszköztárgombok.

Megjegyzés:

m_bAutoMenuEnable nincs hatása a felső szintű menüelemekre.

Ez az adattag leegyszerűsíti az opcionális parancsok végrehajtását az aktuális kijelölés alapján, és csökkenti a kezelők írásának ON_UPDATE_COMMAND_UI szükségességét a menüelemek engedélyezéséhez és letiltásához.

példa

// CMainFrame is application-defined object of type CFrameWnd
CMainFrame::CMainFrame()
    : m_hDrawMenu(NULL), m_hDrawAccel(NULL), m_bCheck(false), m_nWindowTimer(0), m_nCallbackTimer(0)
{
   // Set to FALSE so no ON_UPDATE_COMMAND_UI
   // or ON_COMMAND handlers are needed, and
   // CMenu::EnableMenuItem() will work as expected.
   m_bAutoMenuEnable = FALSE;
}

CFrameWnd::NegotiateBorderSpace

Ennek a tagfüggvénynek a meghívásával egyeztethet szegélyterületet egy keretablakban az OLE-hely aktiválása során.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Paraméterek

nBorderCmd
A következő értékek egyikét tartalmazza a enum BorderCmdkövetkezőből:

• borderGet = 1

• borderRequest = 2

• borderSet = 3

lpRectBorder
Mutasson egy RECT szerkezetre vagy egy CRect objektumra, amely megadja a szegély koordinátáit.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény az CFrameWnd OLE határtér-egyeztetés megvalósítása.

CFrameWnd::OnBarCheck

Akkor hívható meg, ha a megadott vezérlősávon műveletet hajtanak végre.

afx_msg BOOL OnBarCheck(UINT nID);

Paraméterek

nID
A megjelenő vezérlősáv azonosítója.

Visszaadott érték

Nemzero, ha a vezérlősáv létezik; egyéb esetben 0.

CFrameWnd::OnContextHelp

Kezeli a SHIFT+F1 súgót a helyben lévő elemekhez.

afx_msg void OnContextHelp();

Megjegyzések

A környezetfüggő súgó engedélyezéséhez fel kell vennie egy

ON_COMMAND(ID_CONTEXT_HELP, &CMainFrame::OnContextHelp)

utasítást az CFrameWnd osztály üzenettérképére, és a tagfüggvény engedélyezéséhez adjon hozzá egy, általában SHIFT+F1 billentyűkombinációt tartalmazó gyorsítótábla-bejegyzést is.

Ha az alkalmazás OLE-tároló, OnContextHelp a keretablak-objektumban található összes helyben lévő elemet súgó módban helyezi el. A kurzor egy nyílra és egy kérdőjelre változik, a felhasználó ezután áthelyezheti az egérmutatót, és a bal egérgombbal kijelölhet egy párbeszédpanelt, ablakot, menüt vagy parancsgombot. Ez a tagfüggvény meghívja a Windows függvényt WinHelp a kurzor alatti objektum súgókörnyezetével.

CFrameWnd::OnCreateClient

A keretrendszer meghívta a végrehajtás OnCreatesorán.

virtual BOOL OnCreateClient(
    LPCREATESTRUCT lpcs,
    CCreateContext* pContext);

Paraméterek

lpcs
Egy Windows-struktúra CREATESTRUCT mutatója.

pContext
Egy struktúra mutatója CCreateContext .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Soha ne hívja ezt a függvényt.

A függvény alapértelmezett implementációja létrehoz egy CView objektumot a megadott pContextinformációkból, ha lehetséges.

Felülbírálja ezt a függvényt az CCreateContext objektumban átadott értékek felülbírálása vagy a keretablak fő ügyfélterületének vezérlőinek létrehozásának módosítása érdekében. A CCreateContext felülbírálható tagokat az CCreateContext osztály ismerteti.

Megjegyzés:

Ne cserélje le a CREATESTRUCT struktúrában átadott értékeket. Ezek csak tájékoztató jellegűek. Ha például felül szeretné bírálni a kezdeti ablak téglalapját, írja felül a tagfüggvényt CWndPreCreateWindow.

CFrameWnd::OnHideMenuBar

Ezt a függvényt akkor hívja meg a rendszer, amikor a rendszer el szeretné rejteni a menüsávot az aktuális MFC-alkalmazásban.

virtual void OnHideMenuBar();

Megjegyzések

Ez az eseménykezelő lehetővé teszi, hogy az alkalmazás egyéni műveleteket hajt végre, amikor a rendszer el szeretné rejteni a menüt. Nem akadályozhatja meg a menü elrejtését, de meghívhat más metódusokat is a menü stílusának vagy állapotának lekéréséhez.

CFrameWnd::OnSetPreviewMode

Ennek a tagfüggvénynek a meghívásával állítsa be az alkalmazás fő keretablakát nyomtatási-előnézeti módba és azon kívülre.

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

Paraméterek

bPreview
Megadja, hogy az alkalmazás nyomtatási kép módban legyen-e elhelyezve. Állítsa be a TRUE nyomtatási képre, FALSE hogy megszakítsa az előnézeti módot.

pState
Egy struktúra mutatója CPrintPreviewState .

Megjegyzések

Az alapértelmezett implementáció letiltja az összes szabványos eszköztárat, és elrejti a főmenüt és a fő ügyfélablakot. Ez az MDI-keretablakokat ideiglenes SDI-keretablakokká alakítja.

A tagfüggvény felülbírálása a vezérlősávok és más keretablakrészek elrejtésének és megjelenítésének testreszabásához a nyomtatási kép megtekintése során. Hívja meg az alaposztály implementációt a felülírt verzióból.

CFrameWnd::OnShowMenuBar

Ezt a függvényt akkor hívja meg a rendszer, amikor a rendszer az aktuális MFC-alkalmazásban meg szeretné jeleníteni a menüsávot.

virtual void OnShowMenuBar();

Megjegyzések

Ez az eseménykezelő lehetővé teszi, hogy az alkalmazás egyéni műveleteket hajt végre, amikor a menü megjelenik. Nem akadályozhatja meg a menü megjelenítését, de meghívhat például más metódusokat a menü stílusának vagy állapotának lekéréséhez.

CFrameWnd::OnUpdateControlBarMenu

A keretrendszer meghívta a társított menü frissítésekor.

afx_msg void OnUpdateControlBarMenu(CCmdUI* pCmdUI);

Paraméterek

pCmdUI
A frissítési parancsot létrehozó menüt képviselő objektumra mutató mutató CCmdUI . A frissítéskezelő meghívja az Enable objektum CCmdUI tagfüggvényét a pCmdUI felhasználói felület frissítéséhez.

CFrameWnd::RecalcLayout

A keretrendszer meghívja, amikor a standard vezérlősávok be- vagy kikapcsolódnak, vagy amikor a keretablak átméreteződik.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Paraméterek

bNotify
Meghatározza, hogy a keretablak aktív helyszíni eleme értesítést kap-e az elrendezés módosításáról. Ha TRUEa rendszer értesíti az elemet, ellenkező esetben FALSE.

Megjegyzések

A tagfüggvény alapértelmezett implementációja meghívja a tagfüggvényt CWnd az RepositionBars összes vezérlősáv áthelyezésére a keretben és a fő ügyfélablakban (általában a CView vagy MDICLIENT).

Felülbírálja ezt a tagfüggvényt a vezérlősávok megjelenésének és viselkedésének szabályozásához a keretablak elrendezésének módosítása után. Hívja meg például, ha be- vagy kikapcsolja a vezérlősávokat, vagy egy másik vezérlősávot ad hozzá.

CFrameWnd::rectDefault

Adja meg ezt a statikus CRect paramétert egy ablak létrehozásakor, hogy a Windows kiválaszthassa az ablak kezdeti méretét és pozícióját.

static AFX_DATA const CRect rectDefault;

CFrameWnd::SaveBarState

Hívja meg ezt a függvényt a keretablak tulajdonában lévő vezérlősávok adatainak tárolásához.

void SaveBarState(LPCTSTR lpszProfileName) const;

Paraméterek

lpszProfileName
Az inicializálási fájl egy szakaszának vagy egy kulcsnak a neve a Windows beállításjegyzékben, ahol az állapotinformációk tárolása történik.

Megjegyzések

Ezek az információk az inicializálási fájlból olvashatók a következő használatával LoadBarState: . A tárolt információk közé tartozik a láthatóság, a vízszintes/függőleges tájolás, a dokkolási állapot és a vezérlősáv helyzete.

CFrameWnd::SetActivePreviewView

A megadott nézetet a Rich Preview aktív nézetének jelöli ki.

void SetActivePreviewView(CView* pViewNew);

Paraméterek

pViewNew
Az aktiválandó nézetre mutató mutató.

Megjegyzések

CFrameWnd::SetActiveView

Hívja meg ezt a tagfüggvényt az aktív nézet beállításához.

void SetActiveView(
    CView* pViewNew,
    BOOL bNotify = TRUE);

Paraméterek

pViewNew
Egy objektumra CView mutató mutatót ad meg, vagy NULL nincs aktív nézet.

bNotify
Megadja, hogy a nézet értesítést kapjon-e az aktiválásról. Ha TRUEa rendszer OnActivateView meghívja az új nézetet, ha FALSEnem.

Megjegyzések

A keretrendszer automatikusan meghívja ezt a függvényt, mivel a felhasználó a fókuszt egy nézetre módosítja a keretablakban. A fókusz a megadott nézetre való módosításához hívható SetActiveView meg explicit módon.

CFrameWnd::SetDockState

Hívja meg ezt a tagfüggvényt CDockState , hogy az objektumban tárolt állapotadatokat alkalmazza a keretablak vezérlősávjaira.

void SetDockState(const CDockState& state);

Paraméterek

state
Alkalmazza a tárolt állapotot a keretablak vezérlősávjaira.

Megjegyzések

A vezérlősávok egy korábbi állapotának visszaállításához betöltheti a tárolt állapotot CDockState::LoadState a keretablak vezérlősávjaira való alkalmazáshoz, vagy SerializeSetDockState a használatával. A rendszer az előző állapotot a következő objektumban tárolja:CDockStateGetDockState

CFrameWnd::SetMenuBarState

Az aktuális MFC-alkalmazásban a menü megjelenítési állapotát rejtettre vagy megjeleníthetőre állítja.

virtual BOOL SetMenuBarState(DWORD nState);

Paraméterek

nState
[in] Megadja, hogy megjelenjen vagy elrejtse-e a menüt. A nState paraméter a következő értékekkel rendelkezhet:

• AFX_MBS_VISIBLE (0x01) – Megjeleníti a menüt, ha rejtett, de nincs hatása, ha látható.
• AFX_MBS_HIDDEN (0x02) – Elrejti a menüt, ha látható, de nincs hatása, ha rejtett.

Visszaadott érték

TRUEha ez a módszer sikeresen módosítja a menü állapotát; egyéb esetben. FALSE

Megjegyzések

Futásidejű hiba esetén ez a módszer hibakeresési módban érvényes, és kivételt hoz létre az CException osztályból.

CFrameWnd::SetMenuBarVisibility

Az aktuális MFC-alkalmazásban a menü alapértelmezett viselkedését rejtettnek vagy láthatónak állítja be.

virtual void SetMenuBarVisibility(DWORD nStyle);

Paraméterek

nStyle
[in] Megadja, hogy a menü alapértelmezés szerint rejtett-e, vagy látható- e, és fókuszban van-e. A nStyle paraméter a következő értékekkel rendelkezhet:

• AFX_MBV_KEEPVISIBLE (0x01) – A menü mindig megjelenik, és alapértelmezés szerint nincs fókuszban.

• AFX_MBV_DISPLAYONFOCUS (0x02) – A menü alapértelmezés szerint rejtett. Ha a menü rejtett, nyomja le az ALT billentyűt a menü megjelenítéséhez és a fókusz megjelenítéséhez. Ha megjelenik a menü, a menü elrejtéséhez nyomja le az ALT vagy az ESC billentyűt.

• AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) – A menü alapértelmezés szerint rejtett. Ha a menü rejtett, nyomja le az F10 billentyűt a menü megjelenítéséhez és a fókusz megjelenítéséhez. Ha megjelenik a menü, nyomja le az F10 billentyűt a fókusz be- vagy kikapcsolásához. A menü addig jelenik meg, amíg el nem rejti az ALT vagy az ESC billentyűt.

Megjegyzések

Ha a paraméter értéke érvénytelen, ez a nStyle módszer hibakeresési módban érvényes, és kiadási módban emel CInvalidArgException . Egyéb futásidejű hibák esetén ez a módszer hibakeresési módban érvényes, és kivételt okoz az CException osztályból.

Ez a módszer hatással van a Windows Vista és újabb verziókhoz írt alkalmazások menüinek állapotára.

CFrameWnd::SetMessageText

A függvény meghívásával helyezzen el egy sztringet a 0 azonosítójú állapotsor panelen.

void SetMessageText(LPCTSTR lpszText);
void SetMessageText(UINT nID);

Paraméterek

lpszText
Az állapotsoron elhelyezendő sztringre mutat.

nID
Az állapotsoron elhelyezni kívánt sztring erőforrás-azonosítója.

Megjegyzések

Ez általában az állapotsor bal szélső és leghosszabb panelje.

CFrameWnd::SetProgressBarPosition

Beállítja a tálcán megjelenített Windows 7 folyamatjelző sáv aktuális pozícióját.

void SetProgressBarPosition(int nProgressPos);

Paraméterek

nProgressPos
Megadja a beállítani kívánt pozíciót. Az értéknek a megadott SetProgressBarRangetartományon belül kell lennie.

Megjegyzések

CFrameWnd::SetProgressBarRange

Beállítja a tálcán megjelenített Windows 7 folyamatjelző sáv tartományát.

void SetProgressBarRange(
    int nRangeMin,
    int nRangeMax);

Paraméterek

nRangeMin
Minimális érték.

nRangeMax
Maximális érték.

Megjegyzések

CFrameWnd::SetProgressBarState

Beállítja a tálcán megjelenő állapotjelző típusát és állapotát.

void SetProgressBarState(TBPFLAG tbpFlags);

Paraméterek

tbpFlags
Az állapotjelző gomb aktuális állapotát vezérlő jelzők. Csak az alábbi jelölők egyikét adja meg, mert minden állam kölcsönösen kizáró: , , , , TBPF_NOPROGRESSTBPF_INDETERMINATE. TBPF_NORMALTBPF_ERRORTBPF_PAUSED

Megjegyzések

CFrameWnd::SetTaskbarOverlayIcon

Túlterhelt. Átfedést alkalmaz egy tálcagombra az alkalmazás állapotának jelzéséhez vagy a felhasználó értesítéséhez.

BOOL SetTaskbarOverlayIcon(
    UINT nIDResource,
    LPCTSTR lpcszDescr);

BOOL SetTaskbarOverlayIcon(
    HICON hIcon,
    LPCTSTR lpcszDescr);

Paraméterek

nIDResource
Megadja az átfedésként használni kívánt ikon erőforrás-azonosítóját. A részletekért tekintse meg a hIcon leírást.

lpcszDescr
Mutató egy sztringre, amely az átfedés által közvetített információk helyettesítő szöveges verzióját biztosítja akadálymentességi okokból.

hIcon
Az átfedésként használandó ikon fogópontja. Ennek egy kis ikonnak kell lennie, amely 16x16 képpontot mér 96 pont/hüvelyk (dpi) értéken. Ha már alkalmaz egy átfedésikont a tálca gombjára, a meglévő átfedés lecserélődik. Ez az érték lehet NULL. Az NULL érték kezelése attól függ, hogy a tálca gomb egyetlen ablakot vagy ablakcsoportot jelöl-e. A hívó alkalmazás felelőssége, hogy felszabadítsa hIcon , ha már nincs rá szükség.

Visszaadott érték

TRUE ha sikeres; FALSE ha az operációs rendszer verziója kisebb, mint a Windows 7, vagy ha hiba történik az ikon beállításakor.

Megjegyzések

CFrameWnd::SetTitle

Beállítja az ablakobjektum címét.

void SetTitle(LPCTSTR lpszTitle);

Paraméterek

lpszTitle
Az ablakobjektum címét tartalmazó karaktersztringre mutató mutató.

CFrameWnd::ShowControlBar

A vezérlősáv megjelenítéséhez vagy elrejtéséhez hívja meg ezt a tagfüggvényt.

void ShowControlBar(
    CControlBar* pBar,
    BOOL bShow,
    BOOL bDelay);

Paraméterek

pBar
Mutasson a megjelenítendő vagy rejtett vezérlősávra.

bShow
Ha TRUE, akkor a vezérlősávot kell megjeleníteni. Ha FALSE, akkor azt adja meg, hogy a vezérlősáv rejtve legyen.

bDelay
Ha TRUE, késlelteti a vezérlősáv megjelenítését. Ha FALSE, azonnal jelenítse meg a vezérlősávot.

CFrameWnd::ShowOwnedWindows

Hívja meg ezt a tagfüggvényt az objektum leszármazottainak összes ablakának CFrameWnd megjelenítéséhez.

void ShowOwnedWindows(BOOL bShow);

Paraméterek

bShow
Megadja, hogy a saját ablakok megjelenjenek vagy rejtve legyenek.

Lásd még

CWnd osztály
hierarchiadiagram
CWnd osztály
CMDIFrameWnd osztály
CMDIChildWnd osztály
CView osztály
CDocTemplate osztály
CRuntimeClass Szerkezet