Klasa CMFCRibbonEdit

Implementuje kontrolkę edycji znajdującą się na pasku wstążki.

Składnia

class CMFCRibbonEdit : public CMFCRibbonButton

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Przykład

W poniższym przykładzie pokazano, jak skonstruować CMFCRibbonEdit obiekt, pokazać przyciski pokrętła obok kontrolki edycji i ustawić tekst kontrolki edycji. Ten fragment kodu jest częścią przykładu pokazowego pakietu MS Office 2007.

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"));

Wymagania

Nagłówek: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

Wskazuje, czy wysokość kontrolki CMFCRibbonEdit może wzrosnąć pionowo do wysokości wiersza wstążki.

virtual BOOL CanBeStretched();

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

CMFCRibbonEdit::CMFCRibbonEdit

Tworzy obiekt CMFCRibbonEdit.

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

CMFCRibbonEdit();

Parametry

Nid
[in] Identyfikator polecenia dla kontrolki CMFCRibbonEdit .

nWidth
[in] Szerokość w pikselach pola tekstowego kontrolki CMFCRibbonEdit .

lpszLabel
[in] Etykieta kontrolki CMFCRibbonEdit .

nImage
[in] Indeks małego obrazu do użycia dla kontrolki CMFCRibbonEdit . Kolekcja małych obrazów jest utrzymywana przez kategorię wstążki nadrzędnej.

Uwagi

Kontrolka CMFCRibbonEdit nie używa dużego obrazu.

CMFCRibbonEdit::CopyFrom

Kopiuje stan określonego obiektu CMFCRibbonEdit do bieżącego obiektu CMFCRibbonEdit .

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

Parametry

Src
[in] Obiekt źródłowy CMFCRibbonEdit .

Uwagi

Parametr src musi mieć typ CMFCRibbonEdit.

CMFCRibbonEdit::CreateEdit

Tworzy nowe pole tekstowe dla obiektu CMFCRibbonEdit .

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

Parametry

pWndParent
[in] Wskaźnik do okna nadrzędnego CMFCRibbonEdit obiektu.

dwEditStyle
[in] Określa styl pola tekstowego. Style okien wymienione w sekcji Uwagi można połączyć ze stylami kontrolek edycji opisanymi w zestawie Windows SDK.

Wartość zwracana

Wskaźnik do nowego pola tekstowego, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie wartość NULL.

Uwagi

Zastąp tę metodę w klasie pochodnej, aby utworzyć niestandardowe pole tekstowe.

Do pola tekstowego można zastosować następujące style okien:

• WS_CHILD

• WS_VISIBLE

• WS_DISABLED

• WS_GROUP

• WS_TABSTOP

CMFCRibbonEdit::D estroyCtrl

Niszczy obiekt CMFCRibbonEdit.

virtual void DestroyCtrl();

Uwagi

CMFCRibbonEdit::D ropDownList

Rozwija pole listy.

virtual void DropDownList();

Uwagi

Domyślnie ta metoda nic nie robi. Zastąpij tę metodę, aby wyświetlić pole listy.

CMFCRibbonEdit::EnableSpinButtons

Włącza i ustawia zakres przycisku pokrętła dla pola tekstowego.

void EnableSpinButtons(
    int nMin,
    int nMax);

Parametry

nMin
[in] Minimalna wartość przycisku pokrętła.

nMax
[in] Maksymalna wartość przycisku pokrętła.

Uwagi

Przyciski pokrętła wyświetlają strzałkę w górę i w dół oraz umożliwiają użytkownikom przechodzenie przez stały zestaw wartości.

CMFCRibbonEdit::GetCompactSize

Pobiera kompaktowy rozmiar obiektu CMFCRibbonEdit .

virtual CSize GetCompactSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla CMFCRibbonEdit obiektu.

Wartość zwracana

Kompaktowy rozmiar CMFCRibbonEdit obiektu.

Uwagi

CMFCRibbonEdit::GetEditText

Pobiera tekst w polu tekstowym.

CString GetEditText() const;

Wartość zwracana

Tekst w polu tekstowym.

Uwagi

CMFCRibbonEdit::GetIntermediateSize

Pobiera średni rozmiar obiektu CMFCRibbonEdit .

virtual CSize GetIntermediateSize(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla CMFCRibbonEdit obiektu.

Wartość zwracana

Średni rozmiar CMFCRibbonEdit obiektu.

Uwagi

CMFCRibbonEdit::GetTextAlign

Pobiera wyrównanie tekstu w polu tekstowym.

int GetTextAlign() const;

Wartość zwracana

Wyliczona wartość wyrównania tekstu. Zobacz sekcję Uwagi, aby uzyskać możliwe wartości.

Uwagi

Zwrócona wartość jest jednym z następujących stylów edycji kontrolek:

• ES_LEFT wyrównania po lewej stronie

• ES_CENTER do wyrównania do środka

• ES_RIGHT w celu wyrównania do prawej

Aby uzyskać więcej informacji na temat tych stylów, zobacz Edytowanie stylów kontrolek.

CMFCRibbonEdit::GetWidth

Pobiera szerokość kontrolki CMFCRibbonEdit w pikselach.

int GetWidth(BOOL bInFloatyMode = FALSE) const;

Parametry

bInFloatyMode
[in] WARTOŚĆ TRUE, jeśli kontrolka CMFCRibbonEdit jest w trybie zmiennoprzecinkowa; w przeciwnym razie wartość FALSE.

Wartość zwracana

Szerokość kontrolki w pikselach CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::HasCompactMode

Wskazuje, czy rozmiar wyświetlacza dla kontrolki CMFCRibbonEdit może być kompaktowy.

virtual BOOL HasCompactMode() const;

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE. Zastąpi tę metodę, aby wskazać, czy rozmiar wyświetlacza może być kompaktowy.

CMFCRibbonEdit::HasFocus

Wskazuje, czy kontrolka CMFCRibbonEdit ma fokus.

virtual BOOL HasFocus() const;

Wartość zwracana

Wartość TRUE, jeśli kontrolka CMFCRibbonEdit ma fokus; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::HasLargeMode

Wskazuje, czy rozmiar wyświetlania kontrolki CMFCRibbonEdit może być duży.

virtual BOOL HasLargeMode() const;

Wartość zwracana

Zawsze zwraca wartość FALSE.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE. Zastąpi tę metodę, aby wskazać, czy rozmiar wyświetlania może być duży.

CMFCRibbonEdit::HasSpinButtons

Wskazuje, czy pole tekstowe ma przycisk pokrętła.

virtual BOOL HasSpinButtons() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pole tekstowe ma przycisk pokrętła; w przeciwnym razie FAŁSZ.

Uwagi

CMFCRibbonEdit::IsHighlighted

Wskazuje, czy kontrolka CMFCRibbonEdit jest wyróżniona.

virtual BOOL IsHighlighted() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli kontrolka CMFCRibbonEdit jest wyróżniona; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::OnAfterChangeRect

Wywoływana przez platformę, gdy wymiary prostokąta wyświetlania dla zmiany kontrolki CMFCRibbonEdit .

virtual void OnAfterChangeRect(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDraw

Wywoływana przez platformę w celu narysowania kontrolki CMFCRibbonEdit .

virtual void OnDraw(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDrawLabelAndImage

Wywoływana przez platformę, aby narysować etykietę i obraz dla kontrolki CMFCRibbonEdit .

virtual void OnDrawLabelAndImage(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

Uwagi

CMFCRibbonEdit::OnDrawOnList

Wywoływana przez platformę w celu rysowania kontrolki CMFCRibbonEdit w polu listy poleceń.

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

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia dla kontrolki CMFCRibbonEdit .

strText
[in] Tekst wyświetlany.

nTextOffset
[in] Odległość w pikselach od lewej strony pola listy do tekstu wyświetlanego.

Rect
[in] Prostokąt wyświetlania kontrolki CMFCRibbonEdit .

bIsSelected
[in] Ten parametr nie jest używany.

bHighlighted
[in] Ten parametr nie jest używany.

Uwagi

Pole listy poleceń wyświetla kontrolki wstążki, aby umożliwić użytkownikom dostosowywanie paska narzędzi szybkiego dostępu.

CMFCRibbonEdit::OnEnable

Wywoływana przez platformę w celu włączenia lub wyłączenia kontrolki CMFCRibbonEdit .

virtual void OnEnable(BOOL bEnable);

Parametry

bEnable
[in] WARTOŚĆ TRUE, aby włączyć kontrolkę; FAŁSZ, aby wyłączyć kontrolkę.

Uwagi

CMFCRibbonEdit::OnHighlight

Wywoływana przez platformę, gdy wskaźnik wchodzi lub opuszcza granice kontrolki CMFCRibbonEdit .

virtual void OnHighlight(BOOL bHighlight);

Parametry

bHighlight
[in] Wartość TRUE, jeśli wskaźnik znajduje się w granicach kontrolki CMFCRibbonEdit ; w przeciwnym razie wartość FALSE.

Uwagi

CMFCRibbonEdit::OnKey

Wywoływana przez platformę, gdy użytkownik naciska etykietkę, a kontrolka CMFCRibbonEdit ma fokus.

virtual BOOL OnKey(BOOL bIsMenuKey);

Parametry

bIsMenuKey
[in] WARTOŚĆ TRUE, jeśli etykietka klucza wyświetla menu podręczne; w przeciwnym razie, FAŁSZ.

Wartość zwracana

WARTOŚĆ TRUE, jeśli zdarzenie zostało obsłużone; w przeciwnym razie, FAŁSZ.

Uwagi

CMFCRibbonEdit::OnLButtonDown

Wywoływana przez platformę w celu zaktualizowania kontrolki CMFCRibbonEdit , gdy użytkownik naciska lewy przycisk myszy na kontrolce.

virtual void OnLButtonDown(CPoint point);

Parametry

punkt
[in] Ten parametr nie jest używany.

Uwagi

CMFCRibbonEdit::OnLButtonUp

Wywoływana przez platformę, gdy użytkownik zwalnia lewy przycisk myszy.

virtual void OnLButtonUp(CPoint point);

Parametry

punkt
[in] Ten parametr nie jest używany.

Uwagi

CMFCRibbonEdit::OnRTLChanged

Wywoływana przez platformę w celu zaktualizowania kontrolki CMFCRibbonEdit , gdy układ zmienia kierunek.

virtual void OnRTLChanged(BOOL bIsRTL);

Parametry

bIsRTL
[in] Wartość TRUE, jeśli układ jest od prawej do lewej; FAŁSZ, jeśli układ jest od lewej do prawej.

Uwagi

CMFCRibbonEdit::OnShow

Wywoływana przez platformę w celu pokazania lub ukrycia kontrolki CMFCRibbonEdit .

virtual void OnShow(BOOL bShow);

Parametry

bShow
[in] WARTOŚĆ TRUE, aby wyświetlić kontrolkę; FAŁSZ, aby ukryć kontrolkę.

Uwagi

CMFCRibbonEdit::Redraw

Aktualizuje wyświetlanie kontrolki CMFCRibbonEdit .

virtual void Redraw();

Uwagi

Ta metoda ponownie rysuje prostokąt wyświetlania dla CMFCRibbonEdit obiektu, pośrednio wywołując CWnd::RedrawWindow z ustawionymi flagami RDW_INVALIDATE, RDW_ERASE i RDW_UPDATENOW.

CMFCRibbonEdit::SetACCData

Ustawia dane ułatwień dostępu dla obiektu CMFCRibbonEdit .

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

Parametry

PParent
Wskaźnik do okna nadrzędnego CMFCRibbonEdit dla obiektu.

data
Dane ułatwień dostępu dla CMFCRibbonEdit obiektu.

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

CMFCRibbonEdit::SetEditText

Ustawia tekst w polu tekstowym.

void SetEditText(CString strText);

Parametry

strText
[in] Tekst pola tekstowego.

CMFCRibbonEdit::SetTextAlign

Ustawia wyrównanie tekstu pola tekstowego.

void SetTextAlign(int nAlign);

Parametry

nAlign
[in] Wyliczona wartość wyrównania tekstu. Zobacz sekcję Uwagi, aby uzyskać możliwe wartości.

Uwagi

Parametr nAlign jest jednym z następujących stylów kontrolki edycji:

• ES_LEFT wyrównania po lewej stronie

• ES_CENTER wyrównania do środka

• ES_RIGHT w celu wyrównania do prawej

Aby uzyskać więcej informacji na temat tych stylów, zobacz Edytowanie stylów kontrolek.

CMFCRibbonEdit::SetWidth

Ustawia szerokość pola tekstowego dla kontrolki CMFCRibbonEdit .

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

Parametry

nWidth
[in] Szerokość pola tekstowego w pikselach.

bInFloatyMode
WARTOŚĆ TRUE, aby ustawić szerokość dla trybu zmiennoprzecinkowego; FAŁSZ, aby ustawić szerokość trybu regularnego.

Uwagi

Kontrolka CMFCRibbonEdit ma dwie szerokości w zależności od trybu wyświetlania: tryb zmiennoprzecinkowa i tryb regularny.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCRibbonButton
Klasa CMFCRibbonBar