CMFCKeyMapDialog osztály

Megjegyzés:

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

Az CMFCKeyMapDialog osztály támogatja azt a vezérlőt, amely parancsokat képez le a billentyűzeten lévő billentyűkre.

Szemantika

class CMFCKeyMapDialog : public CDialogEx

Tagok

Nyilvános konstruktorok

Név	Description
CMFCKeyMapDialog::CMFCKeyMapDialog	Egy CMFCKeyMapDialog objektumot hoz létre.

Nyilvános metódusok

Név	Description
CMFCKeyMapDialog::D oModal	Megjeleníti a billentyűzetleképezés párbeszédpanelt.

Védett metódusok

Név	Description
CMFCKeyMapDialog::FormatItem	A keretrendszer meghívta egy kulcsleképezést leíró sztring létrehozásához. Alapértelmezés szerint a sztring tartalmazza a parancsnevet, a használt billentyűparancsokat és a billentyűparancs leírását.
CMFCKeyMapDialog::GetCommandKeys	Lekéri a megadott parancshoz társított billentyűparancsok listáját tartalmazó sztringet.
CMFCKeyMapDialog::OnInsertItem	A keretrendszer meghívta, mielőtt új elemet szúr be a billentyűzetleképezési vezérlőt támogató belső listavezérlőbe.
CMFCKeyMapDialog::OnPrintHeader	A keretrendszer meghívta, hogy a billentyűzettérkép fejlécét egy új oldalra nyomtassa ki.
CMFCKeyMapDialog::OnPrintItem	A keretrendszer meghívta egy billentyűzetleképezési elem nyomtatásához.
CMFCKeyMapDialog::OnSetColumns	A keretrendszer meghívta, hogy a billentyűzetleképezési vezérlőt támogató belső listavezérlő oszlopainak feliratait állítsa be.
CMFCKeyMapDialog::P rintKeyMap	A keretrendszer meghívta, amikor egy felhasználó a Nyomtatás gombra kattint.
CMFCKeyMapDialog::SetColumnsWidth	A keretrendszer meghívta a billentyűzetleképezési vezérlőt támogató belső listavezérlő oszlopainak szélességét.

Megjegyzések

CMFCKeyMapDialog Az osztály használatával valósíthat meg egy átméretezhető billentyűzetleképezési párbeszédpanelt. A párbeszédpanel listanézet-vezérlővel jeleníti meg a billentyűparancsokat és a hozzájuk tartozó parancsokat.

Ha az CMFCKeyMapDialog osztályt egy alkalmazásban szeretné használni, adjon meg egy mutatót a fő keretablaknak paraméterként a CMFCKeyMapDialog konstruktornak. Ezután hívja meg a DoModal metódust egy modális párbeszédpanel elindításához.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCKeyMapDialog

Requirements

Fejléc: afxkeymapdialog.h

CMFCKeyMapDialog::CMFCKeyMapDialog

Egy CMFCKeyMapDialog objektumot hoz létre.

CMFCKeyMapDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bEnablePrint=FALSE);

Paraméterek

pWndParentFrame
[in] Az objektum szülőablakára CMFCKeyMapDialog mutató mutató.

bEnablePrint
[in] IGAZ, ha a gyorsítókulcsok listája nyomtatható; egyéb esetben HAMIS. Az alapértelmezett HAMIS.

Megjegyzések

Example

Az alábbi példa bemutatja, hogyan hozhat létre egy objektumot az CMFCKeyMapDialog osztályból. Ez a példa a Visual Studio Demo-minta része.

// this points to a CMainFrame class which extends the 
// CMDIFrameWndEx class
CMFCKeyMapDialog dlg(this, TRUE /* Enable Print */);

CMFCKeyMapDialog::D oModal

Megjeleníti a billentyűzetleképezés párbeszédpanelt.

virtual INT_PTR DoModal();

Visszaadott érték

A CDialog::EndDialog metódusnak átadott aláírt egész szám, például IDOK vagy IDCANCEL. A metódus viszont bezárja a párbeszédpanelt. További információ: CDialog::D oModal.

Megjegyzések

A billentyűzetleképezési párbeszédpanel lehetővé teszi a gyorsítóbillentyűk kiválasztását és hozzárendelését a parancsok különböző kategóriáihoz. Emellett a kijelölt gyorsítókulcsokat és azok leírását is átmásolhatja a vágólapra.

CMFCKeyMapDialog::FormatItem

A keretrendszer meghívta egy kulcsleképezést leíró sztring létrehozásához. Alapértelmezés szerint a sztring tartalmazza a parancsnevet, a használt billentyűparancsokat és a billentyűparancs leírását.

virtual CString FormatItem(int nItem) const;

Paraméterek

nItem
[in] Egy elem nullaalapú indexe a kulcsleképezések belső listájában.

Visszaadott érték

A CString formázott elem szövegét tartalmazó objektum.

Megjegyzések

CMFCKeyMapDialog::GetCommandKeys

Sztringértéket kér le. A sztring egy adott parancshoz társított billentyűparancsok listáját tartalmazza.

virtual CString GetCommandKeys(UINT uiCmdID) const;

Paraméterek

uiCmdID
[in] Parancsazonosító.

Visszaadott érték

A megadott parancshoz társított billentyűparancsok pontosvesszővel tagolt (';') listája.

Megjegyzések

CMFCKeyMapDialog::OnInsertItem

A keretrendszer meghívta, mielőtt új elemet szúr be egy belső listavezérlőbe, amely támogatja a billentyűzetleképezési vezérlőt.

virtual void OnInsertItem(
    CMFCToolBarButton* pButton,
    int nItem);

Paraméterek

pButton
[in] Egérmutató egy eszköztárgombhoz, amellyel a billentyűzetbillentyű-kombinációk parancsnévre és leírásra képezhetőek le. A kulcstérkép-elem egy belső listavezérlőben van tárolva.

nItem
[in] Nulla alapú index, amely meghatározza, hogy hová szúrja be az új kulcstérkép-elemet a belső listavezérlőbe.

Megjegyzések

CMFCKeyMapDialog::OnPrintHeader

A keretrendszer meghívta, hogy a billentyűzettérkép fejlécét egy új oldalra nyomtassa ki.

virtual int OnPrintHeader(
    CDC& dc,
    int nPage,
    int cx) const;

Paraméterek

Dc
[in] A nyomtató eszközkörnyezete.

nPage
[in] A nyomtatandó oldalszám.

Cx
[in] Az élőfej vízszintes eltolása képpontban.

Visszaadott érték

Ha sikeres, a nyomtatott szöveg magassága. További információt a CDC::D rawText Visszatérési érték szakaszában talál.

Megjegyzések

A keretrendszer ezzel a módszerrel nyomtatja ki a billentyűzettérképet. Ez a metódus alapértelmezés szerint kinyomtatja az oldalszámot, az alkalmazás nevét és a párbeszédpanel címét.

CMFCKeyMapDialog::OnPrintItem

A keretrendszer meghívta egy billentyűzetleképezési elem nyomtatásához.

virtual int OnPrintItem(
    CDC& dc,
    int nItem,
    int y,
    int cx,
    BOOL bCalcHeight) const;

Paraméterek

Dc
[in] A nyomtató eszközkörnyezete.

nItem
[in] A nyomtatandó elem nulla alapú indexe.

y
[in] Az oldal teteje és az elem pozíciója közötti függőleges eltolás.

Cx
[in] Az oldal bal oldala és az elem pozíciója közötti vízszintes eltolás.

bCalcHeight
[in] IGAZ a nyomtatási elem legjobb magasságának kiszámításához; HAMIS a nyomtatási elem csonkításához, hogy az illeszkedjen az alapértelmezett helyre.

Visszaadott érték

A nyomtatott elem magassága.

Megjegyzések

A keretrendszer meghívja ezt a metódust egy kulcstérkép párbeszédpanelelem kinyomtatására. Ez a metódus alapértelmezés szerint kinyomtatja az elem parancsnevét, billentyűparancsait és parancsleírását.

CMFCKeyMapDialog::OnSetColumns

A keretrendszer meghívta, hogy a billentyűzetleképezési vezérlőt támogató belső listavezérlő oszlopainak feliratait állítsa be.

virtual void OnSetColumns();

Megjegyzések

Ez a metódus alapértelmezés szerint három erőforrásból szerzi be az oszlopok feliratait. A parancsoszlop felirata IDS_AFXBARRES_COMMAND, a kulcsoszlop felirata IDS_AFXBARRES_KEYS, a leírás oszlopfelirata pedig IDS_AFXBARRES_DESCRIPTION.

CMFCKeyMapDialog::P rintKeyMap

A keretrendszer meghívta, amikor egy felhasználó a Nyomtatás gombra kattint.

virtual void PrintKeyMap();

Megjegyzések

A PrintKeyMap metódus kinyomtatja a kulcstérképet. Elindít egy új nyomtatási feladatot, majd ismételten meghívja a CMFCKeyMapDialog::OnPrintHeader és CMFCKeyMapDialog::OnPrintItem metódusokat, amíg az összes kulcsleképezés ki nem lesz nyomtatva.

CMFCKeyMapDialog::SetColumnsWidth

A keretrendszer meghívta a billentyűzetleképezési vezérlőt támogató belső listavezérlő oszlopainak szélességét.

virtual void SetColumnsWidth();

Megjegyzések

Ez a módszer a belső listavezérlő oszlopait alapértelmezett szélességre állítja. Először a billentyűparancsok oszlopának szélessége lesz kiszámítva. Ezután a rendszer a fennmaradó szélesség egyharmadát a parancsoszlophoz rendeli, a fennmaradó kétharmadot pedig a leírás oszlophoz.

Lásd még

hierarchiadiagram
osztályok
CKeyboardManager osztály