Struttura FINDREPLACEW (commdlg.h)
Contiene informazioni usate dalle funzioni FindText e ReplaceText per inizializzare le finestre di dialogo Trova e Sostituisci . Il messaggio registrato FINDMSGSTRING usa questa struttura per passare l'input di ricerca o sostituzione dell'utente alla finestra proprietario di una finestra di dialogo Trova o Sostituisci .
Sintassi
typedef struct tagFINDREPLACEW {
DWORD lStructSize;
HWND hwndOwner;
HINSTANCE hInstance;
DWORD Flags;
LPWSTR lpstrFindWhat;
LPWSTR lpstrReplaceWith;
WORD wFindWhatLen;
WORD wReplaceWithLen;
LPARAM lCustData;
LPFRHOOKPROC lpfnHook;
LPCWSTR lpTemplateName;
} FINDREPLACEW, *LPFINDREPLACEW;
Members
lStructSize
Tipo: DWORD
Lunghezza, in byte, della struttura.
hwndOwner
Tipo: HWND
Handle nella finestra che possiede la finestra di dialogo. La procedura della finestra specificata riceve messaggi FINDMSGSTRING dalla finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido, ma non deve essere NULL.
hInstance
Tipo: HINSTANCE
Se il flag FR_ENABLETEMPLATEHANDLE è impostato nei Flag, hInstance è un handle per un oggetto memoria contenente un modello di finestra di dialogo. Se il flag FR_ENABLETEMPLATE è impostato, hInstance è un handle su un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName . Se nessun flag è impostato, questo membro viene ignorato.
Flags
Tipo: DWORD
Set di flag di bit che è possibile usare per inizializzare la finestra di dialogo. La finestra di dialogo imposta questi flag quando invia il messaggio registrato FINDMSGSTRING per indicare l'input dell'utente. Questo membro può essere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Se impostato in un messaggio FINDMSGSTRING , indica che la finestra di dialogo viene chiusa. Quando viene visualizzato un messaggio con questo set di flag, la finestra di dialogo gestita restituita dalla funzione FindText o ReplaceText non è più valida. |
|
Se impostato, il pulsante Giù dei pulsanti di opzione direzione in una finestra di dialogo Trova è selezionato che indica che è necessario cercare dalla posizione corrente alla fine del documento. Se non è impostato, il pulsante Up viene selezionato in modo da cercare all'inizio del documento. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio FINDMSGSTRING , indica la selezione dell'utente. |
|
Abilita la funzione hook specificata nel membro lpfnHook . Questo flag viene usato solo per inizializzare la finestra di dialogo. |
|
Indica che i membri hInstance e lpTemplateName specificano un modello di finestra di dialogo da usare al posto del modello predefinito. Questo flag viene usato solo per inizializzare la finestra di dialogo. |
|
Indica che il membro hInstance identifica un blocco di dati contenente un modello di finestra di dialogo precaricati. Il sistema ignora il membro lpTemplateName se questo flag è specificato. |
|
Se impostato in un messaggio FINDMSGSTRING , indica che l'utente ha fatto clic sul pulsante Trova avanti in una finestra di dialogo Trova o Sostituisci . Il membro lpstrFindWhat specifica la stringa da cercare. |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova , nasconde i pulsanti di opzione direzione di ricerca. |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci , nasconde la casella di controllo Match Case . |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci, nasconde la casella di controllo Corrispondenza intero Word Solo. |
|
Se impostata, la casella di controllo Match Case è selezionata che indica che la ricerca deve essere distinzione tra maiuscole e minuscole. Se non è impostata, la casella di controllo non è selezionata in modo che la ricerca debba essere senza distinzione tra maiuscole e minuscole. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio FINDMSGSTRING , indica la selezione dell'utente. |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci , disabilita la casella di controllo Match Case . |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova , disabilita i pulsanti di opzione direzione di ricerca. |
|
Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci, disabilita la casella di controllo Intero Word. |
|
Se impostato in un messaggio FINDMSGSTRING, indica che l'utente ha fatto clic sul pulsante Sostituisci in una finestra di dialogo Sostituisci. Il membro lpstrFindWhat specifica la stringa da sostituire e il membro lpstrReplaceWith specifica la stringa di sostituzione. |
|
Se impostato in un messaggio FINDMSGSTRING , indica che l'utente ha fatto clic sul pulsante Sostituisci tutto in una finestra di dialogo Sostituisci . Il membro lpstrFindWhat specifica la stringa da sostituire e il membro lpstrReplaceWith specifica la stringa di sostituzione. |
|
Fa sì che la finestra di dialogo visualizzi il pulsante Guida . Il membro hwndOwner deve specificare la finestra per ricevere i messaggi registrati HELPMSGSTRING inviati dalla finestra di dialogo quando l'utente fa clic sul pulsante Guida . |
|
Se impostata, la casella di controllo Match Whole Word Only è selezionata che indica che è necessario cercare solo parole intere che corrispondono alla stringa di ricerca. Se non è impostata, la casella di controllo non è selezionata in modo da cercare anche frammenti di parola corrispondenti 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
Tipo: LPTSTR
Stringa di ricerca digitata dall'utente nel controllo Trova cosa modificare. È necessario allocare dinamicamente il buffer o usare una matrice globale o statica in modo che non esce dall'ambito prima della chiusura della finestra di dialogo. Il buffer deve essere di almeno 80 caratteri. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel controllo Trova cosa modificare. 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 i flag FR_REPLACE o FR_REPLACE , lpstrFindWhat contiene la stringa da sostituire.
lpstrReplaceWith
Tipo: LPTSTR
Stringa di sostituzione digitata dall'utente nel controllo Sostituisci con modifica. È necessario allocare dinamicamente il buffer o usare una matrice globale o statica in modo che non esce dall'ambito 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 Sostituisci con modifica.
Se un messaggio FINDMSGSTRING specifica i flag FR_REPLACE o FR_REPLACEALL , lpstrReplaceWith contiene la stringa di sostituzione .
La funzione FindText ignora questo membro.
wFindWhatLen
Tipo: WORD
Lunghezza, in byte, del buffer a cui punta il membro lpstrFindWhat .
wReplaceWithLen
Tipo: WORD
Lunghezza, in byte, del buffer a cui punta il membro lpstrReplaceWith .
lCustData
Tipo: LPARAM
Dati definiti dall'applicazione che il sistema passa alla procedura di hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio di WM_INITDIALOG alla procedura di hook, il parametro lParam del messaggio è un puntatore alla struttura FINDREPLACE specificata al momento della creazione della finestra di dialogo. La procedura di hook può usare questo puntatore per ottenere il valore lCustData .
lpfnHook
Tipo: LPFRHOOKPROC
Puntatore a una routine di hook FRHookProc che può elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag di FR_ENABLEHOOK non sia impostato nel membro Flags . Se la procedura di hook restituisce FALSE in risposta al messaggio WM_INITDIALOG , la procedura di hook deve visualizzare la finestra di dialogo oppure la finestra di dialogo non verrà visualizzata. A tale scopo, eseguire prima qualsiasi altra operazione di disegno e quindi chiamare le funzioni ShowWindow e UpdateWindow .
lpTemplateName
Tipo: LPCTSTR
Nome della risorsa modello della finestra di dialogo nel modulo identificato dal membro hInstance . Questo modello viene sostituito per il modello di finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, questo può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag di FR_ENABLETEMPLATE non sia impostato nel membro Flags .
Commenti
Nota
L'intestazione commdlg.h definisce FINDREPLACE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | commdlg.h (includere Windows.h) |
Vedi anche
Libreria di finestre di dialogo comuni
Informazioni concettuali
Riferimento