Struttura FINDREPLACEA (commdlg.h)

Articolo
02/26/2024

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 tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

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
FR_DIALOGTERM 0x00000040	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.
FR_DOWN 0x00000001	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.
FR_ENABLEHOOK 0x00000100	Abilita la funzione hook specificata nel membro lpfnHook . Questo flag viene usato solo per inizializzare la finestra di dialogo.
FR_ENABLETEMPLATE 0x00000200	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.
FR_ENABLETEMPLATEHANDLE 0x00002000	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.
FR_FINDNEXT 0x00000008	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.
FR_HIDEUPDOWN 0x00004000	Se impostato durante l'inizializzazione di una finestra di dialogo Trova , nasconde i pulsanti di opzione direzione di ricerca.
FR_HIDEMATCHCASE 0x00008000	Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci , nasconde la casella di controllo Match Case .
FR_HIDEWHOLEWORD 0x00010000	Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci, nasconde la casella di controllo Corrispondenza intero Word Solo.
FR_MATCHCASE 0x00000004	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.
FR_NOMATCHCASE 0x00000800	Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci , disabilita la casella di controllo Match Case .
FR_NOUPDOWN 0x00000400	Se impostato durante l'inizializzazione di una finestra di dialogo Trova , disabilita i pulsanti di opzione direzione di ricerca.
FR_NOWHOLEWORD 0x00001000	Se impostato durante l'inizializzazione di una finestra di dialogo Trova o Sostituisci, disabilita la casella di controllo Intero Word.
FR_REPLACE 0x00000010	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.
FR_REPLACEALL 0x00000020	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.
FR_SHOWHELP 0x00000080	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 .
FR_WHOLEWORD 0x00000002	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 eseghi l'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 routine hook identificata dal membro lpfnHook . Quando il sistema invia il messaggio WM_INITDIALOG alla routine hook, il parametro lParam del messaggio è un puntatore alla struttura FINDREPLACE specificata al momento della creazione del dialogo. La procedura hook può usare questo puntatore per ottenere il valore lCustData .

lpfnHook

Tipo: LPFRHOOKPROC

Puntatore a una routine hook FRHookProc in grado di elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag FR_ENABLEHOOK non sia impostato nel membro Flags . Se la routine hook restituisce FALSE in risposta al messaggio di WM_INITDIALOG , la procedura hook deve visualizzare la finestra di dialogo. In caso contrario, 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 con il modello della finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, può trattarsi di un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	commdlg.h (include Windows.h)