FINDREPLACE

La struttura FINDREPLACE contiene informazioni che le funzioni di ReplaceText e trova testo utilizzano per inizializzare le finestre di dialogo comuni trova e Sostituisci . Il messaggio registrato FINDMSGSTRING utilizza questa struttura per passare la ricerca dell'utente o sostituzione input alla finestra del proprietario di una casella di dialogo comune trovare o sostituire.

typedef struct {/ / fr DWORD lStructSize; 
    HWND hwndOwner; 
    HINSTANCE hInstance; 
    DWORD Flags; 
    LPTSTR lpstrFindWhat; 
    LPTSTR lpstrReplaceWith; 
    WORD wFindWhatLen; 
    WORD wReplaceWithLen; 
    LPARAM lCustData; 
    LPFRHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} FINDREPLACE 
 

Membri

lStructSize
Specifica la lunghezza in byte, della struttura.
hwndOwner
Identifica la finestra che possiede la finestra di dialogo. La routine di finestra della finestra specificata riceve messaggi FINDMSGSTRING nella finestra di dialogo. Questo membro può essere alcun handle di finestra valido, ma non può essere NULL.
hInstance
Se nel membro flag è impostato il flag FR_ENABLETEMPLATEHANDLE, hInstance è l'handle di un oggetto di memoria contenente un modello di finestra di dialogo. Se è impostato il flag FR_ENABLETEMPLATE, hInstance identifica un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName . Se nessuna delle due flag è impostato, questo membro viene ignorato.
Bandiere
Un insieme di flag di bit che è possibile utilizzare per inizializzare la finestra di dialogo. Il box di dialogo set queste bandiere quando invia la FINDMSGSTRING registrato il messaggio per indicare l'input dell'utente. Questo membro può essere una combinazione dei seguenti flag:
Bandiera Significato
FR_DIALOGTERM
Se impostato in un messaggio FINDMSGSTRING, indica che si sta chiudendo la finestra di dialogo. Quando si riceve un messaggio con questo flag impostato, l'handle della finestra di dialogo casella restituito dalla funzione trova testo o ReplaceText è non più valido.
FR_DOWN
Se è stato selezionato insieme, il pulsante giù dei pulsanti di direzione in una finestra di dialogo trova che indica che dovrebbero ricerca dalla posizione corrente fino alla fine del documento. Se non è impostato, il pulsante è selezionato così dovrebbe cercate per l'inizio del documento. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio FINDMSGSTRING, indica la selezione dell'utente.
FR_ENABLEHOOK
Attiva la funzione di hook specificata nel membro lpfnHook . Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
FR_ENABLETEMPLATE
Indica che i membri hInstance e lpTemplateName specificano un modello di finestra di dialogo da utilizzare al posto del modello predefinito. Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
FR_ENABLETEMPLATEHANDLE
Indica che il membro hInstance identifica un blocco di dati che contiene un modello di finestra di dialogo precaricati. Il sistema ignora il membro lpTemplateName se questo flag viene specificato.
FR_FINDNEXT
Se impostato in un messaggio FINDMSGSTRING, indica che l'utente fatto clic sul pulsante trova successivo in una finestra di dialogo trova o sostituire . Il membro lpstrFindWhat specifica la stringa da cercare.
FR_HIDEUPDOWN
Se impostato durante l'inizializzazione di una finestra di dialogo trova , nasconde i pulsanti di ricerca direzione.
FR_HIDEMATCHCASE
Se la casella di controllo insieme durante l'inizializzazione di un trovare o sostituire nella finestra di dialogo, si nasconde ilcaso .
FR_HIDEWHOLEWORD
Se impostato durante l'inizializzazione di un trovare o sostituire nella finestra di dialogo, si nasconde la partita intera parola sola casella.
FR_MATCHCASE
Se insieme, la casella di controlloCase Matchviene controllato che indica che la ricerca dovrebbe essere tra maiuscole e minuscole. Se non insieme, la casella di controllo è deselezionata, quindi la ricerca dovrebbe essere maiuscole e minuscole. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio FINDMSGSTRING, indica la selezione dell'utente .
FR_NOMATCHCASE
Se la casella di controllo insieme durante l'inizializzazione di un trovare o sostituire nella finestra di dialogo, disabilita ilcaso .
FR_NOUPDOWN
Se impostato durante l'inizializzazione di una finestra di dialogo trova , disabilita i pulsanti di ricerca direzione.
FR_NOWHOLEWORD
Se impostato durante l'inizializzazione di un trovare o sostituire nella finestra di dialogo, disabilita l'intera parola casella.
FR_REPLACE
Se impostato in un messaggio FINDMSGSTRING, indica che l'utente cliccato il pulsante di sostituire in una finestra di dialogo di sostituire . Il membro lpstrFindWhat specifica la stringa da sostituire e il membro lpstrReplaceWith specifica la stringa di sostituzione.
FR_REPLACEALL
Se impostato in un messaggio FINDMSGSTRING, indica che l'utente fatto clic sul pulsante sostituire tutti in una finestra di dialogo di sostituire . Il membro lpstrFindWhat specifica la stringa da sostituire e il membro lpstrReplaceWith specifica la stringa di sostituzione.
FR_SHOWHELP
Provoca la finestra di dialogo visualizzare il pulsante Help . Il membro hwndOwner deve specificare la finestra per ricevere il HELPMSGSTRING registrati messaggi inviati nella finestra di dialogo quando l'utente fa clic sul pulsante Guida.
FR_WHOLEWORD
Se insieme, la partita intera parola solo casella di controllo è selezionata che indica che deve cercare solo per parole intere che corrispondono alla stringa di ricerca. Se non insieme, la casella di controllo è deselezionata, così dovrebbe anche cercare frammenti di parola che corrispondono alla stringa di ricerca. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio FINDMSGSTRING, indica la selezione dell'utente.

lpstrFindWhat
Puntatore a un buffer che un messaggio FINDMSGSTRING utilizza per passare la stringa di ricerca terminati null che l'utente digitato nel trovare ciò che controllo di modifica. Devi allocare il buffer in modo dinamico o utilizzare una matrice globale o statica in modo non escono dall'ambito consentito prima della chiusura della finestra di dialogo. Il buffer deve essere lunga almeno 80 caratteri. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel controllo di trovare ciò che modifica.

Se un messaggio FINDMSGSTRING specifica il flag FR_FINDNEXT, lpstrFindWhat contiene la stringa da cercare. I flag FR_DOWN, FR_WHOLEWORD e FR_MATCHCASE indicano la direzione e il tipo di ricerca. Se un messaggio FINDMSGSTRING specifica che il FR_REPLACE o il FR_REPLACE bandiere, lpstrFindWhat contiene la stringa da sostituire.

lpstrReplaceWith
Puntatore a un buffer che un messaggio FINDMSGSTRING utilizza per passare la stringa di sostituzione terminato null che l'utente digitato nel sostituirlocon controllo di modifica. Devi allocare il buffer in modo dinamico o utilizzare una matrice globale o statica in modo non escono dall'ambito consentito prima della chiusura della finestra di dialogo. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel controllo di modifica sostituirlocon .

Se un messaggio FINDMSGSTRING specifica i flag FR_REPLACE o FR_REPLACEALL, lpstrReplaceWith contiene la stringa di sostituzione.

La funzione trova testo ignora questo membro.

wFindWhatLen
Specifica la lunghezza in byte, del buffer a cui puntata il membro lpstrFindWhat.
wReplaceWithLen
Specifica la lunghezza in byte, del buffer a cui puntata il membro lpstrReplaceWith.
lCustData
Specifica i dati definiti dall'applicazione che il sistema passa alla routine di hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio WM_INITDIALOG per la routine di hook, parametro lParam del messaggio è che un puntatore alla struttura FINDREPLACE specificato quando fu creata la finestra di dialogo. La routine di hook può utilizzare questo puntatore per ottenere il valore di lCustData.
lpfnHook
Puntatore a un FRHookProc gancio procedura che consente di elaborare i messaggi destinati a nella finestra di dialogo. Questo membro viene ignorato a meno che il flag FR_ENABLEHOOK è impostato nel membro flag.

Se la routine di hook restituisce FALSE in risposta al messaggio WM_INITDIALOG, la routine di hook deve visualizzare la finestra di dialogo o altrimenti non verrà visualizzata nella finestra di dialogo. Per fare questo, prima di eseguire altre operazioni di vernice e quindi chiamare le funzioni ShowWindow e UpdateWindow.

lpTemplateName
Puntatore a una stringa con terminazione null che assegna la risorsa modello di finestra casella nel modulo identificato dal membro hInstance . Questo modello viene sostituito con il modello di finestra di dialogo standard. Per le risorse di casella di dialogo numerati, questo può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag FR_ENABLETEMPLATE è impostato nel membro flag.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in commdlg.h.
Unicode:Definito come strutture di Unicode e ANSI.

Vedi anche

Comuni Dialog Box Library panoramica, strutture di Box di dialogo comuni, FindText, FRHookProc, MAKEINTRESOURCE, ReplaceText, ShowWindow, UpdateWindow, WM_INITDIALOG

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index