defaultvalue – atribut

Atribut [defaultvalue] umožňuje zadat výchozí hodnotu pro zadaný volitelný parametr.

interface interface-name
{
  return-type function-name(
        mandatory-param-list, 
        [[attribute-list,] defaultvalue(value)] param-type param-name
        [ , optional-param-list]);
}

Parametry

název rozhraní

Určuje název rozhraní.

return-type

Určuje návratový typ funkce.

function-name

Určuje název funkce, na kterou se použije atribut [defaultvalue].

mandatory-param-list

Určuje jeden nebo více požadovaných parametrů.

attribute-list

Určuje seznam jednoho nebo více atributů oddělených čárkami, které se vztahují na parametr.

typ parametru

Určuje typ volitelného parametru.

název parametru

Určuje název volitelného parametru.

optional-param-list

Určuje nula nebo více dalších parametrů, z nichž každý musí mít výchozí hodnotu.

Poznámky

Výchozí hodnota, kterou zadáte pro parametr, může být libovolná konstanta nebo výraz, který se přeloží na konstantu, kterou může reprezentovat varianta. Konkrétně nelze použít atribut [defaultvalue] u parametru, který je strukturou, polem nebo typem SAFEARRAY .

Kompilátor MIDL přijímá následující řazení parametrů (zleva doprava):

1. Požadované parametry (parametry, které nemají [defaultvalue] nebo [volitelné] atributy),
2. volitelné parametry s atributem [defaultvalue] nebo bez
3. parametry s [volitelný] atributem a bez atributu [defaultvalue]
4. [lcid] parametr, pokud existuje,
5. [retval] parametr

Příklady

interface IFace : IUnknown
{
    HRESULT Ex1([defaultvalue(44)] LONG i);
    HRESULT Ex2([defaultvalue(44)] SHORT i);
...
};

interface QueryDef : IUnknown
{
    HRESULT OpenRecordset( [in, defaultvalue(DBOPENTABLE)]
    LONG Type,
    [out,retval] Recordset **pprst);
}
//  Type is now known to be a LONG type (good for browser in VBA and
//  good for a C/C++ programmer) and has a default value of
//  DBOPENTABLE

Viz také

dispinterface

generování knihovny typů pomocí MIDL

rozhraní

volitelné

Příklad souboru ODL

syntaxe souboru ODL

retvalovat

TYPEFLAGS