Ressource DIALOG
Définit une boîte de dialogue. L’instruction définit la position et les dimensions de la boîte de dialogue à l’écran, ainsi que le style de boîte de dialogue.
Notes
DIALOG est un ID de ressource obsolète. Les nouvelles applications doivent utiliser DIALOGEX.
nameID DIALOG x, y, width, height [optional-statements] {control-statement . . . }
Paramètres
-
nameID
-
Nom unique ou valeur entière non signée unique 16 bits qui identifie la boîte de dialogue.
-
instructions facultatives
-
Options de la boîte de dialogue. Il peut s’agir de zéro ou plusieurs des instructions suivantes.
. Description LÉGENDE « text » Légende de la boîte de dialogue si elle a une barre de titre. Pour plus d’informations, consultez CAPTION. CARACTÉRISTIQUESdword Valeur DWORD définie par l’utilisateur pour une utilisation par les outils de ressources. Cette valeur n’est pas utilisée par le système. Pour plus d’informations, consultez CARACTÉRISTIQUES. Classe CLASS Entier non signé 16 bits ou chaîne, placé entre guillemets doubles (« ), qui identifie la classe de la boîte de dialogue. Pour plus d’informations, consultez CLASS. EXSTYLE=extended-styles Style de fenêtre étendu de la boîte de dialogue. Pour plus d’informations, consultez EXSTYLE. POLICEpointize, police de caractères Taille du point et police pour la police. Pour plus d’informations, consultez POLICE. Langue,sous-langage Langue de la boîte de dialogue. Pour plus d’informations, consultez LANGUAGE. MENUmenuname Menu à utiliser. Cette valeur est le nom du menu ou son identificateur entier. Styles STYLE Styles de la boîte de dialogue. Pour plus d’informations, consultez STYLE. VERSIONdword Valeur DWORD définie par l’utilisateur. Cette instruction est destinée à être utilisée par d’autres outils de ressources et n’est pas utilisée par le système. Pour plus d’informations, consultez VERSION.
Certains attributs sont également pris en charge pour la compatibilité descendante. Pour plus d’informations, consultez Attributs de ressources communs.
Notes
La fonction GetDialogBaseUnits retourne les unités de base de la boîte de dialogue en pixels. La signification exacte des coordonnées dépend du style défini par l’instruction d’option STYLE . Pour les boîtes de dialogue de style enfant, les coordonnées sont relatives à l’origine de la fenêtre parente, sauf si la boîte de dialogue a le style DS_ABSALIGN ; dans ce cas, les coordonnées sont relatives à l’origine de l’écran d’affichage.
N’utilisez pas le style WS_CHILD avec une boîte de dialogue modale. La fonction DialogBox désactive toujours le parent/propriétaire de la boîte de dialogue nouvellement créée. Lorsqu’une fenêtre parente est désactivée, ses fenêtres enfants sont implicitement désactivées. Étant donné que la fenêtre parente de la boîte de dialogue de style enfant est désactivée, la boîte de dialogue de style enfant l’est également.
Si une boîte de dialogue a le style DS_ABSALIGN , les coordonnées de la boîte de dialogue de son coin supérieur gauche sont relatives à l’origine de l’écran plutôt qu’à l’angle supérieur gauche de la fenêtre parente. Vous utilisez généralement ce style lorsque vous souhaitez que la boîte de dialogue démarre dans une partie spécifique de l’affichage, quel que soit l’emplacement de la fenêtre parente à l’écran.
Le nom DIALOG peut également être utilisé comme paramètre class-name de la fonction CreateWindow pour créer une fenêtre avec des attributs de boîte de dialogue.
Exemples
L’exemple suivant illustre l’utilisation de l’instruction DIALOG :
#include <windows.h>
ErrorDialog DIALOG 10, 10, 300, 110
STYLE WS_POPUP | WS_BORDER
CAPTION "Error!"
{
CTEXT "Select One:", 1, 10, 10, 280, 12
PUSHBUTTON "&Retry", 2, 75, 30, 60, 12
PUSHBUTTON "&Abort", 3, 75, 50, 60, 12
PUSHBUTTON "&Ignore", 4, 75, 80, 60, 12
}
Voir aussi