CFindReplaceDialog::Create

Articolo
06/10/2015

Crea e visualizza una ricerca o il comando trova/oggetto di sostituzione della finestra di dialogo, a seconda del valore bFindDialogOnly.

virtual BOOL Create( 
   BOOL bFindDialogOnly, 
   LPCTSTR lpszFindWhat, 
   LPCTSTR lpszReplaceWith = NULL, 
   DWORD dwFlags = FR_DOWN, 
   CWnd* pParentWnd = NULL  
);

Parametri

bFindDialogOnly
Impostare questo parametro su TRUE per visualizzare una finestra di dialogo Trova. Impostarlo a FALSE per visualizzare una finestra di dialogo Il comando trova/sostituisci.
lpszFindWhat
Puntatore alla stringa di ricerca predefinita quando la finestra di dialogo. Se NULL, la finestra di dialogo non contiene una stringa di ricerca predefinita.
lpszReplaceWith
Puntatore alla stringa di sostituzione predefinita quando la finestra di dialogo. Se NULL, la finestra di dialogo non contiene una stringa di sostituzione predefinita.
dwFlags
Uno o più flag che è possibile utilizzare per personalizzare le impostazioni della finestra di dialogo, combinate utilizzando l'operatore OR bit. Il valore predefinito è FR_DOWN, che specifica che la ricerca prevede di continuare in una direzione discendente. Vedere la struttura FINDREPLACE in Windows SDK per ulteriori informazioni su questi flag.
pParentWnd
Un puntatore al padre o alla finestra proprietaria della finestra di dialogo. Si tratta della finestra che riceve il messaggio speciale che indica che un trova o azione di sostituzione è obbligatorio. Se NULL, la finestra principale dell'applicazione viene utilizzato.

Valore restituito

Diverso da zero se l'oggetto della finestra di dialogo è stato creato correttamente; in caso contrario 0.

Note

Affinché la finestra padre per comunicare trova/richieste di sostituzione, è necessario utilizzare la funzione di Windows RegisterWindowMessage del cui valore restituito è un numero di messaggio univoco all'istanza dell'applicazione. La finestra cornice deve avere una voce della mappa messaggi che dichiara la funzione di callback (OnFindReplace nell'esempio che segue) che gestisce questo messaggio registrato. Nel frammento di codice è un esempio di come eseguire questa operazione per una classe finestra cornice denominata CMyRichEditView:

// Message handler declared in CMyRichEditView class declaration
protected:
   afx_msg LONG OnFindReplace(WPARAM wParam, LPARAM lParam);

// Register FindReplace window message. 
static UINT WM_FINDREPLACE = ::RegisterWindowMessage(FINDMSGSTRING);

// Message map entry to map from message to handler function.
ON_REGISTERED_MESSAGE(WM_FINDREPLACE, &CMyRichEditView::OnFindReplace)

Nella funzione OnFindReplace, interpreta le intenzioni dell'utente tramite CFindReplaceDialog::FindNext i metodi e è CFindReplaceDialog::IsTerminating creare il codice per il comando trova/operazioni di sostituzione.