CFrameWnd Sınıf

Windows tek belge arabiriminin (SDI) çakışan veya açılan çerçeve penceresinin işlevselliğini ve pencereyi yönetmek için üyeleri sağlar.

Sözdizimi

class CFrameWnd : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CFrameWnd::CFrameWnd	Bir CFrameWnd nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CFrameWnd::ActivateFrame	Çerçevenin görünür olmasını ve kullanıcının kullanımına sunulmasını sağlar.
CFrameWnd::BeginModalState	Çerçeve penceresini kalıcı olarak ayarlar.
CFrameWnd::Create	Nesnesiyle ilişkilendirilmiş Windows çerçeve penceresini oluşturmak ve başlatmak için çağrısı yapın CFrameWnd .
CFrameWnd::CreateView	içinden türetilmemiş CViewbir çerçeve içinde görünüm oluşturur.
CFrameWnd::DockControlBar	Bir denetim çubuğunu sabitler.
CFrameWnd::EnableDocking	Bir denetim çubuğunun yerleştirilmesine izin verir.
CFrameWnd::EndModalState	Çerçeve penceresinin kalıcı durumunu sonlandırır. tarafından BeginModalStatedevre dışı bırakılan tüm pencereleri etkinleştirir.
CFrameWnd::FloatControlBar	Denetim çubuğunu kaydırıyor.
CFrameWnd::GetActiveDocument	Etkin CDocument nesneyi döndürür.
CFrameWnd::GetActiveFrame	Etkin CFrameWnd nesneyi döndürür.
CFrameWnd::GetActiveView	Etkin CView nesneyi döndürür.
CFrameWnd::GetControlBar	Denetim çubuğunu alır.
CFrameWnd::GetDockState	Çerçeve penceresinin takma birimi durumunu alır.
CFrameWnd::GetMenuBarState	Geçerli MFC uygulamasında menünün görüntüleme durumunu alır.
CFrameWnd::GetMenuBarVisibility	Geçerli MFC uygulamasındaki menünün varsayılan davranışının gizli mi yoksa görünür mü olduğunu gösterir.
CFrameWnd::GetMessageBar	Çerçeve penceresine ait durum çubuğuna bir işaretçi döndürür.
CFrameWnd::GetMessageString	Komut kimliğine karşılık gelen iletiyi alır.
CFrameWnd::GetTitle	İlgili denetim çubuğunun başlığını alır.
CFrameWnd::InitialUpdateFrame	Çerçeve penceresindeki OnInitialUpdate tüm görünümlere ait üye işlevinin çağrılmalarına neden olur.
CFrameWnd::InModalState	Çerçeve penceresinin kalıcı durumda olup olmadığını gösteren bir değer döndürür.
CFrameWnd::IsTracking	Bölücü çubuğunun şu anda taşınıp taşınmadığını belirler.
CFrameWnd::LoadAccelTable	Hızlandırıcı tablosunu yüklemek için çağrısı.
CFrameWnd::LoadBarState	Denetim çubuğu ayarlarını geri yüklemek için çağrısı yapın.
CFrameWnd::LoadFrame	Kaynak bilgilerinden dinamik olarak çerçeve penceresi oluşturmak için çağrısı yapın.
CFrameWnd::NegotiateBorderSpace	Çerçeve penceresindeki kenarlık alanını müzakere eder.
CFrameWnd::OnBarCheck	Belirtilen denetim çubuğunda bir eylem her gerçekleştirildiğinde çağrılır.
CFrameWnd::OnContextHelp	Yerinde öğeler için SHIFT+F1 Yardımını işler.
CFrameWnd::OnSetPreviewMode	Uygulamanın ana çerçeve penceresini baskı önizleme modunun içine ve dışına ayarlar.
CFrameWnd::OnUpdateControlBarMenu	İlişkili menü güncelleştirildiğinde çerçeve tarafından çağrılır.
CFrameWnd::RecalcLayout	Nesnenin denetim çubuklarını yeniden konumlandırır CFrameWnd .
CFrameWnd::SaveBarState	Denetim çubuğu ayarlarını kaydetmek için arayın.
CFrameWnd::SetActivePreviewView	Belirtilen görünümü Zengin Önizleme için etkin görünüm olarak gösterir.
CFrameWnd::SetActiveView	Etkin CView nesneyi ayarlar.
CFrameWnd::SetDockState	Çerçeve penceresini ana pencereye takmak için çağrısı yapın.
CFrameWnd::SetMenuBarState	Geçerli MFC uygulamasındaki menünün görüntüleme durumunu gizli veya görüntülenecek şekilde ayarlar.
CFrameWnd::SetMenuBarVisibility	Geçerli MFC uygulamasındaki menünün varsayılan davranışını gizli veya görünür olacak şekilde ayarlar.
CFrameWnd::SetMessageText	Standart durum çubuğunun metnini ayarlar.
CFrameWnd::SetProgressBarPosition	Görev çubuğunda görüntülenen Windows 7 ilerleme çubuğu için geçerli konumu ayarlar.
CFrameWnd::SetProgressBarRange	Görev çubuğunda görüntülenen Windows 7 ilerleme çubuğu aralığını ayarlar.
CFrameWnd::SetProgressBarState	Görev çubuğu düğmesinde görüntülenen ilerleme göstergesinin türünü ve durumunu ayarlar.
CFrameWnd::SetTaskbarOverlayIcon	Aşırı yüklendi. Uygulama durumunu veya kullanıcıya bir bildirim göstermek için görev çubuğu düğmesine katman uygular.
CFrameWnd::SetTitle	İlgili denetim çubuğunun başlığını ayarlar.
CFrameWnd::ShowControlBar	Denetim çubuğunu göstermek için çağrısı yapın.
CFrameWnd::ShowOwnedWindows	Nesnenin CFrameWnd alt öğeleri olan tüm pencereleri gösterir.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CFrameWnd::OnCreateClient	Çerçeve için bir istemci penceresi oluşturur.
CFrameWnd::OnHideMenuBar	Geçerli MFC uygulamasındaki menü gizlenmeden önce çağrılır.
CFrameWnd::OnShowMenuBar	Geçerli MFC uygulamasındaki menü görüntülenmeden önce çağrılır.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
CFrameWnd::m_bAutoMenuEnable	Menü öğeleri için otomatik etkinleştirme ve devre dışı bırakma işlevlerini denetler.
CFrameWnd::rectDefault	Windows'un pencerenin başlangıç boyutunu ve konumunu seçmesine izin vermek için bir CFrameWnd nesne oluştururken bu statik CRect alanı parametre olarak geçirin.

Açıklamalar

Uygulamanız için yararlı bir çerçeve penceresi oluşturmak için öğesinden CFrameWndbir sınıf türetin. Uygulamanıza özgü verileri depolamak için türetilmiş sınıfa üye değişkenleri ekleyin. İletiler pencereye yönlendirildiğinde ne olacağını belirtmek için türetilmiş sınıfta ileti işleyicisi üye işlevlerini ve ileti eşlemesini uygulayın.

Çerçeve penceresi oluşturmanın üç yolu vardır:

• kullanarak Createdoğrudan oluşturma.

• kullanarak LoadFramedoğrudan oluşturma.

• Belge şablonu kullanarak dolaylı olarak oluşturun.

veya LoadFrameçağırmadan Create önce, C++ new işlecini kullanarak yığında çerçeve penceresi nesnesini oluşturmanız gerekir. çağırmadan Createönce, çerçevenin simgesini ve sınıf stillerini ayarlamak için genel işleve bir pencere sınıfı AfxRegisterWndClass da kaydedebilirsiniz.

Çerçevenin Create oluşturma parametrelerini anında bağımsız değişkenler olarak geçirmek için üye işlevini kullanın.

LoadFrame yerine daha az bağımsız değişken Creategerektirir ve bunun yerine çerçevenin resim yazısı, simgesi, hızlandırıcı tablosu ve menüsü de dahil olmak üzere kaynaklardan varsayılan değerlerinin çoğunu alır. tarafından LoadFrameerişilebilir olması için tüm bu kaynakların aynı kaynak kimliğine (örneğin, IDR_MAINFRAME) sahip olması gerekir.

Bir CFrameWnd nesne görünümler ve belgeler içerdiğinde, bunlar doğrudan programcı tarafından değil, dolaylı olarak çerçeve tarafından oluşturulur. CDocTemplate nesnesi çerçevenin oluşturulmasını, içeren görünümlerin oluşturulmasını ve görünümlerin uygun belgeye bağlantısını düzenler. Oluşturucunun CDocTemplate parametreleri, ilgili üç sınıfın (belge, çerçeve ve görünüm) öğesini belirtir CRuntimeClass . Kullanıcı CRuntimeClass tarafından belirtildiğinde (örneğin, Dosya Yeni komutu veya birden çok belge arabirimi (MDI) Penceresi Yeni komutu kullanılarak) yeni çerçeveler oluşturmak için çerçeve tarafından bir nesne kullanılır.

Yukarıdaki RUNTIME_CLASS mekanizmanın düzgün çalışması için öğesinden CFrameWnd türetilen bir çerçeve penceresi sınıfı ile DECLARE_DYNCREATE bildirilmelidir.

a CFrameWnd , Windows için tipik bir uygulamada ana pencerenin aşağıdaki işlevlerini gerçekleştirmek için varsayılan uygulamaları içerir:

• Çerçeve CFrameWnd penceresi, Windows etkin penceresinden veya geçerli giriş odağından bağımsız olan etkin bir görünümü izler. Çerçeve yeniden etkinleştirildiğinde, çağrılarak CView::OnActivateViewetkin görünüme bildirim gönderilir.

• Komut iletileri ve , ve OnVScroll işlevleri CWndtarafından OnSetFocusOnHScrollişlenenler de dahil olmak üzere birçok yaygın çerçeve bildirim iletisi, bir CFrameWnd çerçeve penceresi tarafından o anda etkin olan görünüme devredilir.

• Şu anda etkin olan görünüm (veya bir MDI çerçevesi söz konusu olduğunda etkin olan MDI alt çerçeve penceresi), çerçeve penceresinin resim yazısını belirleyebilir. Bu özellik, çerçeve penceresinin FWS_ADDTOTITLE stil biti kapatılarak devre dışı bırakılabilir.

• Çerçeve CFrameWnd penceresi, çerçeve penceresinin istemci alanı içindeki denetim çubuklarının, görünümlerin ve diğer alt pencerelerin konumunu yönetir. Çerçeve penceresi, araç çubuğu ve diğer denetim çubuğu düğmelerinin boşta kalma süresi güncelleştirmesini de yapar. Çerçeve CFrameWnd penceresinde ayrıca araç çubuğunda ve durum çubuğunda geçiş yapmak ve kapatmak için varsayılan komut uygulamaları bulunur.

• Ana CFrameWnd menü çubuğunu bir çerçeve penceresi yönetir. Bir açılır menü görüntülendiğinde, çerçeve penceresi hangi menü öğelerinin etkinleştirilmesi UPDATE_COMMAND_UI , devre dışı bırakılması veya denetlenmesi gerektiğini belirlemek için mekanizmayı kullanır. Kullanıcı bir menü öğesi seçtiğinde, çerçeve penceresi durum çubuğunu bu komutun ileti dizesiyle güncelleştirir.

• Çerçeve CFrameWnd penceresinde, klavye hızlandırıcılarını otomatik olarak çeviren isteğe bağlı bir hızlandırıcı tablosu vardır.

• Çerçeve CFrameWnd penceresinde, bağlama duyarlı yardım için kullanılan isteğe bağlı bir yardım kimliği kümesi LoadFrame vardır. Çerçeve penceresi, bağlama duyarlı yardım (SHIFT+F1) ve baskı önizleme modları gibi yarımodal durumların ana düzenleyicisidir.

• Çerçeve CFrameWnd penceresi, Dosya Yöneticisi'nden sürüklenen ve çerçeve penceresine bırakılan bir dosyayı açar. Bir dosya uzantısı kayıtlıysa ve uygulamayla ilişkiliyse, kullanıcı Dosya Yöneticisi'nde bir veri dosyası açtığında veya Windows işlevi çağrıldığında ShellExecute oluşan dinamik veri değişimi (DDE) açma isteğine çerçeve penceresi yanıt verir.

• Çerçeve penceresi ana uygulama penceresiyse (yani), CWinThread::m_pMainWndkullanıcı uygulamayı kapattığında, çerçeve penceresi kullanıcıdan değiştirilen belgeleri (ve OnQueryEndSessioniçinOnClose) kaydetmesini ister.

• Çerçeve penceresi ana uygulama penceresiyse, çerçeve penceresi WinHelp çalıştırma bağlamıdır. Bu uygulama için yardım için başlatıldıysa çerçeve penceresi kapatılır WINHELP.EXE .

Çerçeve penceresini yok etmek için C++ delete işlecini kullanmayın. Bunun yerine CWnd::DestroyWindow kullanın. CFrameWnd uygulamasıPostNcDestroy, pencere yok edildiğinde C++ nesnesini siler. Kullanıcı çerçeve penceresini kapattığında, varsayılan OnClose işleyici çağırır DestroyWindow.

hakkında CFrameWnddaha fazla bilgi için bkz . Çerçeve Pencereleri.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CFrameWnd

Gereksinimler

Üstbilgi: afxwin.h

CFrameWnd::ActivateFrame

Çerçeve penceresini kullanıcının görebilmesi ve kullanabilmesi için etkinleştirmek ve geri yüklemek için bu üye işlevini çağırın.

virtual void ActivateFrame(int nCmdShow = -1);

Parametreler

nCmdShow
öğesine geçirecek parametreyi CWnd::ShowWindowbelirtir. Varsayılan olarak, çerçeve gösterilir ve doğru şekilde geri yüklenir.

Açıklamalar

Bu üye işlevi genellikle DDE, OLE veya çerçeve penceresini veya içeriğini kullanıcıya gösterebilen başka bir olay gibi kullanıcı dışı bir arabirim olayından sonra çağrılır.

Varsayılan uygulama çerçeveyi etkinleştirir ve Z sırasının en üstüne getirir ve gerekirse uygulamanın ana çerçeve penceresi için aynı adımları uygular.

Çerçevenin etkinleştirilme biçimini değiştirmek için bu üye işlevini geçersiz kılın. Örneğin, MDI alt pencerelerini ekranı kaplamaya zorlayabilirsiniz. Uygun işlevselliği ekleyin, ardından açık nCmdShowbir ile temel sınıf sürümünü çağırın.

Örnek

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

   CMDIChildWnd::ActivateFrame(nCmdShow);
}

CFrameWnd::BeginModalState

Çerçeve penceresini kalıcı hale getirmek için bu üye işlevini çağır.

virtual void BeginModalState();

CFrameWnd::CFrameWnd

Bir CFrameWnd nesne oluşturur, ancak görünür çerçeve penceresini oluşturmaz.

CFrameWnd();

Açıklamalar

Görünür pencereyi oluşturmak için çağrısı Create yapın.

CFrameWnd::Create

Nesnesiyle ilişkilendirilmiş Windows çerçeve penceresini oluşturmak ve başlatmak için çağrısı yapın 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);

Parametreler

lpszClassName
Windows sınıfını adlandıran null ile sonlandırılan karakter dizesini gösterir. Sınıf adı, genel işleve veya Windows işlevine AfxRegisterWndClass RegisterClass kaydedilmiş herhangi bir ad olabilir. ise NULL, önceden tanımlanmış varsayılan CFrameWnd öznitelikleri kullanır.

lpszWindowName
Pencere adını temsil eden null olarak sonlandırılan karakter dizesini gösterir. Başlık çubuğu için metin olarak kullanılır.

dwStyle
Pencere stili özniteliklerini belirtir. Başlık çubuğunun FWS_ADDTOTITLE pencerede temsil edilen belgenin adını otomatik olarak görüntülemesini istiyorsanız stili ekleyin.

rect
Pencerenin boyutunu ve konumunu belirtir. değeri, rectDefault Windows'un yeni pencerenin boyutunu ve konumunu belirtmesine olanak tanır.

pParentWnd
Bu çerçeve penceresinin üst penceresini belirtir. Bu parametre en üst düzey çerçeve pencereleri için olmalıdır NULL .

lpszMenuName
Pencereyle kullanılacak menü kaynağının adını tanımlar. Menüde dize yerine tamsayı kimliği varsa kullanın MAKEINTRESOURCE . Bu parametre olabilir NULL.

dwExStyle
Pencere genişletilmiş stil özniteliklerini belirtir.

pContext
Bir yapıya yönelik bir CCreateContext işaretçi belirtir. Bu parametre olabilir NULL.

Dönüş Değeri

Başlatma başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

İki adımda bir CFrameWnd nesne oluşturun. İlk olarak, nesnesini oluşturan oluşturucuyu çağırın CFrameWnd ve ardından Windows çerçeve penceresini oluşturan ve nesneye ekleyen öğesini çağırınCreateCFrameWnd. Create pencerenin sınıf adını ve pencere adını başlatır ve stili, üst öğesi ve ilişkili menüsü için varsayılan değerleri kaydeder.

Bağımsız değişkenlerini belirtmek yerine bir kaynaktan çerçeve penceresini yüklemek yerine Create kullanınLoadFrame.

CFrameWnd::CreateView

Bir çerçeve içinde görünüm oluşturmak için çağrısı CreateView .

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

Parametreler

pContext
Görünüm ve belge türünü belirtir.

nID
Görünümün kimlik numarası.

Dönüş Değeri

Başarılı olursa nesne CWnd işaretçisi; aksi takdirde NULL.

Açıklamalar

Bir çerçeve içinde türetilmemiş CView"görünümler" oluşturmak için bu üye işlevini kullanın. çağrısı CreateViewyaptıktan sonra, görünümü el ile etkin olarak ve görünür olacak şekilde ayarlamanız gerekir; bu görevler tarafından CreateViewotomatik olarak gerçekleştirilmez.

CFrameWnd::DockControlBar

Denetim çubuğunun çerçeve penceresine yerleştirmesine neden olur.

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

Parametreler

pBar
Yerleştirilecek denetim çubuğunu gösterir.

nDockBarID
Yerleştirme için çerçeve penceresinin hangi taraflarının dikkate alındığını belirler. 0 veya aşağıdakilerden biri veya daha fazlası olabilir:

• AFX_IDW_DOCKBAR_TOP Çerçeve penceresinin üst tarafına sabitleyin.

• AFX_IDW_DOCKBAR_BOTTOM Çerçeve penceresinin alt tarafına sabitleyin.

• AFX_IDW_DOCKBAR_LEFT Çerçeve penceresinin sol tarafına sabitleyin.

• AFX_IDW_DOCKBAR_RIGHT Çerçeve penceresinin sağ tarafına sabitleyin.

0 ise, denetim çubuğu hedef çerçeve penceresine yerleştirme için etkinleştirilen herhangi bir tarafa sabitlenebilir.

lpRect
Denetim çubuğunun hedef çerçeve penceresinin istemci olmayan alanına yerleştirileceği ekran koordinatlarında belirler.

Açıklamalar

Denetim çubuğu, hem hem CFrameWnd::EnableDockingde CControlBar::EnableDocking çağrılarında belirtilen çerçeve penceresinin kenarlarından birine yerleştirilecektir. Seçilen taraf tarafından nDockBarIDbelirlenir.

CFrameWnd::EnableDocking

Çerçeve penceresinde yerleştirilebilir denetim çubuklarını etkinleştirmek için bu işlevi çağırabilirsiniz.

void EnableDocking(DWORD dwDockStyle);

Parametreler

dwDockStyle
Çerçeve penceresinin hangi kenarlarının denetim çubukları için yerleştirme siteleri olarak görev yapabileceklerini belirtir. Aşağıdakilerden biri veya daha fazlası olabilir:

• CBRS_ALIGN_TOP İstemci alanının en üstüne yerleştirmeye izin verir.

• CBRS_ALIGN_BOTTOM İstemci alanının en altına yerleştirmeye izin verir.

• CBRS_ALIGN_LEFT İstemci alanının sol tarafına yerleştirmeye izin verir.

• CBRS_ALIGN_RIGHT İstemci alanının sağ tarafına yerleştirmeye izin verir.

• CBRS_ALIGN_ANY İstemci alanının herhangi bir tarafına yerleştirmeye izin verir.

Açıklamalar

Varsayılan olarak, denetim çubukları çerçeve penceresinin bir yanına şu sırayla sabitlenir: üst, alt, sol, sağ.

Örnek

örneğine CToolBar::Createbakın.

CFrameWnd::EndModalState

Bu üye işlevini çağırarak bir çerçeve penceresini kalıcı olandan modeless olarak değiştirin.

virtual void EndModalState();

Açıklamalar

EndModalState tarafından BeginModalStatedevre dışı bırakılan tüm pencereleri etkinleştirir.

CFrameWnd::FloatControlBar

Bir denetim çubuğunun çerçeve penceresine yerleştirilmemesi için bu işlevi çağırın.

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

Parametreler

pBar
Kaydırılacak denetim çubuğunu gösterir.

point
Ekran koordinatlarında, denetim çubuğunun sol üst köşesinin yerleştirileceği konum.

dwStyle
Denetim çubuğunun yeni çerçeve penceresi içinde yatay veya dikey olarak hizalanıp hizalanmayacağını belirtir. Aşağıdakilerden herhangi biri olabilir:

• CBRS_ALIGN_TOP Denetim çubuğunu dikey olarak yönlendirir.

• CBRS_ALIGN_BOTTOM Denetim çubuğunu dikey olarak yönlendirir.

• CBRS_ALIGN_LEFT Denetim çubuğunu yatay olarak yönlendirir.

• CBRS_ALIGN_RIGHT Denetim çubuğunu yatay olarak yönlendirir.

Hem yatay hem de dikey yönlendirmeyi belirten stiller geçirilirse, araç çubuğu yatay olarak yönlendirilir.

Açıklamalar

Bu genellikle, program önceki yürütmeden ayarları geri yüklerken uygulama başlangıcında yapılır.

Kullanıcı, denetim çubuğunu yerleştirme için kullanılamayan bir konumun üzerine sürüklerken sol fare düğmesini serbest bırakarak bırakma işlemine neden olduğunda bu işlev çerçeve tarafından çağrılır.

CFrameWnd::GetActiveDocument

Geçerli etkin görünüme eklenmiş geçerli CDocument öğeye bir işaretçi almak için bu üye işlevini çağırın.

virtual CDocument* GetActiveDocument();

Dönüş Değeri

Geçerli CDocumentöğesine işaret eden bir işaretçi. Geçerli bir belge yoksa, döndürür NULL.

CFrameWnd::GetActiveFrame

MDI çerçeve penceresinin etkin birden çok belge arabirimi (MDI) alt penceresine işaretçi almak için bu üye işlevini çağırın.

virtual CFrameWnd* GetActiveFrame();

Dönüş Değeri

Etkin MDI alt penceresinin işaretçisi. Uygulama bir SDI uygulamasıysa veya MDI çerçeve penceresinde etkin belge yoksa, örtük this işaretçi döndürülür.

Açıklamalar

Etkin MDI alt öğesi yoksa veya uygulama tek bir belge arabirimi (SDI) ise, örtük this işaretçi döndürülür.

CFrameWnd::GetActiveView

Bir çerçeve penceresine ( CFrameWnd) bağlı etkin görünüme (varsa) bir işaretçi almak için bu üye işlevini çağırın.

CView* GetActiveView() const;

Dönüş Değeri

Geçerli CViewöğesine işaret eden bir işaretçi. Geçerli görünüm yoksa döndürür NULL.

Açıklamalar

Bu işlev, bir MDI ana çerçeve penceresi ( CMDIFrameWnd) için çağrıldığında döndürürNULL. MDI uygulamasında, MDI ana çerçeve penceresinin kendisiyle ilişkilendirilmiş bir görünümü yoktur. Bunun yerine, her bir alt pencere ( CMDIChildWnd) bir veya daha fazla ilişkili görünüme sahiptir. Bir MDI uygulamasındaki etkin görünüm, önce etkin MDI alt penceresi ve ardından bu alt pencere için etkin görünüm bulunarak elde edilebilir. Etkin MDI alt penceresi işlevi MDIGetActive çağrılarak veya GetActiveFrame aşağıda gösterildiği gibi bulunabilir:

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

Kimlikle ilişkili denetim çubuğuna erişim kazanmak için çağrısı GetControlBar yapın.

CControlBar* GetControlBar(UINT nID);

Parametreler

nID
Denetim çubuğunun kimlik numarası.

Dönüş Değeri

Kimlikle ilişkili denetim çubuğunun işaretçisi.

Açıklamalar

parametresi, nID denetim çubuğunun yöntemine geçirilen benzersiz tanımlayıcıya Create başvurur. Denetim çubukları hakkında daha fazla bilgi için Denetim Çubukları başlıklı konuya bakın.

GetControlBar , kayan olsa bile denetim çubuğunu döndürür ve bu nedenle şu anda çerçevenin alt penceresi değildir.

CFrameWnd::GetDockState

Çerçeve penceresinin denetim çubukları hakkındaki durum bilgilerini bir CDockState nesnede depolamak için bu üye işlevini çağırın.

void GetDockState(CDockState& state) const;

Parametreler

state
Dönüşte çerçeve penceresinin denetim çubuklarının geçerli durumunu içerir.

Açıklamalar

Daha sonra içeriğini CDockState veya Serializekullanarak CDockState::SaveState depolama alanına yazabilirsiniz. Daha sonra denetim çubuklarını önceki bir duruma geri yüklemek istiyorsanız, veya Serializeile CDockState::LoadState durumu yükleyin, ardından önceki durumu çerçeve penceresinin denetim çubuklarına uygulamak için çağrısı SetDockState yapın.

CFrameWnd::GetMenuBarState

Geçerli MFC uygulamasında menünün görüntüleme durumunu alır.

virtual DWORD GetMenuBarState();

Dönüş Değeri

Dönüş değeri aşağıdaki değerlere sahip olabilir:

• AFX_MBS_VISIBLE (0x01) - Menü görünür.

• AFX_MBS_HIDDEN (0x02) - Menü gizlidir.

Açıklamalar

Bir çalışma zamanı hatası oluşursa, bu yöntem Hata Ayıklama modunda onaylar ve sınıfından CException türetilen bir özel durum oluşturur.

CFrameWnd::GetMenuBarVisibility

Geçerli MFC uygulamasındaki menünün varsayılan durumunun gizli mi yoksa görünür mü olduğunu gösterir.

virtual DWORD CFrameWnd::GetMenuBarVisibility();

Dönüş Değeri

Bu yöntem aşağıdaki değerlerden birini döndürür:

• AFX_MBV_KEEPVISIBLE (0x01) - Menü her zaman görüntülenir ve varsayılan olarak odak yoktur.

• AFX_MBV_DISPLAYONFOCUS (0x02) - Menü varsayılan olarak gizlidir. Menü gizliyse, menüyü görüntülemek ve odağı vermek için ALT tuşuna basın. Menü görüntüleniyorsa, gizlemek için ALT veya ESC tuşuna basın.

• AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) - Menü varsayılan olarak gizlidir. Menü gizliyse, F10 tuşuna basarak menüyü görüntüleyin ve odağı verin. Menü görüntüleniyorsa, odağı açmak veya menüden kapatmak için F10 tuşuna basın. Menü, gizlemek için ALT veya ESC tuşuna basana kadar görüntülenir.

Açıklamalar

Bir çalışma zamanı hatası oluşursa, bu yöntem Hata Ayıklama modunda onaylar ve sınıfından CException türetilen bir özel durum oluşturur.

CFrameWnd::GetMessageBar

Durum çubuğuna bir işaretçi almak için bu üye işlevini çağırın.

virtual CWnd* GetMessageBar();

Dönüş Değeri

Durum çubuğu penceresinin işaretçisi.

CFrameWnd::GetMessageString

Komut kimlikleri için özel dizeler sağlamak üzere bu işlevi geçersiz kılın.

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

Parametreler

nID
İstenen iletinin Kaynak Kimliği.

rMessage
CString nesnesini seçin.

Açıklamalar

Varsayılan uygulama, tarafından belirtilen nID dizeyi kaynak dosyasından yükler. Durum çubuğundaki ileti dizesinin güncelleştirilmesi gerektiğinde bu işlev çerçeve tarafından çağrılır.

CFrameWnd::GetTitle

Pencere nesnesinin başlığını alır.

CString GetTitle() const;

Dönüş Değeri

CString Pencere nesnesinin geçerli başlığını içeren bir nesne.

CFrameWnd::InitialUpdateFrame

ile Createyeni bir çerçeve oluşturduktan sonra çağrısı.IntitialUpdateFrame

void InitialUpdateFrame(
    CDocument* pDoc,
    BOOL bMakeVisible);

Parametreler

pDoc
Çerçeve penceresinin ilişkilendirildiği belgeyi gösterir. olabilir NULL.

bMakeVisible
ise TRUE, çerçevenin görünür ve etkin olması gerektiğini belirtir. ise FALSE, alt öğeler görünür hale getirilmemiş olur.

Açıklamalar

Bu, bu çerçeve penceresindeki tüm görünümlerin çağrılarını OnInitialUpdate almasına neden olur.

Ayrıca, daha önce etkin bir görünüm yoksa, çerçeve penceresinin birincil görünümü etkin hale getirilir. Birincil görünüm, alt kimliğine sahip bir görünümdür AFX_IDW_PANE_FIRST. Son olarak, sıfır olmayan çerçeve bMakeVisible penceresi görünür hale getirilir. 0 ise bMakeVisible , geçerli odak ve çerçeve penceresinin görünür durumu değişmeden kalır. Çerçevenin Dosya Yeni ve Dosya Aç uygulamasını kullanırken bu işlevi çağırmak gerekli değildir.

CFrameWnd::InModalState

Çerçeve penceresinin kalıcı mı yoksa modsuz mu olduğunu denetlemek için bu üye işlevini çağır.

BOOL InModalState() const;

Dönüş Değeri

Sıfırdan farklıysa evet; aksi takdirde 0.

CFrameWnd::IsTracking

Penceredeki bölücü çubuğunun şu anda taşınıp taşınmadığını belirlemek için bu üye işlevini çağırın.

BOOL IsTracking() const;

Dönüş Değeri

Bir bölücü işlemi devam ediyorsa sıfır olmayan; aksi takdirde 0.

CFrameWnd::LoadAccelTable

Belirtilen hızlandırıcı tablosunu yüklemek için çağrısı.

BOOL LoadAccelTable(LPCTSTR lpszResourceName);

Parametreler

lpszResourceName
Hızlandırıcı kaynağının adını tanımlar. Kaynak bir tamsayı kimliğiyle tanımlanırsa kullanın MAKEINTRESOURCE .

Dönüş Değeri

Hızlandırıcı tablosu başarıyla yüklendiyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Aynı anda yalnızca bir tablo yüklenebilir.

Uygulama sonlandırıldığında kaynaklardan yüklenen hızlandırıcı tabloları otomatik olarak serbesttir.

Çerçeve penceresini oluşturmak için çağırırsanız LoadFrame , çerçeve menü ve simge kaynaklarıyla birlikte bir hızlandırıcı tablosu yükler ve bu üye işlevine sonraki bir çağrı gereksizdir.

CFrameWnd::LoadBarState

Çerçeve penceresine ait her denetim çubuğunun ayarlarını geri yüklemek için bu işlevi çağırın.

void LoadBarState(LPCTSTR lpszProfileName);

Parametreler

lpszProfileName
Başlatma (INI) dosyasındaki bir bölümün veya Windows kayıt defterindeki durum bilgilerinin depolandığı anahtarın adı.

Açıklamalar

Geri yüklenen bilgiler görünürlük, yatay/dikey yönlendirme, yerleştirme durumu ve denetim çubuğu konumunu içerir.

Geri yüklemek istediğiniz ayarların çağrıdan LoadBarStateönce kayıt defterine yazılması gerekir. çağırarak CWinApp::SetRegistryKeybilgileri kayıt defterine yazın. çağrısı SaveBarStateyaparak bilgileri INI dosyasına yazın.

CFrameWnd::LoadFrame

Kaynak bilgilerinden dinamik olarak çerçeve penceresi oluşturmak için çağrısı yapın.

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

Parametreler

nIDResource
Çerçeve penceresiyle ilişkili paylaşılan kaynakların kimliği.

dwDefaultStyle
Çerçevenin stili. Başlık çubuğunun FWS_ADDTOTITLE pencerede temsil edilen belgenin adını otomatik olarak görüntülemesini istiyorsanız stili ekleyin.

pParentWnd
Çerçevenin üst öğesinin işaretçisi.

pContext
Bir yapıya işaretçi CCreateContext . Bu parametre olabilir NULL.

Açıklamalar

İki adımda bir CFrameWnd nesne oluşturun. İlk olarak, nesnesini oluşturan oluşturucuyu çağırın CFrameWnd ve ardından Windows çerçeve penceresini ve ilişkili kaynakları yükleyen ve çerçeve penceresini nesneye ekleyen öğesini çağırınLoadFrameCFrameWnd. nIDResource parametresi, çerçeve penceresi başlığının menüsünü, hızlandırıcı tablosunu, simgesini ve dize kaynağını belirtir.

Çerçeve penceresinin Create oluşturma parametrelerinin tümünü belirtmek yerine üye işlevini LoadFrame kullanın.

Çerçeve, belge şablonu nesnesi kullanarak bir çerçeve penceresi oluşturduğunda çağırır LoadFrame .

Çerçeve, bağımsız değişkenini pContext kullanarak çerçeve penceresine bağlanacak nesneleri (kapsanan görünüm nesneleri dahil) belirtir. bağımsız değişkenini pContext çağırdığınızda LoadFrameolarak NULL ayarlayabilirsiniz.

CFrameWnd::m_bAutoMenuEnable

Bu veri üyesi etkinleştirildiğinde (varsayılandır), veya ON_COMMAND işleyicisi olmayan ON_UPDATE_COMMAND_UI menü öğeleri, kullanıcı bir menüyü aşağı çektiğinde otomatik olarak devre dışı bırakılır.

BOOL m_bAutoMenuEnable;

Açıklamalar

İşleyicisi olan ON_COMMAND ancak işleyicisi olmayan ON_UPDATE_COMMAND_UI menü öğeleri otomatik olarak etkinleştirilir.

Bu veri üyesi ayarlandığında, menü öğeleri araç çubuğu düğmelerinin etkinleştirildiği şekilde otomatik olarak etkinleştirilir.

Not

m_bAutoMenuEnable üst düzey menü öğeleri üzerinde hiçbir etkisi yoktur.

Bu veri üyesi, isteğe bağlı komutların geçerli seçime göre uygulanmasını basitleştirir ve menü öğelerini etkinleştirmek ve devre dışı bırakmak için işleyici yazma ON_UPDATE_COMMAND_UI gereksinimini azaltır.

Örnek

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

OLE yer değiştirme etkinleştirmesi sırasında çerçeve penceresinde kenarlık alanı anlaşması yapmak için bu üye işlevini çağırın.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parametreler

nBorderCmd
aşağıdaki değerlerden enum BorderCmdbirini içerir:

• borderGet = 1

• borderRequest = 2

• borderSet = 3

lpRectBorder
Bir yapı veya RECT kenarlık koordinatlarını belirten bir CRect nesne işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu üye işlevi, OLE sınır alanı anlaşması uygulamasıdır CFrameWnd .

CFrameWnd::OnBarCheck

Belirtilen denetim çubuğunda bir eylem her gerçekleştirildiğinde çağrılır.

afx_msg BOOL OnBarCheck(UINT nID);

Parametreler

nID
Gösterilen denetim çubuğunun kimliği.

Dönüş Değeri

Denetim çubuğu varsa sıfır olmayan; aksi takdirde 0.

CFrameWnd::OnContextHelp

Yerinde öğeler için SHIFT+F1 Yardımını işler.

afx_msg void OnContextHelp();

Açıklamalar

Bağlama duyarlı yardımı etkinleştirmek için

ON_COMMAND(ID_CONTEXT_HELP, &CMainFrame::OnContextHelp)

deyimini sınıf ileti eşlemenize CFrameWnd ekleyin ve bu üye işlevini etkinleştirmek için genellikle SHIFT+F1 gibi bir hızlandırıcı-tablo girdisi ekleyin.

Uygulamanız bir OLE Kapsayıcısı ise, OnContextHelp çerçeve penceresi nesnesi içinde bulunan tüm yerinde öğeleri Yardım moduna alır. İmleç bir ok ve soru işaretine dönüşür ve kullanıcı fare işaretçisini hareket ettirebilir ve sol fare düğmesine basarak bir iletişim kutusu, pencere, menü veya komut düğmesi seçebilir. Bu üye işlevi, imlecin altındaki nesnenin Yardım bağlamıyla Windows işlevini WinHelp çağırır.

CFrameWnd::OnCreateClient

yürütmesi sırasında çerçeve tarafından çağrılır OnCreate.

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

Parametreler

lpcs
Windows CREATESTRUCT yapısının işaretçisi.

pContext
Bir yapıya işaretçi CCreateContext .

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu işlevi hiçbir zaman çağırmayın.

Bu işlevin varsayılan uygulaması, mümkünse içinde pContextsağlanan bilgilerden bir CView nesne oluşturur.

Nesnede geçirilen değerleri geçersiz kılmak veya çerçeve penceresinin CCreateContext ana istemci alanındaki denetimlerin oluşturulma şeklini değiştirmek için bu işlevi geçersiz kılın. CCreateContext Geçersiz kılabileceğiniz üyeler sınıfında CCreateContext açıklanmıştır.

Not

Yapıda geçirilen değerleri değiştirmeyin CREATESTRUCT . Bunlar yalnızca bilgilendirme amaçlıdır. İlk pencere dikdörtgenini geçersiz kılmak istiyorsanız, örneğin üye işlevini PreCreateWindowgeçersiz kılınCWnd.

CFrameWnd::OnHideMenuBar

Sistem geçerli MFC uygulamasında menü çubuğunu gizlemek üzereyken bu işlev çağrılır.

virtual void OnHideMenuBar();

Açıklamalar

Bu olay işleyicisi, sistem menüyü gizlemek üzereyken uygulamanızın özel eylemler gerçekleştirmesini sağlar. Menünün gizlenmesini önleyemezsiniz, ancak örneğin, menü stilini veya durumunu almak için diğer yöntemleri çağırabilirsiniz.

CFrameWnd::OnSetPreviewMode

Uygulamanın ana çerçeve penceresini baskı önizleme moduna ve dışına ayarlamak için bu üye işlevini çağırın.

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

Parametreler

bPreview
Uygulamanın baskı önizleme moduna alınıp alınmayacağını belirtir. Önizleme modunu iptal etmek TRUE için baskı önizlemeye FALSE yerleştirecek şekilde ayarlayın.

pState
Bir yapıya işaretçi CPrintPreviewState .

Açıklamalar

Varsayılan uygulama tüm standart araç çubuklarını devre dışı bırakır ve ana menüyü ve ana istemci penceresini gizler. Bu, MDI çerçeve pencerelerini geçici SDI çerçeve pencerelerine dönüştürür.

Baskı önizleme sırasında denetim çubuklarının ve diğer çerçeve penceresi bölümlerinin gizlenip gösterilmesini özelleştirmek için bu üye işlevini geçersiz kılın. Geçersiz kılınan sürüm içinden temel sınıf uygulamasını çağırın.

CFrameWnd::OnShowMenuBar

Sistem geçerli MFC uygulamasında menü çubuğunu görüntülemek üzereyken bu işlev çağrılır.

virtual void OnShowMenuBar();

Açıklamalar

Bu olay işleyicisi, menü görüntülenmek üzereyken uygulamanızın özel eylemler gerçekleştirmesini sağlar. Menünün görüntülenmesini önleyemezsiniz, ancak örneğin, menü stilini veya durumunu almak için diğer yöntemleri çağırabilirsiniz.

CFrameWnd::OnUpdateControlBarMenu

İlişkili menü güncelleştirildiğinde çerçeve tarafından çağrılır.

afx_msg void OnUpdateControlBarMenu(CCmdUI* pCmdUI);

Parametreler

pCmdUI
Güncelleştirme komutunu oluşturan menüyü temsil eden bir CCmdUI nesne işaretçisi. Güncelleştirme işleyicisi, kullanıcı arabirimini CCmdUI güncelleştirmek için aracılığıyla nesnesinin pCmdUI üye işlevini çağırırEnable.

CFrameWnd::RecalcLayout

Standart denetim çubukları açık veya kapalı olduğunda veya çerçeve penceresi yeniden boyutlandırıldığında çerçeve tarafından çağrılır.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parametreler

bNotify
Çerçeve penceresi için etkin yerinde öğesinin düzen değişikliği bildirimi alıp almadığını belirler. ise TRUE, öğeye bildirim gönderilir; aksi takdirde FALSE.

Açıklamalar

Bu üye işlevinin varsayılan uygulaması, hem çerçevedeki CWnd hem de ana istemci penceresindeki (genellikle veya CView MDICLIENT) tüm denetim çubuklarını yeniden konumlandırmak için üye işlevini RepositionBars çağırır.

Çerçeve penceresinin düzeni değiştikten sonra denetim çubuklarının görünümünü ve davranışını denetlemek için bu üye işlevini geçersiz kılın. Örneğin, denetim çubuklarını açtığınızda veya kapattığınızda veya başka bir denetim çubuğu eklediğinizde bunu çağırabilirsiniz.

CFrameWnd::rectDefault

Windows'un pencerenin başlangıç boyutunu ve konumunu seçmesine izin vermek için bir pencere oluştururken bu statik CRect alanı parametre olarak geçirin.

static AFX_DATA const CRect rectDefault;

CFrameWnd::SaveBarState

Çerçeve penceresine ait her denetim çubuğu hakkındaki bilgileri depolamak için bu işlevi çağırın.

void SaveBarState(LPCTSTR lpszProfileName) const;

Parametreler

lpszProfileName
Başlatma dosyasındaki bir bölümün veya Windows kayıt defterindeki durum bilgilerinin depolandığı anahtarın adı.

Açıklamalar

Bu bilgiler kullanılarak LoadBarStatebaşlatma dosyasından okunabilir. Depolanan bilgiler görünürlük, yatay/dikey yönlendirme, yerleştirme durumu ve denetim çubuğu konumunu içerir.

CFrameWnd::SetActivePreviewView

Belirtilen görünümü Zengin Önizleme için etkin görünüm olarak gösterir.

void SetActivePreviewView(CView* pViewNew);

Parametreler

pViewNew
Etkinleştirilecek görünümün işaretçisi.

Açıklamalar

CFrameWnd::SetActiveView

Etkin görünümü ayarlamak için bu üye işlevini çağırın.

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

Parametreler

pViewNew
Bir nesnenin işaretçisini CView belirtir veya NULL etkin bir görünüm için belirtir.

bNotify
Görünümün etkinleştirme bildirimi alınıp alınmayacağını belirtir. OnActivateView iseTRUE, yeni görünüm için çağrılır; ise FALSEçağrılmaz.

Açıklamalar

Kullanıcı odağı çerçeve penceresindeki bir görünüme değiştirdiği için çerçeve bu işlevi otomatik olarak çağırır. Odağı belirtilen görünüme değiştirmek için açıkça çağırabilirsiniz SetActiveView .

CFrameWnd::SetDockState

Bir nesnede CDockState depolanan durum bilgilerini çerçeve penceresinin denetim çubuklarına uygulamak için bu üye işlevini çağırın.

void SetDockState(const CDockState& state);

Parametreler

state
Depolanan durumu çerçeve penceresinin denetim çubuklarına uygulayın.

Açıklamalar

Denetim çubuklarının önceki bir durumunu geri yüklemek için, veya Serializeile CDockState::LoadState depolanmış durumu yükleyebilir, ardından bunu çerçeve penceresinin denetim çubuklarına uygulamak için kullanabilirsinizSetDockState. Önceki durum ile nesnesinde CDockState depolanır GetDockState

CFrameWnd::SetMenuBarState

Geçerli MFC uygulamasındaki menünün görüntüleme durumunu gizli veya görüntülenecek şekilde ayarlar.

virtual BOOL SetMenuBarState(DWORD nState);

Parametreler

nState
[in] Menünün görüntüleneceğini veya gizlenmeyeceğini belirtir. nState parametresi aşağıdaki değerlere sahip olabilir:

• AFX_MBS_VISIBLE (0x01) - Gizliyse menüyü görüntüler, ancak görünür durumdaysa hiçbir etkisi olmaz.
• AFX_MBS_HIDDEN (0x02) - Görünür durumdaysa menüyü gizler, ancak gizliyse hiçbir etkisi olmaz.

Dönüş Değeri

TRUE bu yöntem menü durumunu başarıyla değiştirirse; aksi takdirde , FALSE.

Açıklamalar

Bir çalışma zamanı hatası oluşursa, bu yöntem Hata Ayıklama modunda onaylar ve sınıfından CException türetilen bir özel durum oluşturur.

CFrameWnd::SetMenuBarVisibility

Geçerli MFC uygulamasındaki menünün varsayılan davranışını gizli veya görünür olacak şekilde ayarlar.

virtual void SetMenuBarVisibility(DWORD nStyle);

Parametreler

nStyle
[in] Menünün varsayılan olarak gizli mi yoksa görünür mü olduğunu ve odakta olduğunu belirtir. nStyle parametresi aşağıdaki değerlere sahip olabilir:

• AFX_MBV_KEEPVISIBLE (0x01) - Menü her zaman görüntülenir ve varsayılan olarak odak yoktur.

• AFX_MBV_DISPLAYONFOCUS (0x02) - Menü varsayılan olarak gizlidir. Menü gizliyse, menüyü görüntülemek ve odağı vermek için ALT tuşuna basın. Menü görüntüleniyorsa, menüyü gizlemek için ALT veya ESC tuşuna basın.

• AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10 (0x06) - Menü varsayılan olarak gizlidir. Menü gizliyse, F10 tuşuna basarak menüyü görüntüleyin ve odağı verin. Menü görüntüleniyorsa, odağı açmak veya menüden kapatmak için F10 tuşuna basın. Menü, gizlemek için ALT veya ESC tuşuna basana kadar görüntülenir.

Açıklamalar

parametresinin nStyle değeri geçerli değilse, bu yöntem Hata Ayıklama modunda onaylar ve Yayın modunda yükseltir CInvalidArgException . Diğer çalışma zamanı hataları durumunda, bu yöntem Hata Ayıklama modunda onaylar ve sınıfından CException türetilen bir özel durum oluşturur.

Bu yöntem, Windows Vista ve üzeri için yazılmış uygulamalarda menülerin durumunu etkiler.

CFrameWnd::SetMessageText

Durum çubuğu bölmesine kimliği 0 olan bir dize yerleştirmek için bu işlevi çağırın.

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

Parametreler

lpszText
Durum çubuğuna yerleştirilecek dizeyi gösterir.

nID
Durum çubuğuna yerleştirilecek dizenin dize kaynak kimliği.

Açıklamalar

Bu genellikle durum çubuğunun en sol ve en uzun bölmesidir.

CFrameWnd::SetProgressBarPosition

Görev çubuğunda görüntülenen Windows 7 ilerleme çubuğu için geçerli konumu ayarlar.

void SetProgressBarPosition(int nProgressPos);

Parametreler

nProgressPos
Ayarlanacağı konumu belirtir. tarafından SetProgressBarRangeayarlanan aralık içinde olmalıdır.

Açıklamalar

CFrameWnd::SetProgressBarRange

Görev çubuğunda görüntülenen Windows 7 ilerleme çubuğu aralığını ayarlar.

void SetProgressBarRange(
    int nRangeMin,
    int nRangeMax);

Parametreler

nRangeMin
En düşük değer.

nRangeMax
En büyük değer.

Açıklamalar

CFrameWnd::SetProgressBarState

Görev çubuğu düğmesinde görüntülenen ilerleme göstergesinin türünü ve durumunu ayarlar.

void SetProgressBarState(TBPFLAG tbpFlags);

Parametreler

tbpFlags
İlerleme düğmesinin geçerli durumunu denetleen bayraklar. Tüm durumlar birbirini dışladığı için aşağıdaki bayraklardan yalnızca birini belirtin: TBPF_NOPROGRESS, TBPF_INDETERMINATE, TBPF_NORMAL, TBPF_ERROR, . TBPF_PAUSED

Açıklamalar

CFrameWnd::SetTaskbarOverlayIcon

Aşırı yüklendi. Uygulama durumunu belirtmek veya kullanıcıya bildirmek için görev çubuğu düğmesine katman uygular.

BOOL SetTaskbarOverlayIcon(
    UINT nIDResource,
    LPCTSTR lpcszDescr);

BOOL SetTaskbarOverlayIcon(
    HICON hIcon,
    LPCTSTR lpcszDescr);

Parametreler

nIDResource
Katman olarak kullanılacak simgenin Kaynak Kimliğini belirtir. Ayrıntılar için hIcon açıklamaya bakın.

lpcszDescr
Erişilebilirlik amacıyla katman tarafından iletilen bilgilerin alternatif metin sürümünü sağlayan bir dize işaretçisi.

hIcon
Katman olarak kullanılacak simgenin tutamacı. Bu, inç başına 96 nokta (dpi) ile 16x16 piksel ölçülerinde küçük bir simge olmalıdır. Görev çubuğu düğmesine zaten bir katman simgesi uygulanmışsa, mevcut katman değiştirilir. Bu değer olabilir NULL. Bir NULL değerin nasıl işleneceğini, görev çubuğu düğmesinin tek bir pencereyi mi yoksa bir pencere grubunu mu temsil ettiğine bağlıdır. Artık gerekli olmadığında uygulamanın serbest hIcon kalması, çağıran uygulamanın sorumluluğundadır.

Dönüş Değeri

TRUE başarılı olursa; FALSE işletim sistemi sürümü Windows 7'den küçükse veya simge ayarlanırken bir hata oluşursa.

Açıklamalar

CFrameWnd::SetTitle

Pencere nesnesinin başlığını ayarlar.

void SetTitle(LPCTSTR lpszTitle);

Parametreler

lpszTitle
Pencere nesnesinin başlığını içeren bir karakter dizesi işaretçisi.

CFrameWnd::ShowControlBar

Denetim çubuğunu göstermek veya gizlemek için bu üye işlevini çağırın.

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

Parametreler

pBar
Gösterilecek veya gizlenecek denetim çubuğunun işaretçisi.

bShow
ise TRUE, denetim çubuğunun gösterileceğini belirtir. ise FALSE, denetim çubuğunun gizlenecek olduğunu belirtir.

bDelay
ise TRUE, denetim çubuğunu göstermeyi geciktirin. ise FALSE, denetim çubuğunu hemen gösterin.

CFrameWnd::ShowOwnedWindows

Nesnenin alt öğeleri olan tüm pencereleri göstermek için bu üye işlevini çağırın CFrameWnd .

void ShowOwnedWindows(BOOL bShow);

Parametreler

bShow
Sahip olunan pencerelerin gösterileceğini veya gizlenip gizlenmeyeceğini belirtir.

Ayrıca bkz.

CWnd Sınıf
Hiyerarşi Grafiği
CWnd Sınıf
CMDIFrameWnd Sınıf
CMDIChildWnd Sınıf
CView Sınıf
CDocTemplate Sınıf
CRuntimeClass Yapı