質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

88.10%

リファレンスをどう使ったら良いのかわからないです。

解決済

回答 3

投稿

  • 評価
  • クリップ 0
  • VIEW 1,922

score 78

Android SDK ポケットリファレンスを見ています。

この本に限らずリファレンス全般に言えるのですが、使い方がよくわかりません。

例えば、441ページの「アプリ起動時にソフトキーボードを表示しないようにする」という項目があるのですが、

構文
android.view.Window

void setSoftInputMode(int mode) ソフトキーボードの状態を設定する

引数
mode ソフトキーボードの状態

定数
●mode
android.view.WindowManager.LayoutParams

SOFT_INPUT_STATE_VISIBLE ソフトキーボードを表示状態にする
SOFT_INPUT_STATE_HIDDEN ソフトキーボードを非表示にする

と書かれており、サンプルがこの後に書かれています。

→サンプル
サンプルプロジェクト:keyboard_Hide
ソース:src/MainActivity.java

//アプリ起動時にソフトキーボードを表示する
getWindow().setSoftInputMode(WindowManager.LayoutParams.
SOFT_INPUT_STATE_VISIBLE);

と、ここまできて、幾つか疑問なのですがサンプルコードのgetWidow().は、どこから出てきたのでしょうか?

void setSoftInputMode(int mode)なのに、サンプルだとvoid が無くなっていますがどうしてでしょうか?

getWindow()の後に「.」で繋げているのはなぜでしょうか?

getWindow()の括弧内が空欄にしてあるのは、どこからわかるのでしょうか?

あと、サンプルのsetSoftInputMode()の括弧内WindowManager.LayoutParams.SOFT_INPUT_STATE_VISIBLE
は、本を見る限りだと、定数に書かれていた
android.view.WindowManager.LayoutParams

SOFT_INPUT_STATE_VISIBLE
から来ているとわかるのですが、android.viewが書かれていないのは、なぜでしょうか?

また、括弧内に、SOFT_INPUT_STATE_VISIBLEと書かずに、この頭に、WindowManager.LayoutParamsが付くのは、なぜでしょうか?

というように、リファレンスをみても、何故そうなるのかわからず、サンプルコードと一致していないように見えるのですが、どうやってリファレンスを理解し、コードを書いていけば良いのでしょうか?

また、Android SDKに限らず、JavaのAPIリファレンスを見ても、???になってしまい、使い方やコードの書き方がわかりません。

理解の仕方や覚え方にコツとかあるのでしょうか?

長文になってしまい申し訳ありませんが、詳しく教えてくださると嬉しいです。

よろしくお願い致します。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 過去に投稿した質問と同じ内容の質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

回答 3

+2

単にリファレンスといった場合、対象の機能や仕様などを網羅的に解説した「リファレンスマニュアル」のことを指す場合が多い。
IT用語辞典

英語における単語や用語の辞書のようなものです。
英和辞書でappleを引くと「An apple a day keeps the doctor away. 」の用例が出てきましたが、こいつは諺で、文法に忠実に前から翻訳しても「一日一個のリンゴを食べれば医者はいらない.」とは中々なりませんが、これに対して、「eatが入ってないのになんで食べればって翻訳になるの?」とか「doctor awaytって何?」とか言っても余り意味が無いわけでして。

といったわけで通常リファレンスは学びはじめに先頭から末尾まで順に全部読んでいったりはしないと思います。解らない機能や、細かいオプションを忘れた標準関数などがあったときに、それを調べるような使い方になると思います。またある程度言語に精通してきたときに、ボーっと先頭から読んでると「あーこの関数そんな使い方もあったのか」って感じで理解が深まったりします。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

checkベストアンサー

+1

リファレンスを読むために最低限必要な知識

下記の3点を重点的に学習されたらすっきりすると思います。

  1. 型(プリミティブ型と参照型の違い含む)
  2. クラスとインスタンスの違い
  3. メソッドの引数の型と戻り値の型

説明

MainActivityクラス内でgetWindow()を呼び出していますが、これはActivityクラスが持つメソッドで、リファレンスには下記のように書いてありますね。

// MainActivity(スーパークラスがActivity)のメソッド
public Window getWindow ()


これは、Window型を返す引数なしのpublicなメソッドというという意味です。

getWidow()メソッドはWindow型(クラス)を返すことがわかりました。
ですので、下記のWindowクラスのメソッドを利用することができます。

//android.view.Windowクラスのメソッド
public void setSoftInputMode(int mode) ソフトキーボードの状態を設定する


メソッドの意味は、void型を返す(=つまり何も返さない)引数がint型のpublicメソッドということです。またWindowManager.LayoutParams. 
SOFT_INPUT_STATE_VISIBLEはint型ですので、下記のようにsetSoftInputメソッドの引数として渡すことができます。

getWindow().setSoftInput(WindowManager.LayoutParams. 
SOFT_INPUT_STATE_VISIBLE);

// 下記も同様の処理
int mode = WindowManager.LayoutParams. 
SOFT_INPUT_STATE_VISIBLE;
getWindow().setSoftInput(mode);

// 下記とも同様
int mode = WindowManager.LayoutParams. 
SOFT_INPUT_STATE_VISIBLE;
Window window = getWindow();
widow.setSoftInput(mode);

しかし、これだと冗長なので、通常は一行にまとめます。

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

0

それは出版社に問い合わせる内容で、こういうところで聞く内容でもない気がしますが、

リファレンスはプログラミングの経験がある方を前提として書いてあることが往々にしてあります。つまり、読む人を選ぶということですね。

そのため、まったく触ったことない初心者やソフト作成をしたことがない方は、
これがどういうことなのかの勘所みたいなものがないと思われます。

あと残念なことにその時々の仕様情報でかかれていることもあるので、
手に取った版によっては、情報が古い場合もよくあります。

逆に知っていると、とっかかり(キーワード)をつかみやすいので
そこから発展して調べることや そもそも組み方を知っていれば検証コードで確認するなど
把握がしやすくなります。

もし全くの経験がなく 手に取ってしまったのであれば
まずは入門レベルでよいので、一通りの学習を終えてから1つ何か作成してみてください。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 88.10%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

同じタグがついた質問を見る