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: