Funkcia %HI_From_Clipboard

Funkcia
Funkcia vloží obsah schránky (clipboardu) do celej lokálnej štruktúrovanej premennej (t.j. lokálna premenná typu Record) alebo jej stĺpca.
Deklarácia
%HI_From_Clipboard(
   HBJ out _struct
   [, TEXT in timeMask]
 )

 
alebo
Deklarácia
%HI_From_Clipboard(
        out _struct^Col
   [, TEXT in timeMask]
 )

Parametre
_struct Identifikátor lokálnej premennej typu Record.
_struct^Col Názov stĺpca v lokálnej premennej.
timeMask Maska pre čítanie hodnoty typu Absolútny čas (nepovinný parameter).

Popis
Funkcia prečíta obsah schránky (vložený do schránky pomocou funkcie %HI_To_Clipboard) a následne ho konvertuje do hodnôt lokálnej premennej.
Ak je v parametroch uvedené meno stĺpca (alebo položka v stĺpci), funkcia konvertuje len prvý stĺpec zo schránky a vloží ho do daného stĺpca lokálnej premennej. Inak sa snaží konvertovať taký počet stĺpcov, koľko ich obsahuje lokálna premenná.

Ak je počet stĺpcov v schránke menší ako v lokálnej premennej, chýbajúce stĺpce budú v lokálnej premennej nahradené neplatnými hodnotami.
Ak je počet stĺpcov v schránke väčší ako v lokálnej premennej, tieto budú ignorované.

Funkcia v prípade potreby zmení rozmer štruktúry.

Stĺpce v schránke sú od seba oddelené horizontálnym tabulátorom.
Poznámka
Ak parameter timeMask:
  • nie je uvedený - konverzia prebieha podľa textovej masky dd.mm.rrrr hh:mm:ss
  • je definovaný a je rôzny od masky "" (prázdna maska) - konverzia prebieha podľa zadanej textovej masky
  • je zadaný a je rovný "" (prázdna maska) - konverzia absolútneho času a reálnych hodnôt prebieha podľa nastavení v Regional and Language Options aktuálneho užívateľa
V prípade, že chýba hh, mm alebo ss, tieto sú automaticky doplnené 0.
Príklad
 ENTRY IMPORT_OnClick
 INT _rows
 INT _cols
 
 ; zistím si rozmer štruktúry v schránke
 _rows := %HI_Get_Clipboard_Rows()
 _cols := %HI_Get_Clipboard_Cols()
 
 IF _rows=0 | _cols=0 THEN
 ; prázdna schránka
 ELSE
   ; prečítam prvý stĺpec schránky a vložím ho do stĺpca 'Real'
   %HI_From_Clipboard(_recFrom^Real, "")
 
   ; alebo prečítam toľko stĺpcov schránky, koľko ich obsahuje premenná _recFrom
   %HI_From_Clipboard(_recFrom\HBJ, "")
 ENDIF
 END IMPORT_OnClick

Súvisiace stránky:

Funkcie pre ovládanie aktívnej schémy
Lokálne premenné
Argumenty funkcie - typy

Napíšte komentár