Klasa CFrameWnd

Artykuł
02/27/2013

Udostępnia funkcje Windows pojedynczy interfejs dokumentu (SDI) nakładany lub okna wyskakującego ramki, oraz członkowie w oknie zarządzania.

class CFrameWnd : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CFrameWnd::CFrameWnd	Konstrukcje CFrameWnd obiektu.

Metody publiczne

Nazwa	Opis
CFrameWnd::ActivateFrame	Sprawia, że ramka widoczne i dostępne dla użytkownika.
CFrameWnd::BeginModalState	Ustawia modalnym oknie ramki.
CFrameWnd::Create	Wywołanie do tworzenia i zainicjować okna ramki Windows skojarzone z CFrameWnd obiektu.
CFrameWnd::CreateView	Tworzy widok w ramce, który nie pochodzi od CView.
CFrameWnd::DockControlBar	Dokowane pasek sterowania.
CFrameWnd::EnableDocking	Zezwala być zadokowany pasek sterowania.
CFrameWnd::EndModalState	Kończy się Państwo modalne okno ramek.Umożliwia wszystkim windows wyłączone przez BeginModalState.
CFrameWnd::FloatControlBar	Wyświetlany pasek sterowania.
CFrameWnd::GetActiveDocument	Zwraca aktywnych CDocument obiektu.
CFrameWnd::GetActiveFrame	Zwraca aktywnych CFrameWnd obiektu.
CFrameWnd::GetActiveView	Zwraca aktywnych CView obiektu.
CFrameWnd::GetControlBar	Pobiera pasek sterowania.
CFrameWnd::GetDockState	Pobiera stan dokowania okna ramki.
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 ukryty czy widoczny.
CFrameWnd::GetMessageBar	Zwraca wskaźnik na pasku należących do ramki okna stanu.
CFrameWnd::GetMessageString	Pobiera wiadomość odpowiadającego identyfikatora polecenia.
CFrameWnd::GetTitle	Pobiera tytuł pasek sterowania pokrewne.
CFrameWnd::InitialUpdateFrame	Powoduje, że OnInitialUpdate należące do wszystkich widoków w oknie ramki, aby wywołać funkcji składowej.
CFrameWnd::InModalState	Zwraca wartość wskazującą, czy okno ramka jest w stanie modalne.
CFrameWnd::IsTracking	Określa, jeśli pasek podziału jest obecnie przenoszone.
CFrameWnd::LoadAccelTable	Wywołanie załadować tabeli akceleratora.
CFrameWnd::LoadBarState	Wywołanie do przywracania ustawień pasek sterowania.
CFrameWnd::LoadFrame	Wywołanie dynamicznego tworzenia okna ramki z informacji o zasobach.
CFrameWnd::NegotiateBorderSpace	Negocjuje obramowania miejsca w oknie ramki.
CFrameWnd::OnBarCheck	Wywołana w każdym przypadku, gdy akcja jest wykonywana na pasek określonego formantu.
CFrameWnd::OnContextHelp	Obsługuje SHIFT + F1 Pomoc dla elementów w miejscu.
CFrameWnd::OnSetPreviewMode	Ustawia okno aplikacji w ramce głównej do i z trybu podglądu wydruku.
CFrameWnd::OnUpdateControlBarMenu	Wywołana przez ramy podczas aktualizacji związanych z menu.
CFrameWnd::RecalcLayout	Zmiana pasków z CFrameWnd obiektu.
CFrameWnd::SaveBarState	Wywołanie, aby zapisać ustawienia pasek sterowania.
CFrameWnd::SetActivePreviewView	Wyznacza określony widok aktywny widok Podgląd RTF.
CFrameWnd::SetActiveView	Ustawia aktywnych CView obiektu.
CFrameWnd::SetDockState	Wywołanie zadokować okno ramki w oknie głównym.
CFrameWnd::SetMenuBarState	Ustawia stan wyświetlania menu w bieżącej aplikacji MFC wyświetlane lub ukryte.
CFrameWnd::SetMenuBarVisibility	Ustawia domyślne zachowanie menu w bieżącej aplikacji MFC ukryte lub widoczne.
CFrameWnd::SetMessageText	Ustawia tekst paska stanu standardowych.
CFrameWnd::SetProgressBarPosition	Ustawia położenie bieżącego pasek postępu systemu Windows 7, wyświetlany na pasku zadań.
CFrameWnd::SetProgressBarRange	Ustawia zakres dla pasek postępu systemu Windows 7, wyświetlany na pasku zadań.
CFrameWnd::SetProgressBarState	Ustawia typ i stan wyświetlane na pasku zadań wskaźnik zaawansowania.
CFrameWnd::SetTaskbarOverlayIcon	Przeciążone.Przycisk na pasku zadań, aby wskazywać stan aplikacji lub powiadomienie użytkownika dotyczy nakładki.
CFrameWnd::SetTitle	Ustawia tytuł pasek sterowania pokrewne.
CFrameWnd::ShowControlBar	Pokaż pasek sterowania wywołanie.
CFrameWnd::ShowOwnedWindows	Pokazuje wszystkie okna, które są elementy podrzędne CFrameWnd obiektu.

Metody chronione

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

Publiczne danych członków

Nazwa	Opis
CFrameWnd::m_bAutoMenuEnable	Formanty automatyczne włączanie i wyłączanie funkcji dla elementów menu.
CFrameWnd::rectDefault	Przekazany statyczne CRect jako parametr podczas tworzenia CFrameWnd obiekt, aby umożliwić systemu Windows wybrać początkowy rozmiar i położenie okna.

Uwagi

Utworzyć przydatny ramki okna aplikacji, pochodzić z klasy CFrameWnd.Dodaj zmienne składowe klasy pochodne do przechowywania danych specyficznych dla aplikacji.Funkcje składowe obsługi wiadomości wdrożenie i wiadomość mapę w klasie pochodnej, aby określić, co się dzieje, gdy wiadomości są kierowane do okna.

Istnieją trzy sposoby konstruowania okno ramek:

Bezpośrednio do skonstruowania za pomocą Tworzenie.
Bezpośrednio do skonstruowania za pomocą LoadFrame.
Pośrednio skonstruować przy użyciu szablonu dokumentu.

Przed albo wywołanie Tworzenie lub LoadFrame, należy tworzyć obiektu okno ramek na stercie, używając C++ Nowy operatora.Przed wywoływaniem Tworzenie, można także zarejestrować klasy okna z AfxRegisterWndClass funkcja globalna ustawić style ikonę i klasy dla ramki.

Użyj Tworzenie Członkowskich funkcji przekazać parametry tworzenia ramki natychmiastowego jako argumenty.

LoadFramewymaga mniej argumentów niż Tworzenie, a zamiast tego pobiera większość jego wartości domyślne z zasobami, w tym ramki podpis, ikony, akcelerator tabeli i menu.Dostępne przez LoadFrame, te zasoby muszą mieć ten sam identyfikator zasobów (na przykład IDR_MAINFRAME).

Gdy CFrameWnd obiekt zawiera widoki i dokumentów, są one tworzone pośrednio przez RAM zamiast bezpośrednio przez programistę.CDocTemplate Orchestrates obiektu tworzenia ramki, tworzenie widoków zawierających i połączenie widoków do odpowiednich dokumentów.Parametry CDocTemplate określić konstruktora CRuntimeClass trzy klasy zaangażowana (dokument, ramki i Widok).A CRuntimeClass obiekt jest używany w ramach do dynamicznego tworzenia nowych klatek, gdy określony przez użytkownika (na przykład przy użyciu polecenia nowy plik lub wielu polecenie nowe okno interfejsu (MDI) dokument).

Pochodną klasy ramki okna CFrameWnd musi być zadeklarowana z DECLARE_DYNCREATE w celu powyższego RUNTIME_CLASS mechanizm działał poprawnie.

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

A CFrameWnd przechowuje informacje o ramce okna aktywnego widoku, który jest niezależne od aktywnego okna systemu Windows lub bieżący fokus wprowadzania.Podczas uaktywniania ramki widoku aktywnego jest powiadamiany przez wywołanie CView::OnActivateView.
Polecenie wiadomości i wiele typowych wiadomości powiadomień ramki, tym obsługiwane przez OnSetFocus, OnHScroll, i OnVScroll funkcje CWnd, zostały przekazane przez CFrameWnd ramki okna aktywnego widoku.
Aktualnie aktywnego widoku (lub aktualnie aktywne okno ramek podrzędnych MDI w przypadku ramki MDI) można określić tytuł okna ramki.Tę funkcję można wyłączyć przez wyłączenie FWS_ADDTOTITLE bit styl ramki okna.
A CFrameWnd ramki okna zarządza, położenie pasków, widoków i innych okien podrzędnych wewnątrz okna ramki obszaru klienta.Czas bezczynności aktualizacja paska narzędzi i przycisków inne pasek sterowania obsługuje też okno ramek.A CFrameWnd okno ramki ma także domyślne implementacje poleceń przełączanie na i poza pasek narzędzi i stan.
A CFrameWnd ramki okna zarządza główny pasek menu.Po wyświetleniu menu wyskakującego okna ramki używa UPDATE_COMMAND_UI mechanizm określający elementy menu, które powinny być włączone, wyłączone lub sprawdzone.Gdy użytkownik wybierze element menu, okna ramki aktualizuje pasek stanu ciąg wiadomości dla tego polecenia.
A CFrameWnd okno ramki ma tabeli accelerator opcjonalny, który automatycznie tłumaczy skróty klawiaturowe.
A CFrameWnd okno ramki ma identyfikator pomocy opcjonalny zestaw z LoadFrame używaną przy pomocy kontekstowej.Okno ramki jest głównym filmowej Państw semimodal, jak pomoc kontekstową (SHIFT + F1) i trybach Podgląd wydruku.
A CFrameWnd ramki okno pliku przeciągnięte z Menedżera plików, a następnie spadły w oknie ramki.Jeśli rozszerzenie pliku jest zarejestrowane i skojarzone z aplikacją, okno ramki odpowiada żądanie Otwórz exchange (DDE) dane dynamiczne występujący wówczas, gdy użytkownik otwiera plik danych Menedżera plików lub ShellExecute wywoływana jest funkcja Windows.
Jeśli okno ramka jest w głównym oknie aplikacji (czyli CWinThread::m_pMainWnd), gdy użytkownik zamyka aplikację, okno ramki monituje użytkownika o zapisać zmodyfikowany dokumentów (dla OnClose i OnQueryEndSession).
Jeśli okno ramka jest w głównym oknie aplikacji, okno ramki jest kontekst systemem WinHelp.Zamknięcie okna ramka zostanie zamknięty WINHELP.EXE, jeśli został uruchomiony dla pomocy dla tej aplikacji.

Nie używaj C++ usunąć operatora, aby zniszczyć okno ramki.Użyj CWnd::DestroyWindow zamiast.CFrameWnd Wykonania PostNcDestroy usunie obiekt C++, gdy okno jest niszczone.Gdy użytkownik zamyka okno ramki, domyślnie OnClose obsługi będzie wywoływać DestroyWindow.

Aby uzyskać więcej informacji na CFrameWnd, zobacz Windows ramki.