Struttura FINDREPLACEA (commdlg.h)

Articolo
11/20/2024

Contiene informazioni utilizzate dalle funzioni FindText e ReplaceText per inizializzare le finestre di dialogo Trova e Sostituisci . Il messaggio registrato FINDMSGSTRING utilizza questa struttura per passare l'input di ricerca o sostituzione dell'utente alla finestra di proprietario di un trova o finestra di dialogo 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;

Membri

lStructSize

Tipo: DWORD

Lunghezza, in byte, della struttura.

hwndOwner

Tipo: HWND

Handle per la finestra proprietaria della finestra di dialogo. La procedura della finestra specificata riceve FINDMSGSTRING messaggi 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 nella Flag, hInstance è un handle per un oggetto memoria contenente un modello di finestra di dialogo. Se il flag FR_ENABLETEMPLATE è impostato, hInstance è un handle per un modulo che contiene un modello di finestra di dialogo denominato dal membro lpTemplateName. Se nessuno dei due 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 FINDMSGSTRING messaggio registrato 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 di FINDMSGSTRING, indica che la finestra di dialogo è chiusa. Quando viene visualizzato un messaggio con questo flag impostato, l'handle della finestra di dialogo restituito dalla FindText o funzione ReplaceText non è più valida.
FR_DOWN 0x00000001	Se impostata, viene selezionato il pulsante giù dei pulsanti di opzione direzione in una finestra di dialogo trova che indica che è necessario cercare dalla posizione corrente alla fine del documento. Se non è impostato, viene selezionato il pulsante su in modo da eseguire una ricerca all'inizio del documento. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio di FINDMSGSTRING, indica la selezione dell'utente.
FR_ENABLEHOOK 0x00000100	Abilita la funzione hook specificata nel membro lpfnHook. Questo flag viene utilizzato solo per inizializzare la finestra di dialogo.
FR_ENABLETEMPLATE 0x00000200	Indica che hInstance e lpTemplateName membri specificano un modello di finestra di dialogo da usare al posto del modello predefinito. Questo flag viene utilizzato 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 precaricata. Il sistema ignora il membro lpTemplateName se viene specificato questo flag.
FR_FINDNEXT 0x00000008	Se impostato in un messaggio di FINDMSGSTRING, indica che l'utente ha fatto clic sul pulsante Trova successivo 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 un finestra di dialogo Trova, nasconde i pulsanti di opzione della direzione di ricerca.
FR_HIDEMATCHCASE 0x00008000	Se impostato durante l'inizializzazione di un trova o finestra di dialogo Sostituisci, nasconde la casella di controllo maiuscole/minuscole.
FR_HIDEWHOLEWORD 0x00010000	Se impostata durante l'inizializzazione di un trova o finestra di dialogo Sostituisci, nasconde la casella di controllo solo parole intere .
FR_MATCHCASE 0x00000004	Se impostata, viene selezionata la casella di controllo caso di corrispondenza che indica che la ricerca deve fare distinzione tra maiuscole e minuscole. Se non è impostata, la casella di controllo non è selezionata in modo che la ricerca non sia distinzione tra maiuscole e minuscole. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio di FINDMSGSTRING, indica la selezione dell'utente.
FR_NOMATCHCASE 0x00000800	Se impostato durante l'inizializzazione di un trova o finestra di dialogo Sostituisci, disabilita la casella di controllo match case.
FR_NOUPDOWN 0x00000400	Se impostato durante l'inizializzazione di un finestra di dialogo Trova, disabilita i pulsanti di opzione di direzione di ricerca.
FR_NOWHOLEWORD 0x00001000	Se impostata durante l'inizializzazione di un trova o finestra di dialogo Sostituisci, disabilita la casella di controllo Interi di Word.
FR_REPLACE 0x00000010	Se impostato in un messaggio di 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 di 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 il HELPMSGSTRING messaggi registrati inviati dalla finestra di dialogo quando l'utente fa clic sul pulsante Guida.
FR_WHOLEWORD 0x00000002	Se impostata, viene selezionata la casella di controllo Corrispondenza solo parola intera che indica che è necessario cercare solo parole intere che corrispondono alla stringa di ricerca. Se non è impostata, la casella di controllo non è selezionata, pertanto è consigliabile cercare anche frammenti di parola che corrispondono alla stringa di ricerca. È possibile impostare questo flag per inizializzare la finestra di dialogo. Se impostato in un messaggio di FINDMSGSTRING, indica la selezione dell'utente.

lpstrFindWhat

Tipo: LPTSTR

Stringa di ricerca digitata dall'utente nel controllo di modifica Trova. È 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. Il buffer deve contenere almeno 80 caratteri. Se il buffer contiene una stringa quando si inizializza la finestra di dialogo, la stringa viene visualizzata nel Trova quale controllo di modifica. Se un messaggio FINDMSGSTRING specifica il flag FR_FINDNEXT, lpstrFindWhat contiene la stringa da cercare. I flag FR_DOWN, FR_WHOLEWORDe FR_MATCHCASE indicano la direzione e il tipo di ricerca. Se un messaggio di 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 di modifica Sostituisci con. È 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 nella Sostituisci con controllo di modifica.

Se un messaggio di 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 passati dal sistema alla routine hook identificata dal membro lpfnHook. Quando il sistema invia il messaggio di 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 un FRHookProc routine hook in grado di 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 flag . Se la routine hook restituisce false in risposta al messaggio di WM_INITDIALOG, la routine 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 dal modello della finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, 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 flag .

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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)