Classe CMFCColorDialog
La CMFCColorDialog classe rappresenta una finestra di dialogo di selezione dei colori.
Sintassi
class CMFCColorDialog : public CDialogEx
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCColorDialog::CMFCColorDialog | Costruisce un oggetto CMFCColorDialog. |
CMFCColorDialog::~CMFCColorDialog |
Distruttore. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCColorDialog::GetColor | Restituisce il colore selezionato corrente. |
| CMFCColorDialog::GetPalette | Restituisce la tavolozza del colore. |
CMFCColorDialog::PreTranslateMessage |
Converte i messaggi della finestra prima che vengano inviati alle funzioni di Windows TranslateMessage e DispatchMessage . Per la sintassi e altre informazioni, vedere CWnd::P reTranslateMessage. Esegue l'override di CDialogEx::PreTranslateMessage. |
| CMFCColorDialog::RebuildPalette | Deriva una tavolozza dalla tavolozza del sistema. |
| CMFCColorDialog::SetCurrentColor | Imposta il colore selezionato corrente. |
| CMFCColorDialog::SetNewColor | Imposta il colore più equivalente a un valore RGB specificato. |
| CMFCColorDialog::SetPageOne | Seleziona un valore RGB per la prima pagina delle proprietà. |
| CMFCColorDialog::SetPageTwo | Seleziona un valore RGB per la seconda pagina delle proprietà. |
Membri dati protetti
| Nome | Descrizione |
|---|---|
m_bIsMyPalette |
TRUE se la finestra di dialogo di selezione dei colori utilizza la propria tavolozza dei colori o FALSE se la finestra di dialogo utilizza una tavolozza specificata nel CMFCColorDialog costruttore. |
m_bPickerMode |
TRUE mentre l'utente seleziona un colore dalla finestra di dialogo di selezione; in caso contrario, FALSE. |
m_btnColorSelect |
Pulsante colore selezionato dall'utente. |
m_CurrentColor |
Colore attualmente selezionato. |
m_hcurPicker |
Cursore utilizzato per selezionare un colore. |
m_NewColor |
Il colore potenziale selezionato, che può essere selezionato in modo permanente o ripristinato al colore originale. |
m_pColourSheetOne |
Puntatore alla prima pagina delle proprietà della finestra delle proprietà di selezione dei colori. |
m_pColourSheetTwo |
Puntatore alla seconda pagina delle proprietà della finestra delle proprietà di selezione dei colori. |
m_pPalette |
Tavolozza logica corrente. |
m_pPropSheet |
Puntatore alla finestra delle proprietà per la finestra di dialogo di selezione dei colori. |
m_wndColors |
Oggetto controllo selezione colori. |
m_wndStaticPlaceHolder |
Controllo statico che rappresenta un segnaposto per la finestra delle proprietà della selezione colori. |
Osservazioni:
La finestra di dialogo di selezione dei colori viene visualizzata come finestra delle proprietà con due pagine. Nella prima pagina si seleziona un colore standard dalla tavolozza del sistema; nella seconda pagina si seleziona un colore personalizzato.
È possibile costruire un CMFCColorDialog oggetto nello stack e quindi chiamare DoModal, passando il colore iniziale come parametro al CMFCColorDialog costruttore. La finestra di dialogo di selezione dei colori crea quindi diversi oggetti classe CMFCColorPickerCtrl per gestire ogni tavolozza dei colori.
Gerarchia di ereditarietà
Esempio
Nell'esempio seguente viene illustrato come configurare una finestra di dialogo colore usando vari metodi nella CMFCColorDialog classe . Nell'esempio viene illustrato come impostare i colori correnti e i nuovi colori del dialogo e come impostare i componenti rosso, verde e blu di un colore selezionato nelle due pagine delle proprietà della finestra di dialogo colore. Questo esempio fa parte dell'esempio New Controls.This example is part of the New Controls sample.
// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);
Requisiti
Intestazione: afxcolordialog.h
CMFCColorDialog::CMFCColorDialog
Costruisce un oggetto CMFCColorDialog.
CMFCColorDialog(
COLORREF clrInit=0,
DWORD dwFlags=0,
CWnd* pParentWnd=NULL,
HPALETTE hPal=NULL);
Parametri
clrInit
[in] Selezione dei colori predefinita. Se non viene specificato alcun valore, il valore predefinito è RGB(0,0,0) (nero).
dwFlags
[in] Riservato.
pParentWnd
[in] Puntatore alla finestra padre o proprietario della finestra di dialogo.
hPal
[in] Handle per una tavolozza dei colori.
Valore restituito
Osservazioni:
CMFCColorDialog::GetColor
Recupera il colore selezionato dall'utente nella finestra di dialogo colore.
COLORREF GetColor() const;
Valore restituito
Valore COLORREF che contiene le informazioni RGB per il colore selezionato nella finestra di dialogo colore.
Osservazioni:
Chiamare questa funzione dopo aver chiamato il DoModal metodo .
CMFCColorDialog::GetPalette
Recupera la tavolozza dei colori disponibile nella finestra di dialogo colore corrente.
CPalette* GetPalette() const;
Valore restituito
Puntatore all'oggetto CPalette specificato nel CMFCColorDialog costruttore.
Osservazioni:
La tavolozza dei colori specifica i colori che l'utente può scegliere.
CMFCColorDialog::RebuildPalette
Deriva una tavolozza dalla tavolozza del sistema.
void RebuildPalette();
CMFCColorDialog::SetCurrentColor
Imposta il colore corrente della finestra di dialogo.
void SetCurrentColor(COLORREF rgb);
Parametri
Rgb
[in] Un valore di colore RGB
Osservazioni:
CMFCColorDialog::SetNewColor
Imposta il colore corrente sul colore nella tavolozza corrente più simile.
void SetNewColor(COLORREF rgb);
Parametri
Rgb
[in] COLORREF che specifica un colore RGB.
Osservazioni:
CMFCColorDialog::SetPageOne
Specifica in modo esplicito i componenti rosso, verde e blu di un colore selezionato nella prima pagina delle proprietà di una finestra di dialogo colore.
void SetPageOne(
BYTE R,
BYTE G,
BYTE B);
Parametri
R
[in] Specifica il componente rosso del valore RGB.
G
[in] Specifica il componente verde del valore RGB.
B
[in] Specifica il componente blu del valore RGB.
Osservazioni:
CMFCColorDialog::SetPageTwo
Specifica in modo esplicito i componenti rosso, verde e blu di un colore selezionato nella seconda pagina delle proprietà di una finestra di dialogo colore.
void SetPageTwo(
BYTE R,
BYTE G,
BYTE B);
Parametri
R
[in] Specifica un componente rosso del valore RGB
G
[in] Specifica un componente verde di un valore RGB
B
[in] Specifica un componente blu di un valore RGB