Parametri di controllo comuni

Di seguito viene descritta la sintassi generale per un'istruzione control resource-definition. Il significato di ogni parametro è indicato di seguito. In alcuni casi, un'istruzione userà un parametro in modo diverso o potrebbe ignorare un parametro. La variante specifica dell'istruzione è descritta nella documentazione per l'istruzione .

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

Testo

Testo da visualizzare con il controllo . Il testo viene posizionato all'interno del controllo o adiacente al controllo.

Questo parametro deve contenere zero o più caratteri racchiusi tra virgolette doppie ("). Le stringhe vengono terminate automaticamente con null e convertite in Unicode nel file di risorse risultante.

Per impostazione predefinita, i caratteri elencati tra virgolette doppie sono caratteri ANSI e le sequenze di escape vengono interpretate come sequenze di escape di byte. Se la stringa è preceduta dal prefisso "L", la stringa è una stringa di caratteri wide e le sequenze di escape vengono interpretate come sequenze di escape a 2 byte che specificano caratteri Unicode. Se nel testo è necessaria una virgoletta doppia, è necessario includere due volte le virgolette doppie.

Un carattere e commerciale (&) nel testo indica che il carattere seguente viene utilizzato come carattere mnemonico per il controllo. Quando il controllo viene visualizzato, la e commerciale non viene visualizzata, ma il carattere mnemonico è sottolineato. L'utente può scegliere il controllo premendo il tasto corrispondente al carattere mnemonico sottolineato. Per utilizzare la e commerciale come carattere in una stringa, inserire due e commerciale (&).

id

Identificatore del controllo. Questo valore deve essere un intero senza segno a 16 bit nell'intervallo compreso tra 0 e 65.535 o una semplice espressione aritmetica che restituisce un valore in tale intervallo.

x

Coordinata X del lato sinistro del controllo rispetto al lato sinistro della finestra di dialogo. Questo valore deve essere un intero senza segno a 16 bit nell'intervallo compreso tra 0 e 65.535. La coordinata si trova in unità di dialogo e è relativa all'origine della finestra di dialogo, della finestra o del controllo contenente il controllo specificato.

y

Coordinata Y del lato superiore del controllo rispetto alla parte superiore della finestra di dialogo. Questo valore deve essere un intero senza segno a 16 bit nell'intervallo compreso tra 0 e 65.535. La coordinata si trova in unità di dialogo relative all'origine della finestra di dialogo, della finestra o del controllo contenente il controllo specificato.

width

Larghezza del controllo. Questo valore deve essere un intero senza segno a 16 bit nell'intervallo compreso tra 1 e 65.535. La larghezza è espressa in unità di 1/4 caratteri.

height

Altezza del controllo. Questo valore deve essere un intero senza segno a 16 bit nell'intervallo compreso tra 1 e 65.535. L'altezza è espressa in unità di 1/8 caratteri.

style

Stili di controllo. Utilizzare l'operatore OR bit per bit (|) per combinare gli stili. Per altre informazioni, vedere Stili finestra.

stile esteso

Stili delle finestre estese. È necessario specificare lo stile per specificare lo stile esteso. Per altre informazioni, vedere EXSTYLE.

helpId

Espressione numerica che indica l'ID utilizzato per identificare il controllo durante l'elaborazione WM_HELP.

controlData

Dati specifici del controllo per il controllo. Quando viene creata una finestra di dialogo e un controllo in tale finestra di dialogo con dati specifici del controllo, viene passato un puntatore a tali dati nella routine della finestra del controllo tramite lParam del messaggio di WM_CREATE per tale controllo.

Osservazioni:

Le unità di dialogo orizzontali sono 1/4 dell'unità di larghezza di base del dialogo. Le unità verticali sono 1/8 dell'unità di altezza di base del dialogo. Le unità di base del dialogo correnti vengono calcolate in base all'altezza e alla larghezza del tipo di carattere di sistema corrente. La funzione GetDialogBaseUnits restituisce le unità di base del dialogo in pixel. Le coordinate sono relative all'origine della finestra di dialogo.