CFrameWnd Klasa

Udostępnia funkcje jednokrotnego interfejsu dokumentu systemu Windows (SDI) nakładających się lub wyskakujących okienek wraz z elementami członkowskimi do zarządzania oknem.

Składnia

class CFrameWnd : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CFrameWnd::CFrameWnd	CFrameWnd Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CFrameWnd::ActivateFrame	Sprawia, że ramka jest widoczna i dostępna dla użytkownika.
CFrameWnd::BeginModalState	Ustawia okno ramki na modalne.
CFrameWnd::Create	Wywołaj metodę , aby utworzyć i zainicjować okno ramki systemu Windows skojarzone z obiektem CFrameWnd .
CFrameWnd::CreateView	Tworzy widok w ramce, która nie pochodzi z CViewelementu .
CFrameWnd::DockControlBar	Zadokuje pasek sterowania.
CFrameWnd::EnableDocking	Umożliwia zadokowanie paska sterowania.
CFrameWnd::EndModalState	Kończy stan modalny okna ramowego. Włącza wszystkie okna wyłączone przez BeginModalState.
CFrameWnd::FloatControlBar	Unosi pasek sterowania.
CFrameWnd::GetActiveDocument	Zwraca aktywny CDocument obiekt.
CFrameWnd::GetActiveFrame	Zwraca aktywny CFrameWnd obiekt.
CFrameWnd::GetActiveView	Zwraca aktywny CView obiekt.
CFrameWnd::GetControlBar	Pobiera pasek sterowania.
CFrameWnd::GetDockState	Pobiera stan dokowania okna ramowego.
CFrameWnd::GetMenuBarState	Pobiera stan wyświetlania menu w bieżącej aplikacji MFC.
CFrameWnd::GetMenuBarVisibility	Wskazuje, czy domyślne zachowanie menu w bieżącej aplikacji MFC jest ukryte lub widoczne.
CFrameWnd::GetMessageBar	Zwraca wskaźnik do paska stanu należącego do okna ramki.
CFrameWnd::GetMessageString	Pobiera komunikat odpowiadający identyfikatorowi polecenia.
CFrameWnd::GetTitle	Pobiera tytuł powiązanego paska sterowania.
CFrameWnd::InitialUpdateFrame	Powoduje wywołanie funkcji składowej OnInitialUpdate należącej do wszystkich widoków w oknie ramowym.
CFrameWnd::InModalState	Zwraca wartość wskazującą, czy okno ramki jest w stanie modalnym.
CFrameWnd::IsTracking	Określa, czy pasek podziału jest obecnie przenoszony.
CFrameWnd::LoadAccelTable	Wywołaj metodę ładowania tabeli akceleratora.
CFrameWnd::LoadBarState	Wywołaj metodę , aby przywrócić ustawienia paska sterowania.
CFrameWnd::LoadFrame	Wywołaj polecenie , aby dynamicznie utworzyć okno ramki na podstawie informacji o zasobie.
CFrameWnd::NegotiateBorderSpace	Negocjuje przestrzeń graniczną w oknie ramowym.
CFrameWnd::OnBarCheck	Wywoływana za każdym razem, gdy akcja jest wykonywana na określonym pasku sterowania.
CFrameWnd::OnContextHelp	Obsługuje pomoc SHIFT+F1 dla elementów w miejscu.
CFrameWnd::OnSetPreviewMode	Ustawia główne okno ramki aplikacji w tryb podglądu wydruku i poza nie.
CFrameWnd::OnUpdateControlBarMenu	Wywoływana przez platformę po zaktualizowaniu skojarzonego menu.
CFrameWnd::RecalcLayout	Zmienia położenie pasków kontrolek CFrameWnd obiektu.
CFrameWnd::SaveBarState	Wywołaj metodę zapisywania ustawień paska sterowania.
CFrameWnd::SetActivePreviewView	Wyznacza określony widok jako aktywny widok dla zaawansowanej wersji zapoznawczej.
CFrameWnd::SetActiveView	Ustawia aktywny CView obiekt.
CFrameWnd::SetDockState	Wywołaj polecenie , aby zadokować okno ramki w oknie głównym.
CFrameWnd::SetMenuBarState	Ustawia stan wyświetlania menu w bieżącej aplikacji MFC na ukryte lub wyświetlane.
CFrameWnd::SetMenuBarVisibility	Ustawia domyślne zachowanie menu w bieżącej aplikacji MFC jako ukryte lub widoczne.
CFrameWnd::SetMessageText	Ustawia tekst standardowego paska stanu.
CFrameWnd::SetProgressBarPosition	Ustawia bieżące położenie paska postępu systemu Windows 7 wyświetlanego na pasku zadań.
CFrameWnd::SetProgressBarRange	Ustawia zakres paska postępu systemu Windows 7 wyświetlany na pasku zadań.
CFrameWnd::SetProgressBarState	Ustawia typ i stan wskaźnika postępu wyświetlanego na przycisku paska zadań.
CFrameWnd::SetTaskbarOverlayIcon	Przeciążone. Stosuje nakładkę do przycisku paska zadań, aby wskazać stan aplikacji lub powiadomienie użytkownikowi.
CFrameWnd::SetTitle	Ustawia tytuł powiązanego paska sterowania.
CFrameWnd::ShowControlBar	Wywołaj polecenie , aby wyświetlić pasek sterowania.
CFrameWnd::ShowOwnedWindows	Przedstawia wszystkie okna, które są elementami podrzędnymi CFrameWnd obiektu.

Metody chronione

Nazwa/nazwisko	opis
CFrameWnd::OnCreateClient	Tworzy okno klienta dla ramki.
CFrameWnd::OnHideMenuBar	Wywołana przed menu w bieżącej aplikacji MFC jest ukryta.
CFrameWnd::OnShowMenuBar	Wywołana przed wyświetleniem menu w bieżącej aplikacji MFC.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
CFrameWnd::m_bAutoMenuEnable	Steruje automatyczną funkcją włączania i wyłączania elementów menu.
CFrameWnd::rectDefault	Przekaż ten statyczny CRect jako parametr podczas tworzenia CFrameWnd obiektu, aby umożliwić systemowi Windows wybranie początkowego rozmiaru i położenia okna.

Uwagi

Aby utworzyć przydatne okno ramki dla aplikacji, utwórz klasę z klasy CFrameWnd. Dodaj zmienne składowe do klasy pochodnej, aby przechowywać dane specyficzne dla aplikacji. Zaimplementuj funkcje składowe programu obsługi komunikatów i mapę komunikatów w klasie pochodnej, aby określić, co się stanie, gdy komunikaty są kierowane do okna.

Istnieją trzy sposoby konstruowania okna ramowego:

• Bezpośrednio skonstruuj go przy użyciu polecenia Create.

• Bezpośrednio skonstruuj go przy użyciu polecenia LoadFrame.

• Pośrednio skonstruuj go przy użyciu szablonu dokumentu.

Przed wywołaniem Create metody lub LoadFramenależy skonstruować obiekt okna ramowego na stercie przy użyciu operatora C++ new . Przed wywołaniem Createmetody można również zarejestrować klasę okien za pomocą funkcji globalnej AfxRegisterWndClass , aby ustawić ikonę i style klas dla ramki.

Użyj funkcji składowej Create , aby przekazać parametry tworzenia ramki jako argumenty natychmiastowe.

LoadFrame wymaga mniejszej liczby argumentów niż Create, a zamiast tego pobiera większość wartości domyślnych z zasobów, w tym podpis ramki, ikonę, tabelę akceleratora i menu. Aby były dostępne przez LoadFrameprogram , wszystkie te zasoby muszą mieć ten sam identyfikator zasobu (na przykład IDR_MAINFRAME).

CFrameWnd Gdy obiekt zawiera widoki i dokumenty, są one tworzone pośrednio przez strukturę zamiast bezpośrednio przez programistę. Obiekt CDocTemplate organizuje tworzenie ramki, tworzenie zawierających widoki oraz połączenie widoków z odpowiednim dokumentem. Parametry konstruktora CDocTemplate określają CRuntimeClass trzy zaangażowane klasy (dokument, ramka i widok). CRuntimeClass Obiekt jest używany przez platformę do dynamicznego tworzenia nowych ramek po określeniu przez użytkownika (na przykład za pomocą polecenia File New lub wielu interfejsu dokumentu (MDI) Okno Nowe polecenie.

Aby powyższy RUNTIME_CLASS mechanizm działał prawidłowo, należy zadeklarować klasę okna ramowego pochodzącą z CFrameWnd DECLARE_DYNCREATE klasy .

Element CFrameWnd zawiera domyślne implementacje do wykonywania następujących funkcji okna głównego w typowej aplikacji dla systemu Windows:

• Okno CFrameWnd ramki śledzi aktualnie aktywny widok, który jest niezależny od aktywnego okna systemu Windows lub bieżącego fokusu wejściowego. Po ponownym uaktywnieniu ramki aktywny widok jest powiadamiany przez wywołanie metody CView::OnActivateView.

• Komunikaty poleceń i wiele typowych komunikatów powiadomień ramek, w tym obsługiwanych przez OnSetFocusfunkcje CWnd, OnHScrolli OnVScroll programu , są delegowane przez CFrameWnd okno ramki do aktualnie aktywnego widoku.

• Aktualnie aktywny widok (lub obecnie aktywne okno ramek podrzędnych MDI w przypadku ramki MDI) może określić podpis okna ramki. Tę funkcję można wyłączyć, wyłączając FWS_ADDTOTITLE fragment stylu okna ramki.

• Okno CFrameWnd ramki zarządza pozycjonowaniem pasków sterowania, widoków i innych okien podrzędnych wewnątrz obszaru klienta okna ramowego. Okno ramki wykonuje również aktualizowanie bezczynności paska narzędzi i innych przycisków paska sterowania. Okno CFrameWnd ramki zawiera również domyślne implementacje poleceń włączania i wyłączania paska narzędzi i paska stanu.

• Okno CFrameWnd ramki zarządza głównym paskiem menu. Po wyświetleniu menu podręcznego okno ramki używa UPDATE_COMMAND_UI mechanizmu do określenia, które elementy menu powinny być włączone, wyłączone lub zaznaczone. Gdy użytkownik wybierze element menu, okno ramki aktualizuje pasek stanu za pomocą ciągu komunikatu dla tego polecenia.

• Okno CFrameWnd ramki zawiera opcjonalną tabelę akceleratorów, która automatycznie tłumaczy akceleratory klawiaturowe.

• Okno CFrameWnd ramki ma opcjonalny zestaw LoadFrame identyfikatorów pomocy, który jest używany do pomocy kontekstowej. Okno ramki jest głównym orkiestratorem stanów półmodalnych, takich jak pomoc kontekstowa (SHIFT+F1) i tryby podglądu wydruku.

• W CFrameWnd oknie ramki zostanie otwarty plik przeciągnięty z Menedżera plików i porzucony w oknie ramki. Jeśli rozszerzenie pliku jest zarejestrowane i skojarzone z aplikacją, okno ramki odpowiada na żądanie otwarcia dynamicznej wymiany danych (DDE), które występuje, gdy użytkownik otworzy plik danych w Menedżerze plików lub po ShellExecute wywołaniu funkcji systemu Windows.

• Jeśli okno ramki jest głównym oknem aplikacji (czyli CWinThread::m_pMainWnd), gdy użytkownik zamknie aplikację, okno ramki wyświetli użytkownikowi monit o zapisanie wszelkich zmodyfikowanych dokumentów (dla i OnClose OnQueryEndSession).

• Jeśli okno ramki jest głównym oknem aplikacji, okno ramki jest kontekstem uruchamiania winHelp. Zamknięcie okna ramki zostanie zamknięte WINHELP.EXE , jeśli zostało uruchomione w celu uzyskania pomocy dla tej aplikacji.

Nie należy używać operatora C++ delete , aby zniszczyć okno ramki. Użycie w zamian parametru CWnd::DestroyWindow. Implementacja CFrameWnd PostNcDestroy spowoduje usunięcie obiektu C++, gdy okno zostanie zniszczone. Gdy użytkownik zamknie okno ramki, domyślna OnClose procedura obsługi wywoła metodę DestroyWindow.

Aby uzyskać więcej informacji na temat CFrameWndprogramu , zobacz Frame Windows (Okna ramek).

Hierarchia dziedziczenia

CObject

CCmdTarget

CWnd

CFrameWnd

Wymagania

Nagłówek: afxwin.h

CFrameWnd::ActivateFrame

Wywołaj tę funkcję składową, aby aktywować i przywrócić okno ramki, aby było widoczne i dostępne dla użytkownika.

virtual void ActivateFrame(int nCmdShow = -1);

Parametry

nCmdShow
Określa parametr, który ma być przekazywany do CWnd::ShowWindow. Domyślnie ramka jest wyświetlana i poprawnie przywracana.

Uwagi

Ta funkcja składowa jest zwykle wywoływana po zdarzeniu interfejsu użytkownika, takim jak DDE, OLE lub inne zdarzenie, które może wyświetlać okno ramki lub jego zawartość użytkownikowi.

Domyślna implementacja aktywuje ramkę i przenosi ją do góry kolejności Z, a w razie potrzeby wykonuje te same kroki dla głównego okna ramki aplikacji.

Zastąpij tę funkcję składową, aby zmienić sposób aktywowania ramki. Można na przykład wymusić zmaksymalizowanie okien podrzędnych MDI. Dodaj odpowiednią funkcjonalność, a następnie wywołaj wersję klasy bazowej z jawnym nCmdShowelementem .

Przykład

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

   CMDIChildWnd::ActivateFrame(nCmdShow);
}

CFrameWnd::BeginModalState

Wywołaj tę funkcję składową, aby utworzyć modalne okno ramowe.

virtual void BeginModalState();

CFrameWnd::CFrameWnd

CFrameWnd Tworzy obiekt, ale nie tworzy widocznego okna ramki.

CFrameWnd();

Uwagi

Wywołaj metodę Create , aby utworzyć widoczne okno.

CFrameWnd::Create

Wywołaj metodę , aby utworzyć i zainicjować okno ramki systemu Windows skojarzone z obiektem 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);

Parametry

lpszClassName
Wskazuje ciąg znaków o wartości null, który nazywa klasę systemu Windows. Nazwa klasy może być dowolną nazwą zarejestrowaną w funkcji globalnej AfxRegisterWndClass RegisterClass lub funkcji systemu Windows. Jeśli NULLprogram używa wstępnie zdefiniowanych atrybutów domyślnych CFrameWnd .

lpszWindowName
Wskazuje ciąg znaków o wartości null, który reprezentuje nazwę okna. Używany jako tekst paska tytułu.

dwStyle
Określa atrybuty stylu okna. Uwzględnij styl, FWS_ADDTOTITLE jeśli pasek tytułu ma automatycznie wyświetlać nazwę dokumentu reprezentowanego w oknie.

rect
Określa rozmiar i położenie okna. Wartość rectDefault umożliwia systemowi Windows określenie rozmiaru i położenia nowego okna.

pParentWnd
Określa okno nadrzędne tego okna ramki. Ten parametr powinien być NULL przeznaczony dla okien ramek najwyższego poziomu.

lpszMenuName
Określa nazwę zasobu menu, który ma być używany z oknem. Użyj MAKEINTRESOURCE polecenia , jeśli menu ma identyfikator liczb całkowitych zamiast ciągu. Ten parametr może mieć wartość NULL.

dwExStyle
Określa atrybuty stylu rozszerzonego okna.

pContext
Określa wskaźnik do CCreateContext struktury. Ten parametr może mieć wartość NULL.

Wartość zwracana

Inicjalizacja niezerowa, jeśli inicjowanie zakończyło się pomyślnie; w przeciwnym razie 0.

Uwagi

Skonstruuj CFrameWnd obiekt w dwóch krokach. Najpierw wywołaj konstruktor, który konstruuje CFrameWnd obiekt, a następnie wywołaj Createmetodę , która tworzy okno ramki systemu Windows i dołącza go do CFrameWnd obiektu. Create Inicjuje nazwę klasy i nazwę okna okna i rejestruje wartości domyślne dla jego stylu, elementu nadrzędnego i skojarzonego menu.

Zamiast LoadFrame Create ładować okno ramki z zasobu zamiast określać jego argumenty.

CFrameWnd::CreateView

Wywołaj metodę CreateView , aby utworzyć widok w ramce.

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

Parametry

pContext
Określa typ widoku i dokumentu.

nID
Identyfikator widoku.

Wartość zwracana

Wskaźnik do CWnd obiektu, jeśli się powiedzie; w przeciwnym razie NULL.

Uwagi

Użyj tej funkcji składowej, aby utworzyć "widoki", które nie CViewsą -pochodne w ramce. Po wywołaniu CreateViewpolecenia należy ręcznie ustawić widok na aktywny i ustawić go jako widoczny. Te zadania nie są wykonywane automatycznie przez CreateViewprogram .

CFrameWnd::DockControlBar

Powoduje zadokowanie paska sterowania do okna ramki.

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

Parametry

pBar
Wskazuje pasek sterowania do zadokowania.

nDockBarID
Określa, które boki okna ramowego należy wziąć pod uwagę do zadokowania. Może to być wartość 0 lub co najmniej jedna z następujących wartości:

• AFX_IDW_DOCKBAR_TOP Zadokuj do górnej strony okna ramki.

• AFX_IDW_DOCKBAR_BOTTOM Zadokuj do dolnej części okna ramki.

• AFX_IDW_DOCKBAR_LEFT Zadokuj do lewej strony okna ramki.

• AFX_IDW_DOCKBAR_RIGHT Zadokuj do prawej strony okna ramki.

Jeśli 0, pasek sterowania może być zadokowany do dowolnej strony włączone do dokowania w oknie ramki docelowej.

lpRect
Określa współrzędnych ekranu, gdzie pasek sterowania zostanie zadokowany w obszarze nonclient okna ramki docelowej.

Uwagi

Pasek sterowania zostanie zadokowany do jednej z boków okna ramowego określonego w wywołaniach funkcji i CControlBar::EnableDocking CFrameWnd::EnableDocking. Wybrana strona jest określana przez nDockBarID.

CFrameWnd::EnableDocking

Wywołaj tę funkcję, aby włączyć zadokowalne paski sterowania w oknie ramowym.

void EnableDocking(DWORD dwDockStyle);

Parametry

dwDockStyle
Określa, które boki okna ramowego mogą służyć jako miejsca dokowania dla pasków sterowania. Może to być co najmniej jeden z następujących elementów:

• CBRS_ALIGN_TOP Umożliwia dokowanie w górnej części obszaru klienta.

• CBRS_ALIGN_BOTTOM Umożliwia dokowanie w dolnej części obszaru klienta.

• CBRS_ALIGN_LEFT Umożliwia zadokowanie po lewej stronie obszaru klienta.

• CBRS_ALIGN_RIGHT Umożliwia zadokowanie po prawej stronie obszaru klienta.

• CBRS_ALIGN_ANY Umożliwia dockowanie po dowolnej stronie obszaru klienta.

Uwagi

Domyślnie paski sterowania będą zadokowane po stronie okna ramki w następującej kolejności: górna, dolna, lewa, prawa.

Przykład

Zobacz przykład dla elementu CToolBar::Create.

CFrameWnd::EndModalState

Wywołaj tę funkcję składową, aby zmienić okno ramki z modalnego na bez moderowania.

virtual void EndModalState();

Uwagi

EndModalState włącza wszystkie okna wyłączone przez BeginModalState.

CFrameWnd::FloatControlBar

Wywołaj tę funkcję, aby spowodować, że pasek sterowania nie zostanie zadokowany do okna ramki.

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

Parametry

pBar
Wskazuje pasek kontrolny, który ma być zmiennoprzecinkowy.

point
Lokalizacja na współrzędnych ekranu, w której zostanie umieszczony lewy górny róg paska sterowania.

dwStyle
Określa, czy wyrównać pasek sterowania w poziomie lub w pionie w nowym oknie ramki. Może to być dowolny z następujących elementów:

• CBRS_ALIGN_TOP Wyorientuje pasek sterowania w pionie.

• CBRS_ALIGN_BOTTOM Wyorientuje pasek sterowania w pionie.

• CBRS_ALIGN_LEFT Wyorientuje pasek sterowania w poziomie.

• CBRS_ALIGN_RIGHT Wyorientuje pasek sterowania w poziomie.

Jeśli style są przekazywane, określając zarówno orientację poziomą, jak i pionową, pasek narzędzi będzie zorientowany w poziomie.

Uwagi

Zazwyczaj odbywa się to podczas uruchamiania aplikacji, gdy program przywraca ustawienia z poprzedniego wykonania.

Ta funkcja jest wywoływana przez platformę, gdy użytkownik powoduje operację upuszczania, zwalniając lewy przycisk myszy podczas przeciągania paska sterowania nad lokalizacją, która nie jest dostępna do zadokowania.

CFrameWnd::GetActiveDocument

Wywołaj tę funkcję składową, aby uzyskać wskaźnik do bieżącego CDocument dołączonego do bieżącego aktywnego widoku.

virtual CDocument* GetActiveDocument();

Wartość zwracana

Wskaźnik do bieżącego CDocument. Jeśli nie ma bieżącego dokumentu, zwraca wartość NULL.

CFrameWnd::GetActiveFrame

Wywołaj tę funkcję składową, aby uzyskać wskaźnik do aktywnego okna podrzędnego interfejsu wielu dokumentów (MDI) okna ramki MDI.

virtual CFrameWnd* GetActiveFrame();

Wartość zwracana

Wskaźnik do aktywnego okna podrzędnego MDI. Jeśli aplikacja jest aplikacją SDI lub okno ramki MDI nie ma aktywnego dokumentu, zostanie zwrócony niejawny this wskaźnik.

Uwagi

Jeśli nie ma aktywnego elementu podrzędnego MDI lub aplikacja jest jednym interfejsem dokumentu (SDI), zwracany jest niejawny this wskaźnik.

CFrameWnd::GetActiveView

Wywołaj tę funkcję składową, aby uzyskać wskaźnik do aktywnego widoku (jeśli istnieje) dołączonego do okna ramowego ( CFrameWnd).

CView* GetActiveView() const;

Wartość zwracana

Wskaźnik do bieżącego CView. Jeśli nie ma bieżącego widoku, zwraca wartość NULL.

Uwagi

Ta funkcja jest zwracana NULL w przypadku wywołania głównego okna ramki MDI ( CMDIFrameWnd). W aplikacji MDI główne okno ramki MDI nie ma skojarzonego z nim widoku. Zamiast tego każde pojedyncze okno podrzędne ( CMDIChildWnd) ma co najmniej jeden skojarzony widok. Aktywny widok w aplikacji MDI można uzyskać, najpierw wyszukując aktywne okno podrzędne MDI, a następnie znajdując aktywny widok dla tego okna podrzędnego. Aktywne okno podrzędne MDI można znaleźć, wywołując funkcję MDIGetActive lub GetActiveFrame , jak pokazano w następującym artykule:

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

Wywołaj metodę GetControlBar , aby uzyskać dostęp do paska sterowania skojarzonego z identyfikatorem.

CControlBar* GetControlBar(UINT nID);

Parametry

nID
Identyfikator paska sterowania.

Wartość zwracana

Wskaźnik do paska sterowania skojarzonego z identyfikatorem.

Uwagi

Parametr nID odwołuje się do unikatowego identyfikatora przekazanego do Create metody paska sterowania. Aby uzyskać więcej informacji na temat pasków sterowania, zapoznaj się z tematem zatytułowanym Paski sterowania.

GetControlBar funkcja zwróci pasek sterowania, nawet jeśli jest zmienna, a tym samym nie jest obecnie częścią podrzędną okna ramki.

CFrameWnd::GetDockState

Wywołaj tę funkcję składową, aby przechowywać informacje o stanie pasków sterowania okna ramowego CDockState w obiekcie.

void GetDockState(CDockState& state) const;

Parametry

state
Zawiera bieżący stan pasków kontrolnych okna ramki po powrocie.

Uwagi

Następnie możesz zapisać zawartość CDockState do magazynu przy użyciu polecenia CDockState::SaveState lub Serialize. Jeśli później chcesz przywrócić paski sterowania do poprzedniego stanu, załaduj stan za pomocą CDockState::LoadState polecenia lub Serialize, a następnie wywołaj metodę SetDockState , aby zastosować poprzedni stan do pasków sterowania okna ramowego.

CFrameWnd::GetMenuBarState

Pobiera stan wyświetlania menu w bieżącej aplikacji MFC.

virtual DWORD GetMenuBarState();

Wartość zwracana

Wartość zwracana może mieć następujące wartości:

• AFX_MBS_VISIBLE (0x01) — menu jest widoczne.

• AFX_MBS_HIDDEN (0x02) — menu jest ukryte.

Uwagi

Jeśli wystąpi błąd środowiska uruchomieniowego, ta metoda jest asercyjna w trybie debugowania i zgłasza wyjątek pochodzący z CException klasy.

CFrameWnd::GetMenuBarVisibility

Wskazuje, czy domyślny stan menu w bieżącej aplikacji MFC jest ukryty, czy widoczny.

virtual DWORD CFrameWnd::GetMenuBarVisibility();

Wartość zwracana

Ta metoda zwraca jedną z następujących wartości:

• AFX_MBV_KEEPVISIBLE (0x01) — menu jest wyświetlane przez cały czas i domyślnie nie ma fokusu.

• AFX_MBV_DISPLAYONFOCUS (0x02) — menu jest domyślnie ukryte. Jeśli menu jest ukryte, naciśnij ALT, aby wyświetlić menu i nadać mu fokus. Jeśli menu jest wyświetlane, naciśnij ALT lub ESC, aby go ukryć.

• AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) — menu jest domyślnie ukryte. Jeśli menu jest ukryte, naciśnij F10, aby wyświetlić menu i nadać mu fokus. Jeśli menu jest wyświetlane, naciśnij F10, aby przełączyć fokus na lub poza menu. Menu jest wyświetlane do momentu naciśnięcia ALT lub ESC, aby go ukryć.

Uwagi

Jeśli wystąpi błąd środowiska uruchomieniowego, ta metoda jest asercyjna w trybie debugowania i zgłasza wyjątek pochodzący z CException klasy.

CFrameWnd::GetMessageBar

Wywołaj tę funkcję składową, aby uzyskać wskaźnik na pasku stanu.

virtual CWnd* GetMessageBar();

Wartość zwracana

Wskaźnik do okna paska stanu.

CFrameWnd::GetMessageString

Zastąpij tę funkcję, aby udostępnić niestandardowe ciągi dla identyfikatorów poleceń.

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

Parametry

nID
Identyfikator zasobu żądanego komunikatu.

rMessage
CString obiekt, do którego ma być umieszczany komunikat.

Uwagi

Domyślna implementacja po prostu ładuje ciąg określony przez nID z pliku zasobu. Ta funkcja jest wywoływana przez platformę, gdy ciąg komunikatu na pasku stanu wymaga aktualizacji.

CFrameWnd::GetTitle

Pobiera tytuł obiektu okna.

CString GetTitle() const;

Wartość zwracana

CString Obiekt zawierający bieżący tytuł obiektu okna.

CFrameWnd::InitialUpdateFrame

Wywołaj metodę IntitialUpdateFrame po utworzeniu nowej ramki za pomocą polecenia Create.

void InitialUpdateFrame(
    CDocument* pDoc,
    BOOL bMakeVisible);

Parametry

pDoc
Wskazuje dokument, z którym jest skojarzone okno ramki. Może to być NULL.

bMakeVisible
Jeśli TRUEelement wskazuje, że ramka powinna stać się widoczna i aktywna. Jeśli FALSEparametr , żadne elementy potomne nie są widoczne.

Uwagi

Powoduje to odbieranie OnInitialUpdate wywołań przez wszystkie widoki w tym oknie ramowym.

Ponadto, jeśli nie było wcześniej aktywnego widoku, podstawowy widok okna ramki jest aktywny. Widok podstawowy to widok z identyfikatorem podrzędnym AFX_IDW_PANE_FIRST. Na koniec okno ramki jest widoczne, jeśli bMakeVisible nie jestzerowe. Jeśli bMakeVisible wartość to 0, bieżący fokus i widoczny stan okna ramki pozostaną niezmienione. Nie jest konieczne wywołanie tej funkcji podczas korzystania z implementacji pliku nowego pliku i otwierania pliku.

CFrameWnd::InModalState

Wywołaj tę funkcję składową, aby sprawdzić, czy okno ramki jest modalne lub moderowe.

BOOL InModalState() const;

Wartość zwracana

Bezzerowe, jeśli tak; w przeciwnym razie 0.

CFrameWnd::IsTracking

Wywołaj tę funkcję składową, aby określić, czy pasek podziału w oknie jest obecnie przenoszony.

BOOL IsTracking() const;

Wartość zwracana

Niezerowe, jeśli operacja rozdzielająca jest w toku; w przeciwnym razie 0.

CFrameWnd::LoadAccelTable

Wywołaj metodę ładowania określonej tabeli akceleratora.

BOOL LoadAccelTable(LPCTSTR lpszResourceName);

Parametry

lpszResourceName
Identyfikuje nazwę zasobu akceleratora. Użyj MAKEINTRESOURCE , jeśli zasób jest identyfikowany z identyfikatorem liczby całkowitej.

Wartość zwracana

Niezerowe, jeśli tabela akceleratora została pomyślnie załadowana; w przeciwnym razie 0.

Uwagi

Jednocześnie można załadować tylko jedną tabelę.

Tabele akceleratora ładowane z zasobów są automatycznie zwalniane po zakończeniu działania aplikacji.

Jeśli wywołasz LoadFrame metodę tworzenia okna ramki, platforma ładuje tabelę akceleratora wraz z zasobami menu i ikonami, a kolejne wywołanie tej funkcji składowej jest niepotrzebne.

CFrameWnd::LoadBarState

Wywołaj tę funkcję, aby przywrócić ustawienia każdego paska sterowania należącego do okna ramki.

void LoadBarState(LPCTSTR lpszProfileName);

Parametry

lpszProfileName
Nazwa sekcji w pliku inicjalizacji (INI) lub klucza w rejestrze systemu Windows, w którym są przechowywane informacje o stanie.

Uwagi

Przywrócone informacje obejmują widoczność, orientację poziomą/pionową, stan dokowania i położenie paska sterowania.

Ustawienia, które chcesz przywrócić, muszą zostać zapisane w rejestrze przed wywołaniem metody LoadBarState. Zapisz informacje w rejestrze, wywołując polecenie CWinApp::SetRegistryKey. Zapisz informacje w pliku INI, wywołując polecenie SaveBarState.

CFrameWnd::LoadFrame

Wywołaj polecenie , aby dynamicznie utworzyć okno ramki na podstawie informacji o zasobie.

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

Parametry

nIDResource
Identyfikator udostępnionych zasobów skojarzonych z oknem ramowym.

dwDefaultStyle
Styl ramki. Uwzględnij styl, FWS_ADDTOTITLE jeśli pasek tytułu ma automatycznie wyświetlać nazwę dokumentu reprezentowanego w oknie.

pParentWnd
Wskaźnik do elementu nadrzędnego ramki.

pContext
Wskaźnik do CCreateContext struktury. Ten parametr może mieć wartość NULL.

Uwagi

Skonstruuj CFrameWnd obiekt w dwóch krokach. Najpierw wywołaj konstruktor, który konstruuje obiekt, a następnie wywołaj LoadFramemetodę , która ładuje CFrameWnd okno ramki systemu Windows i skojarzone zasoby i dołącza okno ramki do CFrameWnd obiektu. Parametr nIDResource określa menu, tabelę akceleratora, ikonę i zasób ciągu tytułu okna ramki.

Użyj funkcji składowej Create , a nie LoadFrame wtedy, gdy chcesz określić wszystkie parametry tworzenia okna ramki.

Struktura wywołuje LoadFrame podczas tworzenia okna ramki przy użyciu obiektu szablonu dokumentu.

Struktura używa argumentu pContext , aby określić obiekty, które mają być połączone z oknem ramki, w tym wszystkie zawarte obiekty widoku. Argument można ustawić pContext na NULL podczas wywoływania metody LoadFrame.

CFrameWnd::m_bAutoMenuEnable

Gdy ten element członkowski danych jest włączony (co jest ustawieniem domyślnym), elementy menu, które nie mają ON_UPDATE_COMMAND_UI lub ON_COMMAND programy obsługi, zostaną automatycznie wyłączone po ściągnięciu menu przez użytkownika.

BOOL m_bAutoMenuEnable;

Uwagi

Elementy menu, które mają procedurę ON_COMMAND obsługi, ale żadna procedura obsługi nie ON_UPDATE_COMMAND_UI zostanie automatycznie włączona.

Po ustawieniu tego elementu członkowskiego danych elementy menu są automatycznie włączone w taki sam sposób, jak przyciski paska narzędzi.

Uwaga

m_bAutoMenuEnable nie ma wpływu na elementy menu najwyższego poziomu.

Ten element członkowski danych upraszcza implementację opcjonalnych poleceń na podstawie bieżącego zaznaczenia i zmniejsza potrzebę zapisywania ON_UPDATE_COMMAND_UI programów obsługi w celu włączania i wyłączania elementów menu.

Przykład

// 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

Wywołaj tę funkcję elementu członkowskiego, aby wynegocjować przestrzeń obramowania w oknie ramowym podczas aktywacji w miejscu OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parametry

nBorderCmd
Zawiera jedną z następujących wartości z elementu enum BorderCmd:

• borderGet = 1

• borderRequest = 2

• borderSet = 3

lpRectBorder
Wskaźnik do RECT struktury lub CRect obiektu, który określa współrzędne obramowania.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Ta funkcja składowa jest implementacją CFrameWnd negocjacji przestrzeni obramowania OLE.

CFrameWnd::OnBarCheck

Wywoływana za każdym razem, gdy akcja jest wykonywana na określonym pasku sterowania.

afx_msg BOOL OnBarCheck(UINT nID);

Parametry

nID
Identyfikator wyświetlanego paska sterowania.

Wartość zwracana

Nonzero, jeśli pasek sterowania istniał; w przeciwnym razie 0.

CFrameWnd::OnContextHelp

Obsługuje pomoc SHIFT+F1 dla elementów w miejscu.

afx_msg void OnContextHelp();

Uwagi

Aby włączyć pomoc kontekstową, należy dodać

ON_COMMAND(ID_CONTEXT_HELP, &CMainFrame::OnContextHelp)

instrukcja do CFrameWnd mapy komunikatów klasy, a także dodaj wpis tabeli akceleratora, zazwyczaj SHIFT+F1, aby włączyć tę funkcję składową.

Jeśli aplikacja jest kontenerem OLE, OnContextHelp umieszcza wszystkie elementy w miejscu zawarte w obiekcie okna ramki w trybie Pomocy. Kursor zmienia się na strzałkę i znak zapytania, a użytkownik może następnie przenieść wskaźnik myszy i nacisnąć lewy przycisk myszy, aby wybrać okno dialogowe, okno, menu lub przycisk polecenia. Ta funkcja składowa wywołuje funkcję WinHelp systemu Windows z kontekstem Pomoc obiektu pod kursorem.

CFrameWnd::OnCreateClient

Wywoływana przez platformę podczas wykonywania elementu OnCreate.

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

Parametry

lpcs
Wskaźnik do struktury systemu Windows CREATESTRUCT .

pContext
Wskaźnik do CCreateContext struktury.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Nigdy nie wywołaj tej funkcji.

Domyślna implementacja tej funkcji tworzy CView obiekt na podstawie informacji podanych w pContextpliku , jeśli to możliwe.

Zastąpij tę funkcję, aby zastąpić wartości przekazywane w CCreateContext obiekcie lub zmienić sposób tworzenia kontrolek w głównym obszarze klienta okna ramki. Składowe CCreateContext , które można zastąpić, są opisane w CCreateContext klasie.

Uwaga

Nie zamieniaj wartości przekazanych CREATESTRUCT w strukturze. Są one przeznaczone tylko do użytku informacyjnego. Jeśli chcesz zastąpić początkowy prostokąt okna, na przykład przesłonić funkcję PreCreateWindowskładową CWnd .

CFrameWnd::OnHideMenuBar

Ta funkcja jest wywoływana, gdy system ma ukryć pasek menu w bieżącej aplikacji MFC.

virtual void OnHideMenuBar();

Uwagi

Ta procedura obsługi zdarzeń umożliwia aplikacji wykonywanie niestandardowych akcji, gdy system ma ukryć menu. Nie można uniemożliwić ukrycia menu, ale możesz na przykład wywołać inne metody, aby pobrać styl menu lub stan.

CFrameWnd::OnSetPreviewMode

Wywołaj tę funkcję składową, aby ustawić główne okno ramki aplikacji w tryb podglądu wydruku i poza nie.

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

Parametry

bPreview
Określa, czy aplikacja ma być umieszczana w trybie podglądu wydruku. Ustaw wartość , aby TRUE umieścić w podglądzie wydruku, FALSE aby anulować tryb podglądu.

pState
Wskaźnik do CPrintPreviewState struktury.

Uwagi

Domyślna implementacja wyłącza wszystkie standardowe paski narzędzi i ukrywa menu główne i główne okno klienta. Spowoduje to zmianę okien ramowych MDI w tymczasowe okna ramowe SDI.

Zastąpi tę funkcję składową, aby dostosować ukrywanie i wyświetlanie pasków sterowania i innych części okien ramowych podczas podglądu wydruku. Wywołaj implementację klasy bazowej z poziomu przesłoniętej wersji.

CFrameWnd::OnShowMenuBar

Ta funkcja jest wywoływana, gdy system ma wyświetlać pasek menu w bieżącej aplikacji MFC.

virtual void OnShowMenuBar();

Uwagi

Ta procedura obsługi zdarzeń umożliwia aplikacji wykonywanie niestandardowych akcji, gdy menu ma być wyświetlane. Nie można zapobiec wyświetlaniu menu, ale można na przykład wywołać inne metody pobierania stylu menu lub stanu.

CFrameWnd::OnUpdateControlBarMenu

Wywoływana przez platformę po zaktualizowaniu skojarzonego menu.

afx_msg void OnUpdateControlBarMenu(CCmdUI* pCmdUI);

Parametry

pCmdUI
Wskaźnik do CCmdUI obiektu reprezentującego menu, które wygenerowało polecenie aktualizacji. Procedura obsługi aktualizacji wywołuje Enable funkcję CCmdUI składową obiektu za pomocą metody pCmdUI w celu zaktualizowania interfejsu użytkownika.

CFrameWnd::RecalcLayout

Wywoływana przez platformę, gdy standardowe paski sterowania są włączane lub wyłączane lub gdy okno ramki jest zmieniane.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametry

bNotify
Określa, czy aktywny element w miejscu okna ramki odbiera powiadomienie o zmianie układu. Jeśli TRUEelement jest powiadamiany; w przeciwnym razie FALSE.

Uwagi

Domyślna implementacja tej funkcji składowej wywołuje CWnd funkcję RepositionBars składową, aby zmienić położenie wszystkich pasków kontrolek w ramce, a także w głównym oknie klienta (zwykle a CView lub MDICLIENT).

Zastąpi tę funkcję składową, aby kontrolować wygląd i zachowanie pasków sterowania po zmianie układu okna ramki. Na przykład wywołaj ją po włączeniu lub wyłączeniu pasków sterowania lub dodaniu innego paska sterowania.

CFrameWnd::rectDefault

Przekaż ten statyczny CRect jako parametr podczas tworzenia okna, aby umożliwić systemowi Windows wybranie początkowego rozmiaru i położenia okna.

static AFX_DATA const CRect rectDefault;

CFrameWnd::SaveBarState

Wywołaj tę funkcję, aby przechowywać informacje o każdym pasku sterowania należącym do okna ramki.

void SaveBarState(LPCTSTR lpszProfileName) const;

Parametry

lpszProfileName
Nazwa sekcji w pliku inicjowania lub klucza w rejestrze systemu Windows, w którym są przechowywane informacje o stanie.

Uwagi

Te informacje można odczytać z pliku inicjowania przy użyciu polecenia LoadBarState. Przechowywane informacje obejmują widoczność, orientację poziomą/pionową, stan dokowania i położenie paska sterowania.

CFrameWnd::SetActivePreviewView

Wyznacza określony widok jako aktywny widok dla zaawansowanej wersji zapoznawczej.

void SetActivePreviewView(CView* pViewNew);

Parametry

pViewNew
Wskaźnik do widoku, który ma zostać aktywowany.

Uwagi

CFrameWnd::SetActiveView

Wywołaj tę funkcję składową, aby ustawić aktywny widok.

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

Parametry

pViewNew
Określa wskaźnik do CView obiektu lub NULL dla żadnego aktywnego widoku.

bNotify
Określa, czy widok ma być powiadamiany o aktywacji. Jeśli TRUEparametr jest wywoływany dla nowego widoku; jeśli FALSE, nie OnActivateView jest.

Uwagi

Struktura automatycznie wywoła tę funkcję, gdy użytkownik zmieni fokus na widok w oknie ramki. Możesz jawnie wywołać SetActiveView polecenie , aby zmienić fokus na określony widok.

CFrameWnd::SetDockState

Wywołaj tę funkcję składową, aby zastosować informacje o stanie przechowywane w CDockState obiekcie do pasków sterowania okna ramki.

void SetDockState(const CDockState& state);

Parametry

state
Zastosuj stan przechowywany do pasków kontrolek okna ramowego.

Uwagi

Aby przywrócić poprzedni stan pasków sterowania, można załadować przechowywany stan za pomocą CDockState::LoadState polecenia lub Serialize, a następnie użyć SetDockState polecenia , aby zastosować go do pasków sterowania okna ramowego. Poprzedni stan jest przechowywany w obiekcie za pomocą polecenia CDockStateGetDockState

CFrameWnd::SetMenuBarState

Ustawia stan wyświetlania menu w bieżącej aplikacji MFC na ukryte lub wyświetlane.

virtual BOOL SetMenuBarState(DWORD nState);

Parametry

nState
[in] Określa, czy ma być wyświetlane, czy ukrywane menu. Parametr nState może mieć następujące wartości:

• AFX_MBS_VISIBLE (0x01) — wyświetla menu, jeśli jest ukryte, ale nie ma żadnego wpływu, jeśli jest widoczny.
• AFX_MBS_HIDDEN (0x02) — ukrywa menu, jeśli jest widoczne, ale nie ma żadnego wpływu, jeśli jest ukryty.

Wartość zwracana

TRUE jeśli ta metoda pomyślnie zmieni stan menu; w przeciwnym razie, FALSE.

Uwagi

Jeśli wystąpi błąd środowiska uruchomieniowego, ta metoda jest asercyjna w trybie debugowania i zgłasza wyjątek pochodzący z CException klasy.

CFrameWnd::SetMenuBarVisibility

Ustawia domyślne zachowanie menu w bieżącej aplikacji MFC jako ukryte lub widoczne.

virtual void SetMenuBarVisibility(DWORD nStyle);

Parametry

nStyle
[in] Określa, czy menu jest domyślnie ukryte, czy jest widoczne i ma fokus. Parametr nStyle może mieć następujące wartości:

• AFX_MBV_KEEPVISIBLE (0x01) — menu jest wyświetlane przez cały czas i domyślnie nie ma fokusu.

• AFX_MBV_DISPLAYONFOCUS (0x02) — menu jest domyślnie ukryte. Jeśli menu jest ukryte, naciśnij ALT, aby wyświetlić menu i nadać mu fokus. Jeśli menu jest wyświetlane, naciśnij ALT lub ESC, aby ukryć menu.

• AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) — menu jest domyślnie ukryte. Jeśli menu jest ukryte, naciśnij F10, aby wyświetlić menu i nadać mu fokus. Jeśli menu jest wyświetlane, naciśnij F10, aby przełączyć fokus na lub poza menu. Menu jest wyświetlane do momentu naciśnięcia ALT lub ESC, aby go ukryć.

Uwagi

Jeśli wartość parametru nStyle jest nieprawidłowa, ta metoda jest asercyjna w trybie debugowania i zgłasza wartość CInvalidArgException w trybie wydania. W przypadku innych błędów środowiska uruchomieniowego ta metoda jest asercyjna w trybie debugowania i zgłasza wyjątek pochodzący z CException klasy.

Ta metoda wpływa na stan menu w aplikacjach napisanych dla systemu Windows Vista i nowszych.

CFrameWnd::SetMessageText

Wywołaj tę funkcję, aby umieścić ciąg w okienku paska stanu, który ma identyfikator 0.

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

Parametry

lpszText
Wskazuje ciąg, który ma zostać umieszczony na pasku stanu.

nID
Identyfikator zasobu ciągu, który ma zostać umieszczony na pasku stanu.

Uwagi

Jest to zazwyczaj najbardziej lewe i najdłuższe okienko paska stanu.

CFrameWnd::SetProgressBarPosition

Ustawia bieżące położenie paska postępu systemu Windows 7 wyświetlanego na pasku zadań.

void SetProgressBarPosition(int nProgressPos);

Parametry

nProgressPos
Określa położenie do ustawienia. Musi znajdować się w zakresie ustawionym przez SetProgressBarRange.

Uwagi

CFrameWnd::SetProgressBarRange

Ustawia zakres paska postępu systemu Windows 7 wyświetlanego na pasku zadań.

void SetProgressBarRange(
    int nRangeMin,
    int nRangeMax);

Parametry

nRangeMin
Minimalna wartość.

nRangeMax
Maksymalna wartość.

Uwagi

CFrameWnd::SetProgressBarState

Ustawia typ i stan wskaźnika postępu wyświetlanego na przycisku paska zadań.

void SetProgressBarState(TBPFLAG tbpFlags);

Parametry

tbpFlags
Flagi kontrolujące bieżący stan przycisku postępu. Określ tylko jedną z następujących flag, ponieważ wszystkie stany wykluczają się wzajemnie: TBPF_NOPROGRESS, , TBPF_NORMALTBPF_INDETERMINATE, TBPF_ERROR, . TBPF_PAUSED

Uwagi

CFrameWnd::SetTaskbarOverlayIcon

Przeciążone. Stosuje nakładkę do przycisku paska zadań, aby wskazać stan aplikacji lub powiadomić użytkownika.

BOOL SetTaskbarOverlayIcon(
    UINT nIDResource,
    LPCTSTR lpcszDescr);

BOOL SetTaskbarOverlayIcon(
    HICON hIcon,
    LPCTSTR lpcszDescr);

Parametry

nIDResource
Określa identyfikator zasobu ikony, która ma być używana jako nakładka. Aby uzyskać hIcon szczegółowe informacje, zobacz opis.

lpcszDescr
Wskaźnik do ciągu, który udostępnia tekst alternatywny wersji informacji przekazywanych przez nakładkę, w celach ułatwień dostępu.

hIcon
Uchwyt ikony do użycia jako nakładka. Powinna to być mała ikona z pomiarem 16x16 pikseli na 96 kropek na cal (dpi). Jeśli do przycisku paska zadań jest już zastosowana ikona nakładki, ta istniejąca nakładka zostanie zamieniona. Ta wartość może mieć wartość NULL. NULL Sposób obsługi wartości zależy od tego, czy przycisk paska zadań reprezentuje jedno okno, czy grupę okien. Jest to odpowiedzialność za bezpłatną hIcon aplikację wywołującą, gdy nie jest już potrzebna.

Wartość zwracana

TRUE w przypadku powodzenia; FALSE jeśli wersja systemu operacyjnego jest mniejsza niż Windows 7 lub jeśli wystąpi błąd podczas ustawiania ikony.

Uwagi

CFrameWnd::SetTitle

Ustawia tytuł obiektu okna.

void SetTitle(LPCTSTR lpszTitle);

Parametry

lpszTitle
Wskaźnik do ciągu znaków zawierającego tytuł obiektu okna.

CFrameWnd::ShowControlBar

Wywołaj tę funkcję składową, aby pokazać lub ukryć pasek sterowania.

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

Parametry

pBar
Wskaźnik do paska sterowania, który ma być wyświetlany lub ukryty.

bShow
Jeśli TRUEparametr określa, że pasek sterowania ma być wyświetlany. Jeśli FALSEparametr określa, że pasek sterowania ma być ukryty.

bDelay
Jeśli TRUEwartość , opóźnij wyświetlanie paska sterowania. Jeśli FALSEwartość , natychmiast pokaż pasek sterowania.

CFrameWnd::ShowOwnedWindows

Wywołaj tę funkcję składową, aby wyświetlić wszystkie okna podrzędne CFrameWnd obiektu.

void ShowOwnedWindows(BOOL bShow);

Parametry

bShow
Określa, czy okna należące do użytkownika mają być wyświetlane, czy ukryte.

Zobacz też

CWnd Klasa
Wykres hierarchii
CWnd Klasa
CMDIFrameWnd Klasa
CMDIChildWnd Klasa
CView Klasa
CDocTemplate Klasa
CRuntimeClass Struktura