Udostępnij za pośrednictwem

Klasa CMFCColorBar

  • Artykuł

Klasa CMFCColorBar reprezentuje pasek sterowania dokowania, który może wybierać kolory w dokumencie lub aplikacji.

Składnia

class CMFCColorBar : public CMFCPopupMenuBar

Elementy członkowskie

Konstruktory chronione

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

Metody publiczne

Nazwa/nazwisko opis
CMFCColorBar::ContextToSize Oblicza marginesy pionowe i poziome, które są wymagane do przechowywania przycisków w kontrolce paska kolorów, a następnie dostosowuje lokalizację tych przycisków.
CMFCColorBar::CreateControl Tworzy okno kontrolki paska kolorów, dołącza je do CMFCColorBar obiektu i zmienia rozmiar kontrolki tak, aby zawierała określoną paletę kolorów.
CMFCColorBar::Create Tworzy okno kontrolki paska kolorów i dołącza je do CMFCColorBar obiektu.
CMFCColorBar::EnableAutomaticButton Wyświetla lub ukrywa przycisk automatyczny.
CMFCColorBar::EnableOtherButton Włącza lub wyłącza wyświetlanie okna dialogowego, które pozwala użytkownikowi wybrać więcej kolorów.
CMFCColorBar::GetColor Pobiera aktualnie wybrany kolor.
CMFCColorBar::GetCommandID Pobiera identyfikator polecenia bieżącej kontrolki paska kolorów.
CMFCColorBar::GetHighlightedColor Pobiera kolor, który oznacza, że przycisk koloru ma fokus; oznacza to, że przycisk jest gorący.
CMFCColorBar::GetHorzMargin Pobiera margines poziomy, który jest spacją między komórką lewego lub prawego koloru a granicą obszaru klienta.
CMFCColorBar::GetVertMargin Pobiera margines pionowy, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.
CMFCColorBar::IsTearOff Wskazuje, czy bieżący pasek kolorów można zadokować.
CMFCColorBar::SetColor Ustawia aktualnie wybrany kolor.
CMFCColorBar::SetColorName Ustawia nową nazwę dla określonego koloru.
CMFCColorBar::SetCommandID Ustawia nowy identyfikator polecenia dla kontrolki paska kolorów.
CMFCColorBar::SetDocumentColors Ustawia listę kolorów używanych w bieżącym dokumencie.
CMFCColorBar::SetHorzMargin Ustawia margines poziomy, czyli odstęp między komórką lewego lub prawego koloru a granicą obszaru klienta.
CMFCColorBar::SetVertMargin Ustawia margines pionowy, czyli odstęp między komórką górnego lub dolnego koloru a granicą obszaru klienta.

Metody chronione

Nazwa/nazwisko opis
CMFCColorBar::AdjustLocations Dostosowuje pozycje przycisków kolorów w kontrolce paska kolorów.
CMFCColorBar::AllowChangeTextLabels Wskazuje, czy można zmienić etykietę tekstową przycisków kolorów.
CMFCColorBar::AllowShowOnList Wskazuje, czy obiekt kontrolki paska kolorów może być wyświetlany na liście pasków narzędzi podczas procesu dostosowywania.
CMFCColorBar::CalcSize Wywoływana przez platformę w ramach procesu obliczania układu.
CMFCColorBar::CreatePalette Inicjuje paletę z kolorami w określonej tablicy kolorów.
CMFCColorBar::GetColorGridSize Oblicza liczbę wierszy i kolumn w siatce kontrolki paska kolorów.
CMFCColorBar::GetExtraHeight Oblicza dodatkową wysokość, którą bieżący pasek kolorów wymaga wyświetlenia różnych elementów interfejsu użytkownika, takich jak przycisk Inne , kolory dokumentu itd.
CMFCColorBar::InitColors Inicjuje tablicę kolorów z kolorami w określonej palecie lub domyślnej palecie systemowej.
CMFCColorBar::OnKey Wywoływana przez platformę, gdy użytkownik naciska przycisk klawiatury.
CMFCColorBar::OnSendCommand Wywoływana przez platformę, aby zamknąć hierarchię kontrolek wyskakujących okienek.
CMFCColorBar::OnUpdateCmdUI Wywoływana przez platformę w celu włączenia lub wyłączenia elementu interfejsu użytkownika kontrolki paska kolorów przed wyświetleniem elementu.
CMFCColorBar::OpenColorDialog Otwiera okno dialogowe koloru.
CMFCColorBar::Rebuild Całkowicie ponownie rysuje kontrolkę paska kolorów.
CMFCColorBar::SelectPalette Ustawia paletę logiczną określonego kontekstu urządzenia na paletę przycisku nadrzędnego bieżącego kontrolki paska kolorów.
CMFCColorBar::SetPropList m_pWndPropList Ustawia element członkowski chronionych danych na określony wskaźnik do kontrolki siatki właściwości.
CMFCColorBar::ShowCommandMessageString Żąda okna ramki, które jest właścicielem kontrolki paska kolorów, aby zaktualizować wiersz komunikatu na pasku stanu.

Chronione składowe danych

Nazwa/nazwisko opis
m_bInternal Pole logiczne określające, czy zdarzenia myszy są przetwarzane. Zazwyczaj zdarzenia myszy są przetwarzane, gdy to pole ma wartość TRUE, a tryb dostosowywania to FAŁSZ.
m_bIsEnabled Wartość logiczna wskazująca, czy kontrolka jest włączona.
m_bIsTearOff Wartość logiczna wskazująca, czy kontrolka paska kolorów obsługuje dokowanie.
m_BoxSize Obiekt CSize określający rozmiar komórki w siatce paska kolorów.
m_bShowDocColorsWhenDocked Wartość logiczna wskazująca, czy mają być wyświetlane kolory dokumentu, gdy pasek kolorów jest zadokowany. Aby uzyskać więcej informacji, zobacz CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Wartość logiczna wskazująca, czy ma być wyświetlane standardowe okno dialogowe koloru systemu, czy okno dialogowe CMFCColorDialog . Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.
m_ColorAutomatic Element COLORREF , który przechowuje bieżący kolor automatyczny. Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.
m_ColorNames Obiekt CMap, który kojarzy zestaw kolorów RGB z ich nazwami.
m_colors CArray wartości COLORREF, które zawierają kolory wyświetlane w kontrolce paska kolorów.
m_ColorSelected Wartość COLORREF, która jest kolorem aktualnie wybranym przez użytkownika z kontrolki paska kolorów.
m_lstDocColors Lista CList wartości COLORREF , które zawierają kolory, które są obecnie używane w dokumencie.
m_nCommandID Liczba całkowita bez znaku, która jest identyfikatorem polecenia przycisku koloru.
m_nHorzMargin Liczba całkowita, która jest marginesem poziomym między przyciskami kolorów w siatce kolorów.
m_nHorzOffset Liczba całkowita, która jest przesunięciem poziomym na środek przycisku koloru. Ta wartość jest znacząca, jeśli przycisk wyświetla tekst lub obraz oprócz koloru.
m_nNumColumns Liczba całkowita, która jest liczbą kolumn w siatce kontrolki paska kolorów.
m_nNumColumnsVert Liczba całkowita, która jest liczbą kolumn w pionowej siatce kolorów.
m_nNumRowsHorz Liczba całkowita, która jest liczbą kolumn w siatce w orientacji poziomej kolorów.
m_nRowHeight Liczba całkowita, która jest wysokością wiersza przycisków kolorów w siatce kolorów.
m_nVertMargin Liczba całkowita, która jest pionowym marginesem między przyciskami kolorów w siatce kolorów.
m_nVertOffset Liczba całkowita, która jest pionowym przesunięciem do środka przycisku koloru. Ta wartość jest znacząca, jeśli przycisk wyświetla tekst lub obraz oprócz koloru.
m_Palette CPalette kolorów używanych w kontrolce paska kolorów.
m_pParentBtn Wskaźnik do obiektu CMFCColorButton , który jest elementem nadrzędnym bieżącego przycisku. Ta wartość jest znacząca, jeśli przycisk koloru znajduje się w hierarchii kontrolek paska narzędzi lub znajduje się w kontrolce siatki właściwości koloru.
m_pParentRibbonBtn Wskaźnik do obiektu CMFCRibbonColorButton , który znajduje się na wstążce i jest przyciskiem nadrzędnym bieżącego przycisku. Ta wartość jest znacząca, jeśli przycisk koloru znajduje się w hierarchii kontrolek paska narzędzi lub znajduje się w kontrolce siatki właściwości koloru.
m_pWndPropList Wskaźnik do obiektu CMFCPropertyGridCtrl .
m_strAutoColor Ciąg CString , który jest tekstem wyświetlanym na przycisku Automatyczny . Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableAutomaticButton.
m_strDocColors Ciąg CString , który jest tekstem wyświetlanym na przycisku kolory dokumentu. Aby uzyskać więcej informacji, zobacz CMFCColorBar::SetDocumentColors.
m_strOtherColor Ciąg CString , który jest tekstem wyświetlanym na drugim przycisku. Aby uzyskać więcej informacji, zobacz CMFCColorBar::EnableOtherButton.

Uwagi

Zazwyczaj nie tworzy CMFCColorBar się obiektu bezpośrednio. Zamiast tego klasa CMFCColorMenuButton (używana w menu i paskach narzędzi) lub klasa CMFCColorButton tworzy CMFCColorBar obiekt.

Klasa CMFCColorBar zapewnia następujące funkcje:

  • Automatycznie dostosowuje listę kolorów dokumentu.

  • Zapisuje i przywraca jego stan wraz ze stanem dokumentu.

  • Zarządza przyciskiem "automatycznym".

  • Używa kontrolki Klasa CMFCColorPickerCtrl, aby wybrać kolor niestandardowy.

  • Obsługuje stan "odrębienia" (jeśli jest tworzony przy użyciu klasy CMFCColorMenuButton).

Aby uwzględnić CMFCColorBar funkcje w aplikacji:

  1. Utwórz zwykły przycisk menu i przypisz mu identyfikator, na przykład ID_CHAR_COLOR.

  2. W klasie okien ramowych zastąp metodę CFrameWndEx::OnShowPopupMenu i zastąp zwykły przycisk menu obiektem klasy CMFCColorMenuButton (wywołując polecenie CMFCToolBar::ReplaceButton).

  3. Ustaw wszystkie style i włącz lub wyłącz funkcje CMFCColorBar obiektu podczas tworzenia klasy CMFCColorMenuButton. Obiekt CMFCColorMenuButton dynamicznie tworzy CMFCColorBar obiekt po wywołaniu metody przez platformę CreatePopupMenu .

Gdy użytkownik kliknie przycisk kontrolki paska kolorów, struktura używa ON_COMMAND makra do powiadamiania elementu nadrzędnego kontrolki paska kolorów. W makrze parametr identyfikatora polecenia to wartość przypisana do przycisku kontrolki paska kolorów w kroku 1 (ID_CHAR_COLOR w tym przykładzie). Aby uzyskać więcej informacji, zobacz klasa CMFCColorMenuButton, klasa CMFCColorButton, klasa CMFCColorPickerCtrl, klasa CFrameWndEx i klasy CMFCToolBar.

Przykład

W poniższym przykładzie pokazano, jak skonfigurować pasek kolorów przy użyciu różnych metod w CMFCColorBar klasie. Metody ustawiają marginesy poziome i pionowe, włączają drugi przycisk, tworzą okno kontrolki paska kolorów i ustawiają aktualnie wybrany kolor. Ten przykład jest częścią przykładu Nowe kontrolki.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

Wymagania

Nagłówek: afxcolorbar.h

CMFCColorBar::AdjustLocations

Dostosowuje pozycje przycisków kolorów w kontrolce paska kolorów.

virtual void AdjustLocations();

Uwagi

Ta metoda jest wywoływana przez platformę podczas przetwarzania komunikatów WM_SIZE.

CMFCColorBar::AllowChangeTextLabels

Wskazuje, czy można zmienić etykietę tekstową przycisków kolorów.

virtual BOOL AllowChangeTextLabels() const;

Wartość zwracana

Zawsze FAŁSZ.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość FALSE, co oznacza, że nie można modyfikować etykiet tekstowych. Zastąpij tę metodę, aby włączyć modyfikowanie etykiet tekstowych.

CMFCColorBar::AllowShowOnList

Wskazuje, czy obiekt kontrolki paska kolorów może być wyświetlany na liście pasków narzędzi podczas procesu dostosowywania.

virtual BOOL AllowShowOnList() const;

Wartość zwracana

Zawsze prawda.

Uwagi

Domyślnie ta metoda zawsze zwraca wartość TRUE, co oznacza, że platforma może wyświetlać kontrolkę paska kolorów podczas procesu dostosowywania. Zastąpij tę metodę, aby zaimplementować inne zachowanie.

CMFCColorBar::CalcSize

Wywoływana przez platformę w ramach procesu obliczania układu.

virtual CSize CalcSize(BOOL bVertDock);

Parametry

bVertDock
[in] PRAWDA, aby określić, że kontrolka paska kolorów jest zadokowana w pionie; FAŁSZ, aby określić, że kontrolka paska kolorów jest zadokowana w poziomie.

Wartość zwracana

Rozmiar tablicy przycisków kolorów w kontrolce paska kolorów.

CMFCColorBar::CMFCColorBar

CMFCColorBar Tworzy obiekt.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parametry

Kolory
[in] Tablica kolorów wyświetlana na kontrolce paska kolorów.

Kolor
[in] Początkowo wybrany kolor.

lpszAutoColor
[in] Etykieta tekstowa przycisku automatycznego (domyślnego) koloru lub null.

Standardowa etykieta przycisku automatycznego to Automatyczny.

lpszOtherColor
[in] Etykieta tekstowa drugiego przycisku, który wyświetla więcej opcji kolorów lub wartość NULL.

Etykieta standardowa dla drugiego przycisku to Więcej kolorów....

lpszDocColors
[in] Etykieta tekstowa przycisku kolory dokumentu. Paleta kolorów dokumentu zawiera listę wszystkich kolorów używanych obecnie przez dokument.

lstDocColors
[in] Lista kolorów używanych obecnie w dokumencie.

nKolumny
[in] Liczba kolumn, które zawiera tablica kolorów.

nRowsDockHorz
[in] Liczba wierszy, które ma pasek kolorów, gdy jest zadokowany w poziomie.

nColDockVert
[in] Liczba kolumn, które ma pasek kolorów, gdy jest zadokowany w pionie.

colorAutomatic
[in] Domyślny kolor stosowany przez strukturę po kliknięciu przycisku automatycznego.

nPoleceniaID
[in] Identyfikator polecenia kontrolki paska kolorów.

pParentBtn
[in] Wskaźnik do przycisku nadrzędnego.

Src
[in] Istniejący CMFCColorBar obiekt, który ma zostać skopiowany do nowego CMFCColorBar obiektu.

uiCommandID
[in] Identyfikator polecenia.

CMFCColorBar::ContextToSize

Oblicza marginesy pionowe i poziome wymagane do przechowywania przycisków w kontrolce paska kolorów i dostosowuje lokalizację tych przycisków.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parametry

bSquareButtons
[in] PRAWDA, aby określić, że kształt przycisków w kontrolce paska kolorów jest kwadratowy; w przeciwnym razie, FAŁSZ. Wartość domyślna to TRUE.

bCenterButtons
[in] PRAWDA, aby określić, że zawartość na powierzchni przycisku kontrolki paska kolorów jest wyśrodkowana; w przeciwnym razie, FAŁSZ. Wartość domyślna to TRUE.

Uwagi

CMFCColorBar::Create

Tworzy okno kontrolki paska kolorów i dołącza je do CMFCColorBar obiektu.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego.

dwStyle
[in] Kombinacja bitowa (OR) stylów okna.

Nid
[in] Identyfikator polecenia.

pPalette
[in] Wskaźnik do palety kolorów. Wartość domyślna to NULL.

nKolumny
[in] Liczba kolumn w kontrolce paska kolorów. Wartość domyślna to 0.

nRowsDockHorz
[in] Liczba wierszy w kontrolce paska kolorów, gdy jest zadokowana w poziomie. Wartość domyślna to 0.

nColDockVert
[in] Liczba kolumn w kontrolce paska kolorów, gdy jest zadokowana w pionie. Wartość domyślna to 0.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

Uwagi

Aby utworzyć CMFCColorBar obiekt, wywołaj konstruktor klasy, a następnie tę metodę. Metoda Create tworzy kontrolkę systemu Windows i inicjuje listę kolorów.

CMFCColorBar::CreateControl

Tworzy okno kontrolki paska kolorów, dołącza je do CMFCColorBar obiektu i zmienia rozmiar okna kontrolki tak, aby zawierał określoną paletę kolorów.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego. Nie można mieć wartości NULL.

Rect
[in] Prostokąt ograniczenia, który określa, gdzie narysować kontrolkę paska kolorów.

Nid
[in] Identyfikator kontrolki.

nKolumny
[in] Idealna liczba kolumn w kontrolce paska kolorów. Ta metoda modyfikuje tę liczbę, aby dopasować określoną paletę kolorów. Wartość domyślna to -1, co oznacza, że ten parametr nie jest określony.

pPalette
[in] Wskaźnik do palety kolorów lub wartości NULL. Jeśli ten parametr ma wartość NULL, ta metoda oblicza rozmiar kontrolki paska kolorów tak, jakby określono 20 kolorów. Wartość domyślna to NULL.

Wartość zwracana

Wartość TRUE, jeśli ta metoda powiedzie się; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda używa parametrów rect, nColumns i pPalette do obliczenia odpowiedniej liczby lub wierszy i kolumn w kontrolce paska kolorów, a następnie wywołuje metodę CMFCColorBar::Create .

CMFCColorBar::CreatePalette

Inicjuje paletę z kolorami w określonej tablicy kolorów.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parametry

arColors
[in] Tablica kolorów.

paleta
[in] Paleta kolorów.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

CMFCColorBar::EnableAutomaticButton

Wyświetla lub ukrywa przycisk automatyczny.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parametry

lpszLabel
[in] Etykieta tekstowa przycisku automatycznego (domyślnego) koloru lub null.

Standardowa etykieta przycisku automatycznego to Automatyczny.

colorAutomatic
[in] Domyślny kolor stosowany przez strukturę po kliknięciu przycisku automatycznego.

bEnable
[in] WARTOŚĆ TRUE, aby włączyć przycisk automatyczny; FAŁSZ, aby wyłączyć przycisk automatyczny. Wartość domyślna to TRUE.

Uwagi

Etykieta tekstowa przycisku automatycznego jest usuwana, jeśli parametr lpszLabel ma wartość NULL lub parametr bEnable ma wartość FALSE.

CMFCColorBar::EnableOtherButton

Włącza lub wyłącza wyświetlanie okna dialogowego, które pozwala użytkownikowi wybrać więcej kolorów.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parametry

lpszLabel
[in] Etykieta tekstowa drugiego przycisku, który wyświetla więcej opcji kolorów lub wartość NULL.

Etykieta standardowa dla tego przycisku to Więcej kolorów....

bAltColorDlg
[in] WARTOŚĆ TRUE, aby wyświetlić okno dialogowe CMFCColorDialog ; FAŁSZ, aby wyświetlić standardowe okno dialogowe CColorDialog . Wartość domyślna to TRUE.

bEnable
[in] WARTOŚĆ TRUE, aby włączyć przycisk; FAŁSZ, aby wyłączyć przycisk. Wartość domyślna to TRUE.

CMFCColorBar::GetColor

Pobiera aktualnie wybrany kolor.

COLORREF GetColor() const;

Wartość zwracana

Aktualnie wybrany kolor.

CMFCColorBar::GetColorGridSize

Oblicza liczbę wierszy i kolumn w siatce kontrolki paska kolorów.

CSize GetColorGridSize(BOOL bVertDock) const;

Parametry

bVertDock
[in] WARTOŚĆ TRUE do wykonania obliczeń dla kontrolki paska kolorów zadokowanego pionowo; w przeciwnym razie wykonaj obliczenia dla kontrolki zadokowanej w poziomie.

Wartość zwracana

Obiekt CSize, którego cx składnik zawiera liczbę kolumn i których cy składnik zawiera liczbę wierszy.

CMFCColorBar::GetCommandID

Pobiera identyfikator polecenia bieżącej kontrolki paska kolorów.

UINT GetCommandID() const;

Wartość zwracana

Identyfikator polecenia.

Uwagi

Gdy użytkownik wybierze nowy kolor, platforma wysyła identyfikator polecenia w komunikacie WM_COMMAND, aby powiadomić obiekt nadrzędny CMFCColorBar obiektu.

CMFCColorBar::GetExtraHeight

Oblicza dodatkową wysokość, którą bieżący pasek kolorów wymaga wyświetlenia różnych elementów interfejsu użytkownika, takich jak przycisk Inne lub kolory dokumentu.

int GetExtraHeight(int nNumColumns) const;

Parametry

nNumColumns
[in] Jeśli kontrolka paska kolorów zawiera kolory dokumentu, liczba kolumn do wyświetlenia w siatce kolorów dokumentu. W przeciwnym razie ta wartość nie jest używana.

Wartość zwracana

Obliczana dodatkowa wysokość, która jest wymagana.

CMFCColorBar::GetHighlightedColor

Pobiera kolor, który oznacza, że przycisk koloru ma fokus; oznacza to, że przycisk jest gorący.

COLORREF GetHighlightedColor() const;

Wartość zwracana

Wartość RGB.

Uwagi

CMFCColorBar::GetHorzMargin

Pobiera margines poziomy, który jest spacją między komórką lewego lub prawego koloru a granicą obszaru klienta.

int GetHorzMargin();

Wartość zwracana

Margines poziomy.

CMFCColorBar::GetVertMargin

Pobiera margines pionowy, czyli spację między górną lub dolną komórką koloru a granicą obszaru klienta.

int GetVertMargin() const;

Wartość zwracana

Margines pionowy.

CMFCColorBar::InitColors

Inicjuje tablicę kolorów z kolorami w określonej palecie lub z domyślną paletą systemową.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parametry

pPalette
[in] Wskaźnik do obiektu palety lub wartość NULL. Jeśli ten parametr ma wartość NULL, ta metoda używa domyślnej palety systemu operacyjnego.

arColors
[in] Tablica kolorów.

Wartość zwracana

Liczba elementów w tablicy kolorów.

CMFCColorBar::IsTearOff

Wskazuje, czy bieżący pasek kolorów można zadokować.

BOOL IsTearOff() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli bieżąca kontrolka paska kolorów jest docka; w przeciwnym razie, FAŁSZ.

Uwagi

Jeśli kontrolka paska kolorów jest docka, można ją odciąć i zadokować w innej lokalizacji.

CMFCColorBar::OnKey

Wywoływana przez platformę, gdy użytkownik naciska przycisk klawiatury.

virtual BOOL OnKey(UINT nChar);

Parametry

nChar
[in] Kod klucza wirtualnego dla klucza, który użytkownik nacisnął.

Wartość zwracana

Wartość TRUE, jeśli ta metoda przetwarza określony klucz; w przeciwnym razie, FAŁSZ.

CMFCColorBar::OnSendCommand

Wywoływana przez platformę, aby zamknąć hierarchię kontrolek wyskakujących okienek.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametry

PButton
[in] Wskaźnik do kontrolki znajdującej się na pasku narzędzi.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

CMFCColorBar::OnUpdateCmdUI

Wywoływana przez platformę w celu włączenia lub wyłączenia elementu interfejsu użytkownika kontrolki paska kolorów przed wyświetleniem elementu.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parametry

pTarget
[in] Wskaźnik do okna zawierającego element interfejsu użytkownika do aktualizacji.

bDisableIfNoHndler
[in] WARTOŚĆ TRUE, aby wyłączyć element interfejsu użytkownika, jeśli żadna procedura obsługi nie jest zdefiniowana na mapie komunikatów; w przeciwnym razie, FAŁSZ.

Uwagi

Gdy użytkownik aplikacji kliknie element interfejsu użytkownika, element musi wiedzieć, czy powinien być wyświetlany jako włączony, czy wyłączony. Element docelowy komunikatu polecenia zawiera te informacje, implementując program obsługi poleceń ON_UPDATE_COMMAND_UI. Użyj tej metody, aby ułatwić przetwarzanie polecenia. Aby uzyskać więcej informacji, zobacz Klasa CCmdUI.

CMFCColorBar::OpenColorDialog

Otwiera okno dialogowe koloru.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parametry

colorDefault
[in] Kolor wybrany domyślnie po otwarciu okna dialogowego koloru.

colorRes
[out] Kolor wybrany przez użytkownika.

Wartość zwracana

WARTOŚĆ TRUE, jeśli użytkownik wybrał kolor; FAŁSZ, jeśli użytkownik anulował okno dialogowe koloru.

Uwagi

CMFCColorBar::Rebuild

Całkowicie ponownie rysuje kontrolkę paska kolorów.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Ustawia paletę logiczną określonego kontekstu urządzenia na paletę przycisku nadrzędnego bieżącego kontrolki paska kolorów.

CPalette* SelectPalette(CDC* pDC);

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia przycisku nadrzędnego bieżącego paska kolorów.

Wartość zwracana

Wskaźnik do palety, który jest zastępowany przez paletę przycisku nadrzędnego bieżącego kontrolki paska kolorów.

CMFCColorBar::SetColor

Ustawia aktualnie wybrany kolor.

void SetColor(COLORREF color);

Parametry

Kolor
[in] Wartość koloru RGB.

CMFCColorBar::SetColorName

Ustawia nową nazwę dla określonego koloru.

static void SetColorName(
    COLORREF color,
    const CString& strName);

Parametry

Kolor
[in] Wartość RGB koloru.

strName
[in] Nowa nazwa określonego koloru.

Uwagi

Ta metoda zmienia nazwę określonego koloru we wszystkich CMFCColorBar obiektach w aplikacji.

CMFCColorBar::SetCommandID

Ustawia nowy identyfikator polecenia dla kontrolki paska kolorów.

void SetCommandID(UINT nCommandID);

Parametry

nPoleceniaID
[in] Identyfikator polecenia.

Uwagi

Wywołaj tę metodę, aby zmodyfikować identyfikator polecenia kontrolki paska kolorów i powiadomić okno nadrzędne kontrolki o zmianie identyfikatora.

CMFCColorBar::SetDocumentColors

Ustawia listę kolorów używanych w bieżącym dokumencie.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parametry

lpszCaption
[in] Podpis wyświetlany, gdy kontrolka paska kolorów nie jest zadokowana.

lstDocColors
[in] Lista kolorów, które zastępują bieżące kolory dokumentu.

bShowWhenDocked
[in] WARTOŚĆ TRUE do wyświetlania kolorów dokumentu, gdy kontrolka paska kolorów jest zadokowana; w przeciwnym razie, FAŁSZ. Wartość domyślna to FALSE.

Uwagi

Kolory dokumentu to kolory, które są obecnie używane w dokumencie. Platforma automatycznie utrzymuje listę kolorów dokumentu, ale można użyć tej metody do zmodyfikowania listy.

CMFCColorBar::SetHorzMargin

Ustawia margines poziomy, czyli odstęp między komórką koloru po lewej lub prawej stronie a granicą obszaru klienta.

void SetHorzMargin(int nHorzMargin);

Parametry

nHorzMargin
[in] Margines poziomy w pikselach.

Uwagi

Domyślnie konstruktor CMFCColorBar::CMFCColorBar ustawia margines poziomy na 4 piksele.

CMFCColorBar::SetPropList

m_pWndPropList Ustawia element członkowski chronionych danych na określony wskaźnik do kontrolki siatki właściwości.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parametry

pWndList
[in] Wskaźnik do obiektu kontrolki siatki właściwości.

CMFCColorBar::SetVertMargin

Ustawia margines pionowy, czyli odstęp między komórką górnego lub dolnego koloru a granicą obszaru klienta.

void SetVertMargin(int nVertMargin);

Parametry

nVertMargin
[in] Pionowy margines w pikselach.

Uwagi

Domyślnie konstruktor CMFCColorBar::CMFCColorBar ustawia margines pionowy na 4 piksele.

CMFCColorBar::ShowCommandMessageString

Żąda okna ramki, które jest właścicielem kontrolki paska kolorów, aby zaktualizować wiersz komunikatu na pasku stanu.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametry

uiCmdId
[in] Identyfikator polecenia. (Ten parametr jest ignorowany).

Uwagi

Ta metoda wysyła komunikat WM_SETMESSAGESTRING do właściciela kontrolki paska kolorów.

Zobacz też

Wykres hierarchii
Klasy