Udostępnij za pośrednictwem


Klasa CMiniFrameWnd

Reprezentuje pół wysokości okna ramki zwykle widoczne wokół przestawnych pasków narzędzi.

Składnia

class CMiniFrameWnd : public CFrameWnd

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko opis
CMiniFrameWnd::Create CMiniFrameWnd Tworzy obiekt po budowie.
CMiniFrameWnd::CreateEx CMiniFrameWnd Tworzy obiekt (z dodatkowymi opcjami) po konstrukcji.

Uwagi

Te mini-ramowe okna zachowują się jak normalne okna ramowe, z tą różnicą, że nie mają one zminimalizować/zmaksymalizować przycisków lub menu i wystarczy kliknąć jedno kliknięcie w menu systemowym, aby je odrzucić.

Aby użyć CMiniFrameWnd obiektu, najpierw zdefiniuj obiekt. Następnie wywołaj funkcję Create member (Utwórz element członkowski), aby wyświetlić okno miniramki.

Aby uzyskać więcej informacji na temat używania CMiniFrameWnd obiektów, zobacz artykuł Docking and Floating Toolbars (Dokowanie i przestawne paski narzędzi).

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Wymagania

Nagłówek: afxwin.h

CMiniFrameWnd::CMiniFrameWnd

CMiniFrameWnd Tworzy obiekt, ale nie tworzy okna.

CMiniFrameWnd();

Uwagi

Aby utworzyć okno, wywołaj metodę CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Tworzy okno miniramki systemu Windows i dołącza je do CMiniFrameWnd obiektu.

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parametry

lpClassName
Wskazuje ciąg znaków o wartości null, który nazywa klasę systemu Windows. Nazwa klasy może być dowolną nazwą zarejestrowaną w globalnej funkcji AfxRegisterWndClass . Jeśli wartość NULL, klasa okna zostanie zarejestrowana dla Ciebie przez platformę. MFC udostępnia klasę domyślną następującym stylom i atrybutom:

  • Ustawia bit stylu CS_DBLCLKS, który wysyła komunikaty dwukrotne kliknięcie do procedury okna, gdy użytkownik dwukrotnie kliknie mysz.

  • Ustawia bity stylu CS_HREDRAW i CS_VREDRAW, które umożliwiają ponowne rysowanie zawartości obszaru klienta po zmianie rozmiaru okna.

  • Ustawia kursor klasy na standardową IDC_ARROW systemu Windows.

  • Ustawia szczotkę tła klasy na null, więc okno nie spowoduje wymazywania tła.

  • Ustawia ikonę klasy na standardową ikonę logo systemu Windows waving-flag.

  • Ustawia okno na domyślny rozmiar i położenie, jak wskazano w systemie Windows.

lpWindowName
Wskazuje ciąg znaków o wartości null, który zawiera nazwę okna.

dwStyle
Określa atrybuty stylu okna. Mogą one obejmować standardowe style okien i co najmniej jeden z następujących stylów specjalnych:

  • MFS_MOVEFRAME Umożliwia przeniesienie mini-ramowego okna, klikając dowolną krawędź okna, a nie tylko podpis.

  • MFS_4THICKFRAME wyłącza zmianę rozmiaru mini-ramowego okna.

  • MFS_SYNCACTIVE Synchronizuje aktywację okna miniramki z aktywacją okna nadrzędnego.

  • MFS_THICKFRAME Umożliwia rozmiar okna miniramowania tak małego, jak dozwolona zawartość obszaru klienta.

  • MFS_BLOCKSYSMENU Wyłącza dostęp do menu systemowego i menu sterowania oraz konwertuje je na część podpisu (pasek tytułu).

Zobacz CWnd::Create , aby uzyskać opis możliwych wartości stylu okna. Typowa kombinacja używana dla okien mini-ramowych to WS_POPUP|WS_CAPTION|WS_SYSMENU.

Rect
Struktura RECT określająca żądane wymiary okna.

pParentWnd
Wskazuje okno nadrzędne. Użyj wartości NULL dla okien najwyższego poziomu.

Nid
Jeśli okno mini-ramka zostanie utworzone jako okno podrzędne, jest to identyfikator kontrolki podrzędnej; w przeciwnym razie 0.

Wartość zwracana

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

Uwagi

Create Inicjuje nazwę klasy i nazwę okna okna oraz rejestruje wartości domyślne stylu i elementu nadrzędnego.

CMiniFrameWnd::CreateEx

Tworzy obiekt CMiniFrameWnd.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Parametry

dwExStyle
Określa rozszerzony styl tworzonego CMiniFrameWnd obiektu. Zastosuj dowolny z rozszerzonych stylów okna do okna.

lpClassName
Wskazuje ciąg znaków o wartości null, który nazywa klasę systemu Windows (strukturę WNDCLASS ). Nazwa klasy może być dowolną nazwą zarejestrowaną w globalnej funkcji AfxRegisterWndClass lub dowolną ze wstępnie zdefiniowanych nazw klas kontrolek. Nie może mieć wartości NULL.

lpWindowName
Wskazuje ciąg znaków o wartości null, który zawiera nazwę okna.

dwStyle
Określa atrybuty stylu okna. Zobacz Style okien i CWnd::Create, aby zapoznać się z opisem możliwych wartości.

Rect
Rozmiar i położenie okna we współrzędnych klienta pParentWnd.

pParentWnd
Wskazuje obiekt okna nadrzędnego.

Nid
Identyfikator okna podrzędnego.

Wartość zwracana

Zwraca wartość TRUE w przypadku powodzenia, FALSE w przypadku niepowodzenia.

Uwagi

Parametry CreateEx określają pozycję WNDCLASS, styl okna i (opcjonalnie) początkową pozycję i rozmiar okna. CreateEx Określa również element nadrzędny okna (jeśli istnieje) i identyfikator.

Podczas CreateEx wykonywania system Windows wysyła komunikaty WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE i WM_CREATE do okna.

Aby rozszerzyć domyślną obsługę komunikatów, utwórz klasę z CMiniFrameWndklasy , dodaj mapę komunikatów do nowej klasy i podaj funkcje składowe dla powyższych komunikatów. Zastąpij OnCreatena przykład , aby wykonać wymaganą inicjację dla nowej klasy.

Zastąp kolejne Onprogramy obsługi komunikatów, aby dodać kolejne funkcje do klasy pochodnej.

Jeśli zostanie podany styl WS_VISIBLE, system Windows wysyła okno wszystkie komunikaty wymagane do aktywowania i wyświetlania okna. Jeśli styl okna określa pasek tytułu, tytuł okna wskazywany przez parametr lpszWindowName jest wyświetlany na pasku tytułu.

Parametr dwStyle może być dowolną kombinacją stylów okna.

Stare okna przybornika Paleta stylów nie są już obsługiwane. Stary styl, który nie miał przycisku "X" Zamknij, był obsługiwany podczas uruchamiania aplikacji MFC w poprzednich wersjach systemu Windows, ale nie jest już obsługiwany w programie Visual C++.NET. Teraz obsługiwany jest tylko nowy styl WS_EX_TOOLWINDOW; Aby uzyskać opis tego stylu, zobacz Rozszerzone style okien.

Zobacz też

Klasa CFrameWnd
Wykres hierarchii
Klasa CFrameWnd