Condividi tramite


CColorDialog::OnColorOK

Override per convalidare il colore inserito nella finestra di dialogo.

virtual BOOL OnColorOK( );

Valore restituito

Diverso da zero se la finestra di dialogo viene chiusa; in caso contrario 0 per accettare il colore che è stato inserito.

Note

Eseguire l'override di questa funzione solo se si desidera consentire la convalida personalizzata del colore selezionato dall'utente nella finestra di dialogo dei colori.

L'utente può selezionare un colore da uno dei due metodi seguenti:

  • Fare clic su un colore dalla tavolozza.I valori RGB del colore selezionato vengono riflessi nelle caselle di testo appropriate RGB.

  • Immettere valori nelle caselle di modifica RGB

Eseguire l'override OnColorOK che consente al rifiuto un colore l'utente in una finestra di dialogo dei colori comuni per il motivo specifico dell'applicazione.

In genere, non è necessario utilizzare che questa funzione poiché il framework fornisce la convalida predefinita dei colori e visualizzare una finestra di messaggio se un colore non valido verrà inserito.

È possibile chiamare SetCurrentColor da OnColorOK per forzare una selezione di colori.Una volta che OnColorOK è stato generato (ovvero i clic OK utente per accettare la modifica dei colori, è possibile chiamare GetColor per ottenere il valore RGB di nuovo colore.

Esempio

// Override OnColorOK to validate the color entered to the
// Red, Green, and Blue edit controls. If the color
// is BLACK (i.e. RGB(0, 0,0)), then force the current color
// selection to be the color initially selected when the
// dialog box is created. The color dialog won't close so
// user can enter a new color.
BOOL CMyColorDlg::OnColorOK()
{
   // Value in Red edit control.
   COLORREF clrref = GetColor();
   if (RGB(0, 0, 0) == clrref)
   {
      AfxMessageBox(_T("BLACK is not an acceptable color. ")
         _T("Please enter a color again"));

      // GetColor() returns initially selected color.
      SetCurrentColor(GetColor());        

      // Won't dismiss color dialog.
      return TRUE;                        
   }

   // OK to dismiss color dialog.
   return FALSE;                          
}

Requisiti

Header: afxdlgs.h

Vedere anche

Riferimenti

Classe di CColorDialog

Grafico della gerarchia