CMFCRibbonEdit – třída

Implementuje ovládací prvek pro úpravy umístěný na pásu karet.

Syntaxe

class CMFCRibbonEdit : public CMFCRibbonButton

Členové

Veřejné konstruktory

Název	Popis
CMFCRibbonEdit::CMFCRibbonEdit	CMFCRibbonEdit Vytvoří objekt.

Veřejné metody

Název	Popis
CMFCRibbonEdit::CanBeStretched	Určuje, zda výška CMFCRibbonEdit ovládacího prvku může vertikálně navýšit na výšku řádku pásu karet.
CMFCRibbonEdit::CMFCRibbonEdit	CMFCRibbonEdit Vytvoří objekt.
CMFCRibbonEdit::CopyFrom	Zkopíruje stav zadaného CMFCRibbonEdit objektu do aktuálního CMFCRibbonEdit objektu.
CMFCRibbonEdit::CreateEdit	Vytvoří nové textové pole pro CMFCRibbonEdit objekt.
CMFCRibbonEdit::D estroyCtrl	CMFCRibbonEdit Zničí objekt.
CMFCRibbonEdit::D ropDownList	Rozbalí seznam.
CMFCRibbonEdit::EnableSpinButtons	Povolí a nastaví rozsah číselníku textového pole.
CMFCRibbonEdit::GetCompactSize	Načte kompaktní velikost objektu CFMCRibbonEdit .
CMFCRibbonEdit::GetEditText	Načte text v textovém poli.
CMFCRibbonEdit::GetIntermediateSize	Načte zprostředkující velikost objektu CMFCRibbonEdit .
CMFCRibbonEdit::GetTextAlign	Načte zarovnání textu v textovém poli.
CMFCRibbonEdit::GetWidth	Načte šířku ovládacího prvku v pixelech CMFCRibbonEdit .
CMFCRibbonEdit::HasCompactMode	Určuje, zda je možné komprimovat velikost CMFCRibbonEdit zobrazení ovládacího prvku.
CMFCRibbonEdit::HasFocus	Určuje, zda CMFCRIbbonEdit má ovládací prvek fokus.
CMFCRibbonEdit::HasLargeMode	Určuje, zda může být velikost CMFCRibbonEdit zobrazení ovládacího prvku velká.
CMFCRibbonEdit::HasSpinButtons	Určuje, jestli má textové pole číselník.
CMFCRibbonEdit::IsHighlighted	Určuje, jestli CMFCRibbonEdit je ovládací prvek zvýrazněný.
CMFCRibbonEdit::OnAfterChangeRect	Volá se architekturou, když se změní rozměry obdélníku zobrazení pro CMFCRibbonEdit ovládací prvek.
CMFCRibbonEdit::OnDraw	Volá se rozhraním pro vykreslení CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::OnDrawLabelAndImage	Volá se rozhraním pro vykreslení popisku a obrázku CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::OnDrawOnList	Volá se rozhraním pro vykreslení CMFCRibbonEdit ovládacího prvku v seznamu příkazů.
CMFCRibbonEdit::OnEnable	Volá se rozhraním pro povolení nebo zakázání CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::OnHighlight	Volá se rozhraním, když ukazatel vstoupí nebo opustí hranice CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::OnKey	Volá se rozhraním, když uživatel stiskne klávesu a CMFCRibbonEdit ovládací prvek má fokus.
CMFCRibbonEdit::OnLButtonDown	Volá se rozhraním CMFCRibbonEdit pro aktualizaci ovládacího prvku, když uživatel stiskne levé tlačítko myši na ovládacím prvku.
CMFCRibbonEdit::OnLButtonUp	Volá se rozhraním, když uživatel uvolní levé tlačítko myši.
CMFCRibbonEdit::OnRTLChanged	Volá se rozhraním pro aktualizaci CMFCRibbonEdit ovládacího prvku při změně směru rozložení.
CMFCRibbonEdit::OnShow	Volá se rozhraním pro zobrazení nebo skrytí CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::Redraw	Aktualizuje zobrazení CMFCRibbonEdit ovládacího prvku.
CMFCRibbonEdit::SetACCData	Nastaví data přístupnosti objektu CMFCRibbonEdit .
CMFCRibbonEdit::SetEditText	Nastaví text v textovém poli.
CMFCRibbonEdit::SetTextAlign	Nastaví zarovnání textu textového pole.
CMFCRibbonEdit::SetWidth	Nastaví šířku textového pole pro CMFCRibbonEdit ovládací prvek.

Poznámky

Příklad

Následující příklad ukazuje, jak vytvořit CMFCRibbonEdit objekt, zobrazit číselná tlačítka vedle ovládacího prvku pro úpravy a nastavit text ovládacího prvku pro úpravy. Tento fragment kódu je součástí ukázky MS Office 2007 Demo.

CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));

Požadavky

Hlavička: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

Určuje, zda výška ovládacího prvku CMFCRibbonEdit může vertikálně navýšit na výšku řádku pásu karet.

virtual BOOL CanBeStretched();

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

CMFCRibbonEdit::CMFCRibbonEdit

Vytvoří CMFCRibbonEdit objektu.

CMFCRibbonEdit(
    UINT nID,
    int nWidth,
    LPCTSTR lpszLabel = NULL,
    int nImage = -1);

CMFCRibbonEdit();

Parametry

Nid
[v] ID příkazu pro CMFCRibbonEdit ovládací prvek.

nWidth
[v] Šířka textového pole CMFCRibbonEdit ovládacího prvku v pixelech.

lpszLabel
[v] Popisek CMFCRibbonEdit ovládacího prvku.

nImage
[v] Index malého obrázku CMFCRibbonEdit , který se má použít pro ovládací prvek Kolekci malých obrázků udržuje nadřazená kategorie pásu karet.

Poznámky

Ovládací CMFCRibbonEdit prvek nepoužívá velký obrázek.

CMFCRibbonEdit::CopyFrom

Zkopíruje stav zadaného CMFCRibbonEdit objektu do aktuální CMFCRibbonEdit objektu.

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametry

Src
[v] Zdrojový CMFCRibbonEdit objekt.

Poznámky

Parametr src musí být typu CMFCRibbonEdit.

CMFCRibbonEdit::CreateEdit

Vytvoří nové textové pole pro CMFCRibbonEdit objektu.

virtual CMFCRibbonRichEditCtrl* CreateEdit(
    CWnd* pWndParent,
    DWORD dwEditStyle);

Parametry

pWndParent
[v] Ukazatel na nadřazené okno objektu CMFCRibbonEdit .

dwEditStyle
[v] Určuje styl textového pole. Styly oken uvedené v části Poznámky můžete kombinovat se styly ovládacích prvků pro úpravy popsané v sadě Windows SDK.

Návratová hodnota

Ukazatel na nové textové pole, pokud byla metoda úspěšná; v opačném případě null.

Poznámky

Přepsat tuto metodu v odvozené třídě vytvořit vlastní textové pole.

U textového pole můžete použít následující styly oken:

• WS_CHILD

• WS_VISIBLE

• WS_DISABLED

• WS_GROUP

• WS_TABSTOP

CMFCRibbonEdit::D estroyCtrl

Zničí CMFCRibbonEdit objekt.

virtual void DestroyCtrl();

Poznámky

CMFCRibbonEdit::D ropDownList

Rozbalí seznam.

virtual void DropDownList();

Poznámky

Ve výchozím nastavení tato metoda nic nedělá. Přepište tuto metodu tak, aby rozevírací seznam.

CMFCRibbonEdit::EnableSpinButtons

Povolí a nastaví rozsah číselníku textového pole.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parametry

nMin
[v] Minimální hodnota číselníku.

nMax
[v] Maximální hodnota číselníku.

Poznámky

Číselná tlačítka zobrazují šipku nahoru a dolů a umožňují uživatelům procházet pevnou sadu hodnot.

CMFCRibbonEdit::GetCompactSize

Načte kompaktní velikost CMFCRibbonEdit objektu.

virtual CSize GetCompactSize(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit objekt.

Návratová hodnota

Kompaktní velikost objektu CMFCRibbonEdit .

Poznámky

CMFCRibbonEdit::GetEditText

Načte text v textovém poli.

CString GetEditText() const;

Návratová hodnota

Text v textovém poli.

Poznámky

CMFCRibbonEdit::GetIntermediateSize

Načte zprostředkující velikost objektu CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit objekt.

Návratová hodnota

Zprostředkující velikost objektu CMFCRibbonEdit .

Poznámky

CMFCRibbonEdit::GetTextAlign

Načte zarovnání textu v textovém poli.

int GetTextAlign() const;

Návratová hodnota

Výčtová hodnota zarovnání textu Možné hodnoty najdete v části Poznámky.

Poznámky

Vrácená hodnota je jedním z následujících stylů ovládacích prvků pro úpravy:

• ES_LEFT pro zarovnání doleva

• ES_CENTER pro zarovnání na střed

• ES_RIGHT pro zarovnání doprava

Další informace o těchto stylech naleznete v tématu Upravit styly ovládacích prvků.

CMFCRibbonEdit::GetWidth

Načte šířku ovládacího prvku CMFCRibbonEdit v pixelech.

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parametry

bInFloatyMode
[v] TRUE, pokud CMFCRibbonEdit je ovládací prvek v plovoucím režimu; jinak NEPRAVDA.

Návratová hodnota

Šířka ovládacího prvku v pixelech CMFCRibbonEdit .

Poznámky

CMFCRibbonEdit::HasCompactMode

Určuje, zda je možné komprimovat velikost zobrazení pro ovládací prvek CMFCRibbonEdit .

virtual BOOL HasCompactMode() const;

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Ve výchozím nastavení tato metoda vždy vrátí hodnotu TRUE. Přepište tuto metodu, aby bylo možné určit, zda je možné komprimovat velikost zobrazení.

CMFCRibbonEdit::HasFocus

Určuje, jestli má ovládací prvek CMFCRibbonEdit fokus.

virtual BOOL HasFocus() const;

Návratová hodnota

TRUE, pokud CMFCRibbonEdit má ovládací prvek fokus; jinak NEPRAVDA.

Poznámky

CMFCRibbonEdit::HasLargeMode

Určuje, zda může být velikost zobrazení pro CMFCRibbonEdit ovládací prvek velká.

virtual BOOL HasLargeMode() const;

Návratová hodnota

Vždy vrátí hodnotu FALSE.

Poznámky

Ve výchozím nastavení tato metoda vždy vrací HODNOTU FALSE. Přepište tuto metodu, aby bylo možné určit, zda může být velikost zobrazení velká.

CMFCRibbonEdit::HasSpinButtons

Určuje, jestli má textové pole číselník.

virtual BOOL HasSpinButtons() const;

Návratová hodnota

TRUE, pokud textové pole má číselník tlačítko; jinak NEPRAVDA.

Poznámky

CMFCRibbonEdit::IsHighlighted

Určuje, zda je zvýrazněný ovládací prvek CMFCRibbonEdit .

virtual BOOL IsHighlighted() const;

Návratová hodnota

TRUE, pokud CMFCRibbonEdit je ovládací prvek zvýrazněn; jinak NEPRAVDA.

Poznámky

CMFCRibbonEdit::OnAfterChangeRect

Volané architekturou, když se změní rozměry obdélníku zobrazení pro CMFCRibbonEdit řízení.

virtual void OnAfterChangeRect(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit ovládací prvek.

Poznámky

CMFCRibbonEdit::OnDraw

Volal rámec pro kreslení CMFCRibbonEdit řízení.

virtual void OnDraw(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit ovládací prvek.

Poznámky

CMFCRibbonEdit::OnDrawLabelAndImage

Volané architekturou pro vykreslení popisku a obrázku pro CMFCRibbonEdit ovládacího prvku.

virtual void OnDrawLabelAndImage(CDC* pDC);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit ovládací prvek.

Poznámky

CMFCRibbonEdit::OnDrawOnList

Volané architekturou pro kreslení CMFCRibbonEdit ovládací prvek v seznamu příkazů.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Parametry

pDC
[v] Ukazatel na kontext zařízení pro CMFCRibbonEdit ovládací prvek.

strText
[v] Zobrazený text.

nTextOffset
[v] Vzdálenost v pixelech od levé strany seznamu k zobrazovaného textu.

Rect
[v] Obdélník zobrazení CMFCRibbonEdit ovládacího prvku.

BIsSelected
[v] Tento parametr se nepoužívá.

bHighlighted
[v] Tento parametr se nepoužívá.

Poznámky

V seznamu příkazů se zobrazí ovládací prvky pásu karet, které uživatelům umožní přizpůsobit panel nástrojů Rychlý přístup.

CMFCRibbonEdit::OnEnable

Volané rozhraním pro povolení nebo zakázání CMFCRibbonEdit řízení.

virtual void OnEnable(BOOL bEnable);

Parametry

bEnable
[v] TRUE pro povolení ovládacího prvku; NEPRAVDA pro zakázání ovládacího prvku.

Poznámky

CMFCRibbonEdit::OnHighlight

Volá se architekturou, když ukazatel vstoupí nebo opustí hranice CMFCRibbonEdit ovládacího prvku.

virtual void OnHighlight(BOOL bHighlight);

Parametry

bHighlight
[v] TRUE, pokud je ukazatel v mezích CMFCRibbonEdit ovládacího prvku; jinak NEPRAVDA.

Poznámky

CMFCRibbonEdit::OnKey

Volané architekturou, když uživatel stiskne klávesu a CMFCRibbonEdit ovládací prvek má fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametry

bIsMenuKey
[v] TRUE, pokud se v popisu zobrazí místní nabídka; jinak NEPRAVDA.

Návratová hodnota

TRUE, pokud byla událost zpracována; jinak NEPRAVDA.

Poznámky

CMFCRibbonEdit::OnLButtonDown

Volané rozhraním pro aktualizaci CMFCRibbonEdit ovládacího prvku, když uživatel stiskne levé tlačítko myši na ovládacím prvku.

virtual void OnLButtonDown(CPoint point);

Parametry

bod
[v] Tento parametr se nepoužívá.

Poznámky

CMFCRibbonEdit::OnLButtonUp

Volá se rozhraním, když uživatel uvolní levé tlačítko myši.

virtual void OnLButtonUp(CPoint point);

Parametry

bod
[v] Tento parametr se nepoužívá.

Poznámky

CMFCRibbonEdit::OnRTLChanged

Volá se rozhraním pro aktualizaci ovládacího prvku CMFCRibbonEdit při změně směru rozložení.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[v] TRUE, pokud je rozložení zprava doleva; NEPRAVDA, pokud je rozložení zleva doprava.

Poznámky

CMFCRibbonEdit::OnShow

Volané rozhraním k zobrazení nebo skrytí CMFCRibbonEdit ovládacího prvku.

virtual void OnShow(BOOL bShow);

Parametry

BShow
[v] TRUE zobrazit ovládací prvek; FALSE pro skrytí ovládacího prvku.

Poznámky

CMFCRibbonEdit::Redraw

Aktualizuje zobrazení ovládacího prvku CMFCRibbonEdit .

virtual void Redraw();

Poznámky

Tato metoda překreslí obdélník zobrazení pro CMFCRibbonEdit objekt nepřímo volání CWnd::RedrawWindow s RDW_INVALIDATE, RDW_ERASE a RDW_UPDATENOW příznaky set.

CMFCRibbonEdit::SetACCData

Nastaví data přístupnosti pro CMFCRibbonEdit objekt.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametry

pParent
Ukazatel na nadřazené okno objektu CMFCRibbonEdit .

data
Data přístupnosti objektu CMFCRibbonEdit .

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

CMFCRibbonEdit::SetEditText

Nastaví text v textovém poli.

void SetEditText(CString strText);

Parametry

strText
[v] Text textového pole.

CMFCRibbonEdit::SetTextAlign

Nastaví zarovnání textu textového pole.

void SetTextAlign(int nAlign);

Parametry

nAlign
[v] Výčtová hodnota zarovnání textu Možné hodnoty najdete v části Poznámky.

Poznámky

Parametr nAlign je jedním z následujících stylů ovládacích prvků pro úpravy:

• ES_LEFT pro zarovnání doleva

• ES_CENTER pro zarovnání na střed

• ES_RIGHT pro zarovnání doprava

Další informace o těchto stylech naleznete v tématu Upravit styly ovládacích prvků.

CMFCRibbonEdit::SetWidth

Nastaví šířku textového pole pro ovládací prvek CMFCRibbonEdit .

void SetWidth(
    int nWidth,
    BOOL bInFloatyMode = FALSE);

Parametry

nWidth
[v] Šířka textového pole v pixelech.

bInFloatyMode
TRUE pro nastavení šířky pro plovoucí režim; NEPRAVDA pro nastavení šířky pro běžný režim.

Poznámky

Ovládací CMFCRibbonEdit prvek má dvě šířky v závislosti na jeho režimu zobrazení: plovoucí režim a běžný režim.

Viz také

Graf hierarchie
Třídy
CMFCRibbonButton – třída
CMFCRibbonBar – třída