Méthode IPicture ::get_CurDC (ocidl.h)
Récupère le handle du contexte d’appareil actuel. Cette propriété est valide uniquement pour les images bitmap.
Syntaxe
HRESULT get_CurDC(
[out] HDC *phDC
);
Paramètres
[out] phDC
Pointeur d’une variable qui reçoit le contexte de l’appareil.
Valeur retournée
Cette méthode prend en charge la valeur de retour standard E_FAIL, ainsi que les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
Les bits d’attribut ont été retournés avec succès. |
|
La valeur de phDC n’est pas valide. Par exemple, il peut s’agir de NULL. |
Remarques
La propriété CurDC et la méthode IPicture ::SelectPicture existent pour contourner les restrictions dans Windows ; plus précisément, un objet ne peut être sélectionné que dans un seul contexte d’appareil à la fois. Dans certains cas, un objet image peut être sélectionné en permanence dans un contexte d’appareil particulier (par exemple, un contrôle peut utiliser une certaine image pour un arrière-plan). Pour utiliser cette propriété image ailleurs, elle doit être temporairement désélectionnée de son ancien contexte d’appareil, sélectionnée dans le nouveau contexte d’appareil pour l’opération, puis réélectionnée dans l’ancien contexte d’appareil. La méthode IPicture ::get_CurDC retourne le handle de contexte d’appareil dans lequel l’image est actuellement sélectionnée. La méthode IPicture ::SelectPicture sélectionne l’image dans un nouveau contexte d’appareil, en retournant l’ancien contexte d’appareil et le handle GDI de l’image. L’appelant doit sélectionner l’image dans l’ancien contexte de l’appareil lorsque l’appelant en a terminé, comme c’est normal pour le code Windows.
Remarques aux appelants
L’appelant est toujours propriétaire des contextes d’appareil passés entre lui et l’objet image. Étant donné que l’objet image conserve une copie du HDC, l’appelant doit utiliser un contexte de périphérique mémoire (créé avec la fonction CreateCompatibleDC ) et non un contexte de périphérique d’écran (à partir de GetDC, CreateDC ou BeginPaint), car les contextes de périphérique d’écran sont une ressource système limitée.Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ocidl.h |