PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE


  • Annuler l'attachement existant
  • Différence entre BinaireCharge et HAttacheMémo
  • HAttacheMémo et Accès distant (RPC)
  • Vignettes HFSQL
  • Gestion des mémos sous SQLite
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Permet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
Le fichier sera lu et ajouté au mémo uniquement lors de l'ajout ou de la modification de l'enregistrement (fonction HAjoute, HModifie ou HEcrit). Si le fichier est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
La fonction HExtraitMémo permettra d'extraire le fichier contenu dans le mémo sur le disque dur.
Remarque : Il est également possible d'utiliser l'affectation directe :
  • Pour associer directement une image (contenue dans un champ Image) à un mémo image :
    <NomFichier>.<NomRubriqueMémo> = <NomChampImage>

    Par exemple :
    UnFichier.UneRubriqueMémo = IMG_UnChampImage

    Cette syntaxe peut être utilisée aussi bien avec le moteur HFSQL qu'avec les Accès Natifs.
    <NomFichier>.<NomRubriqueMémo> = <NomBuffer>

    Par exemple :
    bufFichier est un Buffer = fChargeBuffer("MonFichier")
    MonFichier.MonMémo = bufFichier
Versions 15 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
Android Cette fonction est désormais disponible pour les applications Android.
Android Cette fonction est désormais disponible pour les applications Android.
Versions 17 et supérieures
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Widget Android Cette fonction est désormais disponible en mode Widget Android.
Universal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
// Attache une image à l'enregistrement
HAttacheMémo(Produit, Image_Produit, "C:\Images\Produit1.gif", hMémoImg)
// Transfère le contenu des champs dans le buffer du fichier
EcranVersFichier()
// Ajoute l'enregistrement
HAjoute(Produit)
Syntaxe

Associer un fichier à une rubrique de type mémo binaire Masquer les détails

<Résultat> = HAttacheMémo(<Nom du fichier> , <Nom de la rubrique> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom du fichier de données (ou de la requête) contenant une rubrique mémo. Si seuls les paramètres <Nom du fichier> et <Nom de la rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Nom de la rubrique> : Chaîne de caractères (avec ou sans guillemets)
Nom de la rubrique mémo du fichier de données dans laquelle le fichier binaire doit être ajouté. Si seuls les paramètres <Nom du fichier> et <Nom de la rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
    Windows Mobile Il n'est pas possible d'utiliser de chemin relatif.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
AndroidWidget AndroidJava Si un chemin est spécifié, ce chemin doit correspondre à un fichier existant. Dans le cas contraire, une erreur fatale est affichée.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
AndroidWidget AndroidJava Cette constante n'est pas disponible.
Versions 24 et supérieures
AndroidWidget AndroidJava Cette constante est désormais disponible.
Nouveauté 24
AndroidWidget AndroidJava Cette constante est désormais disponible.
AndroidWidget AndroidJava Cette constante est désormais disponible.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.

AndroidWidget AndroidJavaPHPOLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
PHPOLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
Versions 20 et supérieures
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
Nouveauté 20
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
AndroidWidget AndroidJavaPHPOLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
PHPOLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
Versions 20 et supérieures
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
Nouveauté 20
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
AndroidWidget AndroidJava Ce paramètre est disponible uniquement pour les fichiers de données au format HFSQL.
Versions 19 et supérieures
WINDEVWEBDEV - Code ServeurWindows Mobile

Associer un fichier à une rubrique de type mémo binaire via une variable de type Enregistrement Masquer les détails

<Résultat> = HAttacheMémo(<Rubrique mémo> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Rubrique mémo> : Variable de type Enregistrement
Rubrique mémo dans laquelle le fichier binaire doit être ajouté. Utilisez la notation <Nom variable Enregistrement>.<Nom rubrique mémo>. Si seul le paramètre <Rubrique mémo> est précisé, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
    Windows Mobile Il n'est pas possible d'utiliser de chemin relatif.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
OLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
Nouveauté 19
WINDEVWEBDEV - Code ServeurWindows Mobile

Associer un fichier à une rubrique de type mémo binaire via une variable de type Enregistrement Masquer les détails

<Résultat> = HAttacheMémo(<Rubrique mémo> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Rubrique mémo> : Variable de type Enregistrement
Rubrique mémo dans laquelle le fichier binaire doit être ajouté. Utilisez la notation <Nom variable Enregistrement>.<Nom rubrique mémo>. Si seul le paramètre <Rubrique mémo> est précisé, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
    Windows Mobile Il n'est pas possible d'utiliser de chemin relatif.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
OLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
WINDEVWEBDEV - Code ServeurWindows Mobile

Associer un fichier à une rubrique de type mémo binaire via une variable de type Enregistrement Masquer les détails

<Résultat> = HAttacheMémo(<Rubrique mémo> [, <Fichier à attacher> [, <Type> [, <Informations>]]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur. Si le fichier à associer est ouvert en écriture et si la constante hAccepteFichierOuvert n'a pas été utilisée, la fonction renverra une erreur.
<Rubrique mémo> : Variable de type Enregistrement
Rubrique mémo dans laquelle le fichier binaire doit être ajouté. Utilisez la notation <Nom variable Enregistrement>.<Nom rubrique mémo>. Si seul le paramètre <Rubrique mémo> est précisé, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
<Fichier à attacher> : Chaîne de caractères optionnelle
Nom du fichier à associer à la rubrique de type mémo binaire. Ce nom peut correspondre :
  • soit au chemin complet du fichier à attacher,
  • soit au chemin relatif (par rapport au répertoire en cours) du fichier à attacher.
    Windows Mobile Il n'est pas possible d'utiliser de chemin relatif.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), l'attachement en cours est supprimé.
<Type> : Combinaison de constantes de type Entier, optionnelle
Indique le type du fichier et le mode de lecture du fichier.
hAccepteFichierOuvertAutorise la lecture du fichier source à ajouter dans le mémo si ce fichier source est ouvert en écriture par ailleurs.
Cette constante peut être combinée avec les constantes de type du fichier.
hMémoBin
(valeur par défaut)
Le fichier est un fichier binaire quelconque.
hMémoImgLe fichier est de type image.
hMémoOleLe fichier est de type OLE.
hMémoWavLe fichier est de type son.
<Informations> : Chaîne de caractères optionnelle
Message d'information (65535 caractères maximum) stocké avec le fichier. Ce message peut être relu grâce à la fonction HInfoMémo.
OLE DBAccès Natifs Ce paramètre n'est pas pris en compte.
Remarques

Annuler l'attachement existant

Si seuls les paramètres <Nom du fichier> et <Nom de la rubrique> sont précisés, la fonction HAttacheMémo annule l'attachement existant entre le fichier binaire et la rubrique.
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBAccès Natifs

Différence entre BinaireCharge et HAttacheMémo

A la différence de la fonction BinaireCharge, la fonction HAttacheMémo ne charge pas le fichier binaire en mémoire. Il n'y a donc aucun risque de saturation de la mémoire lors de l'association d'un fichier de taille importante à une rubrique de type mémo.
WINDEVWEBDEV - Code ServeurEtats et RequêtesWindows MobileAjaxCode Utilisateur (MCU)Langage ExterneProcédures stockées

HAttacheMémo et Accès distant (RPC)

La fonction HAttacheMémo cherche le fichier à attacher sur le serveur RPC (même si la fonction est exécutée en local sur un poste distant).
Pour insérer dans un mémo un fichier présent en local et non pas sur le serveur RPC, il faut affecter son contenu complet à la rubrique mémo, sans appeler la fonction HAttacheMémo.
Exemple : Insérer depuis une application WINDEV Mobile une image présente dans le répertoire de l'exécutable :
sImage est une chaîne
sImage = fRepExe() + "\signature.jpg"
BufferFichier est un Buffer
BufferFichier = fChargeTexte(sImage)
FichierSurServeurRPC.RubImage = UnicodeVersAnsi(BufferFichier)
HAjoute(FichierSurServeurRPC)
L'image est envoyée au serveur RPC lors de l'ajout. Le serveur RPC se charge de l'insérer dans le mémo, que la connexion à la base soit en OLE DB ou en accès natif.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows MobileUniversal Windows 10 AppJavaAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockées

Vignettes HFSQL

Si la rubrique manipulée utilise des vignettes HFSQL, les vignettes seront automatiquement générées avec le nouveau fichier lors de l'ajout ou de la modification de l'enregistrement (fonctions HAjoute, HModifie ou HEcrit).
Accès Natifs

Gestion des mémos sous SQLite

Le stockage d'informations sous forme de mémos est conseillé uniquement pour des données de taille peu volumineuse (inférieures à 1 Mo). Il est recommandé d'enregistrer directement les données sous forme de fichier externe sur la mémoire du téléphone (interne ou externe) et de mémoriser dans la base uniquement le chemin d'accès à ces données.
Composante : wd240hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire